IPGeolocation/ipgeolocation-io-mcp

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.
This README describes 2.0.1. The npx commands and Cursor install link below follow npm's latest tag, including future major releases. Restart the server to load an update; npm reuses cached package files when the selected version is unchanged. See the changelog for release details.
| Item | Value |
| Package | ipgeolocation-io-mcp |
| Version | 2.0.1 |
| Release date | 2026-10-11 |
| Transport | stdio |
| Node.js | >=22 |
## Quick Start
1. Create a free IPGeolocation 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.
json
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp@latest"],
"env": {
"IPGEOLOCATIONAPIKEY": " "
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.
getmyip requires no API key. The other 15 API tools require one. getcachedresult reads results already held in memory; use the same API key as the original lookup.
Sign up for a free IPGeolocation API key
Use a private user configuration or your client's secret/environment settings for the real key. Keep keys out of committed project configuration. Each client below uses the Quick Start server entry unless its format differs.
### Codex CLI
Set IPGEOLOCATIONAPIKEY in your private shell environment before running these commands. The variable reference keeps the key value out of the command you type and its shell history.
bash
codex mcp add ipgeolocation --env "IPGEOLOCATIONAPIKEY=$IPGEOLOCATIONAPIKEY" -- npx -y ipgeolocation-io-mcp@latest
codex mcp list
Start a new Codex session after adding the server.
### Claude Desktop
Install the published server from its Claude Marketplace listing. In Claude Desktop, open Settings > Extensions > Browse extensions, find IPGeolocation.io MCP Server, and configure your API key during installation. See Anthropic's desktop extension guide. The directory distributes the approved published bundle; its refresh can lag GitHub Releases. Check the installed version, or download the versioned bundle below.