Verified

Ipgeolocation Io MCP Server

IP address geolocation, threat detection, and timezone data lookup via 16 API-integrated tools.

Data last scanned today · Reviewed today

4816 tools4JavaScriptMIT

Overview

This server provides direct access to 16 distinct tools from IPGeolocation.io, enabling your AI to fetch granular location, timezone, and security data. Capabilities range from standard IP geolocation and ASN details to complex tasks like user-agent parsing, threat and proxy detection, and solar positioning data. The server operates via stdio and requires a valid API key from IPGeolocation.io. While seven tools are available on the provider's free plan, the remaining features and bulk processing endpoints require a paid subscription. Configuration is straightforward for standard MCP clients using the provided environment variable for authentication.

Our verdict

With a security score of 43/100, this server carries a high risk level. The score reflects that the project is not maintained by the official vendor and has not yet undergone editorial review, meaning the implementation of security practices is community-driven rather than verified. Users should exercise caution and only integrate this server if they are comfortable with community-supported code and have reviewed the authentication flow.

  • Includes 16 specific tools for geolocation and threat intelligence
  • Contains only two direct dependencies for lower supply-chain risk
  • Supports configurable bulk endpoint item counts via environment variables
  • Released under the permissive MIT license
  • Lacks official vendor maintenance and editorial security verification
  • Authentication method and read-only status have not been reviewed

Setup

Claude Desktop
{
  "mcpServers": {
    "ipgeolocation-io-mcp": {
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

  • No read-only mode — running this grants full read/write access.
  • No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

ToolDescriptionRisk
lookup_ipLocation, timezone, currency, ASN for one IPlow
get_my_ipPublic IP of the machine running the serverlow
lookup_currencyCurrency and country metadata for one IPlow
get_timezoneTimezone by name, location, IP, airport code, or UN/LOCODElow
convert_timezoneConvert time between two locationslow
get_astronomySunrise, sunset, moonrise, moonset, twilight, moon phase for one datelow
get_astronomy_time_seriesDaily astronomy data for a date range (up to 90 days)low
bulk_lookup_ipBatch geolocation, up to 50,000 IPslow
check_securityVPN, proxy, Tor, bot, spam, and threat flagslow
bulk_security_checkBatch threat checkslow

Compatibility

ClientLocalDockerRemoteRead-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

Do I need an API key for every tool provided by this server?

No, the get_my_ip tool works without an API key, but all other 15 tools require an active IPGeolocation.io API key.

What are the system requirements to run this MCP server?

You must have Node.js version 22 or later and the npx utility installed on your machine.

How many tools are available on the free plan?

The free plan provides access to seven of the 16 available tools and includes a limit of 1,000 credits per day.

Can I increase the default limit for bulk endpoint items?

Yes, you can configure the maximum number of items per call by setting the IPGEOLOCATION_MCP_MAX_BULK_ITEMS environment variable, up to a maximum of 50,000.

Alternatives

Changelog

Badge

Ipgeolocation Io MCP Server security score, rated on RepoAI

Maintain this server? Add the live badge to your README.