Ipgeolocation Io MCP Server
IP address geolocation, threat detection, and timezone data lookup via 16 API-integrated tools.
Data last scanned today · Reviewed today
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
{
"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
| Tool | Description | Risk |
|---|---|---|
| lookup_ip | Location, timezone, currency, ASN for one IP | low |
| get_my_ip | Public IP of the machine running the server | low |
| lookup_currency | Currency and country metadata for one IP | low |
| get_timezone | Timezone by name, location, IP, airport code, or UN/LOCODE | low |
| convert_timezone | Convert time between two locations | low |
| get_astronomy | Sunrise, sunset, moonrise, moonset, twilight, moon phase for one date | low |
| get_astronomy_time_series | Daily astronomy data for a date range (up to 90 days) | low |
| bulk_lookup_ip | Batch geolocation, up to 50,000 IPs | low |
| check_security | VPN, proxy, Tor, bot, spam, and threat flags | low |
| bulk_security_check | Batch threat checks | low |
Compatibility
| Client | Local | Docker | Remote | Read-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
Maintain this server? Add the live badge to your README.