Official MCP server for ipgeolocation.io APIs.
IPGeolocation.io MCP Server
Official MCP server for IPGeolocation.io. Includes 16 MCP tools: IP geolocation, threat/VPN/proxy detection, timezone lookups and conversions, sunrise/sunset/moon data, ASN details, abuse contacts, and user-agent parsing. Seven tools work on the free plan (1,000 credits/day). Paid plans unlock all 16 plus bulk endpoints (up to 1,000 items per call).
Works with Claude Desktop, Cursor, Windsurf, VS Code, Codex, Cline, Glama, and any other MCP client.
| Item | Value |
|---|---|
| Package | ipgeolocation-io-mcp |
| Version | 1.0.11 |
| Transport | stdio |
| Node.js | >=18 |
Quick Start
Add this to your MCP client config (see Install by Client below for the exact config file path for your client):
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Restart your client.
Test it: ask "Where is 8.8.8.8 located?"
Install by Client
Requirements
- Node.js 18 or later
npxavailable in your terminal- An IPGeolocation.io API key for most tools
get_my_ip works without an API key. Everything else requires one.
Sign up for a free IPGeolocation API key
Codex CLI
codex mcp add ipgeolocation --env IPGEOLOCATION_API_KEY=<YOUR_API_KEY> -- npx -y ipgeolocation-io-mcp
codex mcp list
Start a new Codex session after adding the server.
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Restart Claude Desktop after saving. We also ship manifest.json for clients that support MCP Bundles.
Cline
Open MCP Servers panel > Configure > Advanced MCP Settings. Add to cline_mcp_settings.json:
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Restart Cline after saving.
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Restart Cursor after saving.
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
Restart Windsurf after saving.
VS Code / GitHub Copilot
Add to your VS Code settings.json:
{
"mcp": {
"servers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
}
Restart VS Code after saving.
Glama
You can try the server on [Glama](https://glama.ai/mcp/servers/IPGe
Tools (4)
get_my_ipRetrieves the public IP address of the current machine.get_geolocationRetrieves geolocation data for a specific IP address.get_timezoneRetrieves timezone information for a specific IP address or location.get_user_agent_infoParses and retrieves information from a user-agent string.Environment Variables
IPGEOLOCATION_API_KEYrequiredAPI key from IPGeolocation.io required for most tools.Configuration
{"mcpServers": {"ipgeolocation": {"command": "npx", "args": ["-y", "ipgeolocation-io-mcp"], "env": {"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"}}}}