IPGeolocation.io MCP Server

The official IPGeolocation.io MCP server provides 17 tools for accurate IP geolocation, company information, ASN and network data, IP security (VPN, proxy, Tor, bot, hosting and spam detection), abuse contacts, time zones, astronomy, currency data and user-agent parsing.

MCP (Model Context Protocol) connects your client to these tools. Your client or host must support launching a local command over stdio. See Install by Client for configuration examples.

Published version: 2.0.3.

The install commands follow npm's latest tag, including future major releases. Restart the server to load an update. Source and Docker installations need a rebuild.

Quick Start

1. Create a free IPGeolocation.io API key.
2. Merge this entry into your client's private configuration, keeping any existing servers. See Install by Client for the configuration location. Cursor also has a one-click installer.

{
  "mcpServers": {
    "ipgeolocation": {
      "command": "npx",
      "args": ["-y", "ipgeolocation-io-mcp@latest"],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

3. Reload the server or restart your client.
4. Ask "Where is 8.8.8.8 located?"

Table of Contents

• Quick Start
• Install by Client
• Verify It Works
• Tools by Plan
• Tool Reference
• Prompt Examples
• Example Answers and Tool Output
• Error Codes
• How It Works
• Caching
• Cached Result Pagination
• Environment Variables
• Building from Source
• Docker
• Testing
• Troubleshooting
• Pricing
• Links
• License
• Privacy Policy

Install by Client

Requirements

• Node.js 22 or later for npm/source installs, or a bundle host with a compatible Node.js runtime
• npx available for the npm configuration examples
• An IPGeolocation.io API key for most API tools

Use a supported Node.js release with its latest security updates.

get_my_ip requires no API key. The other 15 API tools require one. get_cached_result reads results already held in memory; use the same AP

... View full README on GitHub