Official MCP server for IP geolocation, IP security, abuse contacts, ASN, timezone, astronomy, and user-agent parsing.
Official MCP server for IP geolocation, IP security, abuse contacts, ASN, timezone, astronomy, and user-agent parsing. That is what the ipgeolocation io mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
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 50,000 items per call; default 1,000, configurable via IPGEOLOCATION_MCP_MAX_BULK_ITEMS).
The server publishes 14 tools. What each one is for:
Requirements — get_my_ip works without an API key. Everything else requires oneCline — Open MCP Servers panel > Configure > Advanced MCP Settings. Add to cline_mcp_settings.json:Cursor — The Cursor tool exposed by this serverWindsurf — The Windsurf tool exposed by this serverGlama — You can try the server on Glama directly. Only IPGEOLOCATION_API_KEY is requiredlookup_ip — Use this when you need location, timezone, currency, or ASN for one IP address. On paid plans you can add include modules to pull security, abuse, orbulk_lookup_ip — Takes an array of IPs or domains (up to 1,000 by default, configurable with IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Supports the same include, fields, andget_my_ip — Returns the public IP of the machine running the server. Free. 0 credits. No API key needed.check_security — Returns threat score, VPN/proxy/Tor flags, provider names, confidence scores, bot/spam indicators, anonymity flags, and cloud-provider statusbulk_security_check — Batch version of check_security. Paid. 2 credits per IP.get_timezone — Current time and timezone details for a location. Free and paid. 1 credit.convert_timezone — Converts a time between two locations. Free and paid. 1 credit.Configuration is passed through the environment: IPGEOLOCATION_API_KEY, YOUR_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
npx available 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 keyipgeolocation-io-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Ipgeolocation Io MCP's toolset — Requirements, Cline, Cursor and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ipgeolocation; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| Requirements | get_my_ip works without an API key. Everything else requires one. |
| Cline | Open MCP Servers panel > **Configure** > **Advanced MCP Settings**. Add to cline_mcp_settings.json: |
| Cursor | The Cursor tool exposed by this server. |
| Windsurf | The Windsurf tool exposed by this server. |
| Glama | You can try the server on [Glama](https://glama.ai/mcp/servers/IPGeolocation/ipgeolocation-io-mcp) directly. Only IPGEOLOCATION_API_KEY is required. Leave other environment variable fields empty unless you want to change |
| lookup_ip | Use this when you need location, timezone, currency, or ASN for one IP address. On paid plans you can add include modules to pull security, abuse, or hostname data in the same call, which avoids extra requests. |
| bulk_lookup_ip | Takes an array of IPs or domains (up to 1,000 by default, configurable with IPGEOLOCATION_MCP_MAX_BULK_ITEMS). Supports the same include, fields, and excludes options as lookup_ip. |
| get_my_ip | Returns the public IP of the machine running the server. **Free. 0 credits. No API key needed.** |
| check_security | Returns threat score, VPN/proxy/Tor flags, provider names, confidence scores, bot/spam indicators, anonymity flags, and cloud-provider status. |
| bulk_security_check | Batch version of check_security. **Paid. 2 credits per IP.** |
| get_timezone | Current time and timezone details for a location. **Free and paid. 1 credit.** |
| convert_timezone | Converts a time between two locations. **Free and paid. 1 credit.** |
| get_astronomy | Sun and moon data for one location on one date. **Free and paid. 1 credit.** |
| get_astronomy_time_series | Astronomy data for a date range, up to 90 days. **Free and paid. 1 credit per request.** |
{
"mcpServers": {
"ipgeolocation": {
"command": "npx",
"args": ["-y", "ipgeolocation-io-mcp"],
"env": {
"IPGEOLOCATION_API_KEY": "<YOUR_API_KEY>"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
npx available 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| Variable | Description | Required |
|---|---|---|
| IPGEOLOCATION_API_KEY | Credential the server authenticates with. | Yes |
| YOUR_API_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.