ip-geolocation-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ip-geolocation-mcpWhere is 8.8.8.8 located?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IP Geolocation MCP Server
An MCP (Model Context Protocol) server that provides IP geolocation data using ipinfo.io (free tier — no API key required, 50,000 lookups/month).
Tools
ip_lookup(ip)
Look up geolocation data for a specific IP address.
Parameters:
Name | Type | Required | Description |
| string | yes | IPv4 or IPv6 address (e.g. |
Returns: city, region, country, org (ISP), timezone, postal code, latitude, longitude.
ip_lookup_own()
Get geolocation data for your own public IP address. No arguments needed.
ip_batch(ips)
Batch lookup up to 10 IP addresses at once.
Parameters:
Name | Type | Required | Description |
| string[] | yes | Array of IPs (max 10) |
Returns: Array of geolocation objects, one per IP.
Related MCP server: GeoIP MCP Server
Usage
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ip-geolocation": {
"command": "python",
"args": ["path/to/server.py"],
"env": {}
}
}
}Or via uv (recommended for dependency management):
{
"mcpServers": {
"ip-geolocation": {
"command": "uv",
"args": [
"--directory", "path/to/ip-geolocation-mcp",
"run", "server.py"
]
}
}
}Any MCP Client
pip install -r requirements.txt
python server.pyPricing
Tier | Price | Lookups/month |
Free | $0 | 50,000 |
Pro | $19/month | Unlimited |
Deployment
Smithery
This server is compatible with Smithery.ai. See smithery.yaml for configuration.
Data Fields
Each lookup returns:
Field | Description | Example |
| Queried IP address |
|
| City name |
|
| Region/state |
|
| 2-letter ISO country code |
|
| ISP/Organization |
|
| IANA timezone |
|
| Postal/ZIP code |
|
| Latitude |
|
| Longitude |
|
| Raw "lat,lon" string |
|
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
IPInfo MCP — wraps ipinfo.io (free tier, no auth required for basic usage)
Official IPinfo MCP Server - IP intelligence tools for AI assistants
MCP server for IPv4 geolocation with Chinese output: country/region/city, ISP and ASN.
Related MCP Servers
- AlicenseAqualityCmaintenanceIP Geolocation MCP server using IP2Location.io API to ease the query of geolocation information.115PythonMIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server that provides IP geolocation services using MaxMind's GeoIP2 databases, allowing users to retrieve geographical information for single or multiple IP addresses including country, city, coordinates, and ASN details.GPL 3.0
- AlicenseBqualityDmaintenanceAn MCP server that provides access to the Netdetective API for querying information about IP addresses. It enables users to retrieve metadata for a specified IP address or the connecting client's default IP address.1MIT
- AlicenseAqualityAmaintenanceOfficial MCP server for ipgeolocation.io APIs. IP geolocation, VPN/proxy detection, timezone, astronomy, user-agent parsing, ASN, company, and IP abuse contact tools for AI assistants.16111 npm4MIT