IP2Location.io
About
IP2Location.io API integration to retrieve the geolocation information for an IP address.
Details
- Author
- ip2location
- Downloads
- 345
- Categories
- Developer Tools, Search, Other, API, Security
Jump to
- Seamless AI integration—fetch IP data via natural language prompts.
- Detailed geolocation data including city, ISP, and proxy info.
- Up to 1,000 queries per day without an API key.
- Free account unlocks up to 50,000 queries per month.
- No manual lookup required; AI agents automate data retrieval.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
IP2Location.ioCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the server configuration to your claude_desktop_config.json using the uv command and the optional IP2LOCATION_API_KEY environment variable. After restarting Claude Desktop, the server appears in the Search and tools menu. You can start querying without an API key (1,000 queries per day) or sign up for a free key (50,000 queries per month).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ip2location.io": {
"ip2location": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.ip2location.io/",
"--header",
"X-API-Key:YOUR_API_KEY"
]
}
}
}
}
McpServers
{
"ip2location": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.ip2location.io/",
"--header",
"X-API-Key:YOUR_API_KEY"
]
}
}
What can you do with IP2Location Io MCP?
- Look up IP geolocation— Ask for country, city, coordinates, time zone, ZIP code, and ISP for any IPv4 or IPv6 address usingget_geolocation.
- Query multiple IPs at once— Pass several IP addresses separated by commas or spaces to retrieve geolocation data for all of them in a single request.
- Check network and proxy details— Get ASN, domain, net speed, proxy type, and proxy provider information tied to an IP address.
- Retrieve mobile carrier data— Obtain MNC, MCC, and mobile brand when available for an IP.
This is a simple Model Context Protocol (MCP) server implementation for IP2Location.io API. It will return a detailed geolocation information for any given IPv4 or IPv6 address.
- Comprehensive Geolocation Data: Retrieves a wide range of information, including country, region, city, latitude, longitude, ZIP code, time zone, and more.
- Network Details: Provides network-related data such as ASN, ISP, domain, and network speed.
- Security Insights: Detects proxy information, including proxy type and provider.
- Simple Integration: Built as aFastMCPtool, allowing for easy integration into compatible systems.
- Asynchronous: Utilizeshttpxfor non-blocking asynchronous API requests.
This MCP server supports queries without an API key, with a limitation of 1,000 queries per day. You can alsosign upfor a free API key and enjoy up to 50,000 queries per month.
If you use the cloud-hosted MCP server, you only need Claude Desktop andnpx, because the server is hosted remotely. If you want to run the original MCP server locally, the local setup usesuv, which can be installed by followingthe guide.
You can use this MCP server in Claude Desktop in either of the following ways:
- Cloud-hosted MCP server: Recommended if you want to connect directly to the hosted IP2Location.io MCP server.
- Local MCP server: Use this if you want to download and run the original MCP server on your own machine.
Follow the steps below to use the cloud-hosted IP2Location.io MCP server with Claude Desktop:
- Make sure you have installed Claude Desktop. If you have not installed it yet, download it fromherefor Windows and macOS, or followthis guidefor Linux users.
- Open theclaude_desktop_config.jsonfile in your choice of editor. If you do not have one yet, followthis guideto create one.
- Add the following to yourclaude_desktop_config.json:
{ "mcpServers": { "ip2location": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://mcp.ip2location.io/", "--header", "X-API-Key:YOUR_API_KEY" ] } } }
- ReplaceYOUR_API_KEYwith your actual IP2Location.io API key. To get your API key,log into your dashboard.
- Restart Claude Desktop after saving the changes, and you should see the MCP server appear in theConnectorsmenu.
Follow the steps below if you want to run the original MCP server locally with Claude Desktop:
- Set up theuvpackage manager. You can refer tothe guideto do so.
- Make sure you have installed Claude Desktop. If you have not installed it yet, download it fromherefor Windows and macOS, or followthis guidefor Linux users.
- Open theclaude_desktop_config.jsonfile in your choice of editor. If you do not have one yet, followthis guideto create one.
- Add the following to yourclaude_desktop_config.json:
{ "mcpServers": { "ip2locationio": { "command": "uvx", "args": [ "mcp-ip2location-io" ], "env": { "IP2LOCATION_API_KEY": "<YOUR API key HERE>" } } } }
Just enter your query about the IP in a chat in Claude Desktop. Some of the example query will be:
- Where is the location of (IP)?
- Where is (IP) located?
- What is the coordinate of (IP)?
For instance, below is the result of the IP 8.8.8.8:
In Claude Desktop, the model will automatically generate the output based on the result returned by IP2Location.io MCP server.
You can also utilize IP2Location.io Bulk IP Geolocation API to query for multiple IP addresses. Just input all IP addresses with the space in between of each IP address. For example8.8.8.8 8.8.6.6.
[!NOTE]
IP2Location.io Bulk IP Geolocation API requires a paid plan to work.
DescriptionFetch geolocation for the given IP address or a batch of IP addresses. It helps users retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address. It automatically routes requests to the IP2Location.io Bulk API for efficient processing when multiple IPs are detected.
- ip(str): The IP address (IPv4 or IPv6) to analyze. You can query multiple IPs at once by passing them as a single string separated by commas, spaces, or newlines (e.g.,"1.1.1.1, 2.2.2.2").
ReturnsA JSON string containing the geolocation data. If multiple IPs are queried, it returns a JSON object where each key is an IP address mapped to its respective data. The result may include the following fields, depending on your API plan:
- Location & Geography:Country, region, district, city, ZIP code, latitude & longitude, time zone.
- Network & Connectivity:ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type.
- Mobile Information:MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand.
- Currency & Language:currency code, currency name, currency symbol, language code, language name.
- Proxy & Security:proxy type, last seen, threat level/type, proxy provider, fraud score.
- Others:IAB category, weather, elevation, population, and more.
If a single IP request fails or the IP is invalid, the tool returns an error message as a string. For bulk requests, any individual failed IPs will return an error object mapped to that specific IP address without failing the entire batch.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
GeoIP and ASN intelligence for AI agents with country, city, timezone, network ownership and ASN lookups.
Free business data API and MCP server. Find restaurants, cafes, hotels, shops and 37+ business categories in any city worldwide. Uses OpenStreetMap data. No API key required. REST API + MCP Streamable HTTP endpoint.
Provides access to MarineTraffic vessel tracking data.
Real-time transit, maritime, and aviation telemetry for AI agents.
Public HTAG MCP connectors for Australian property intelligence, H3 spatial intelligence, and capability discovery — 70+ read-only tools over Streamable HTTP.
Global postal code lookups, validation, and city search for 70+ countries. Sub-10ms responses.
Geographic data, live exchange rates, and IP geolocation for Claude Desktop, Cursor, and any MCP-compatible AI assistant.
Performs data enrichment on observables using third-party services via the security-cli Python package.
Open MCP server providing real-time transit routing, open-source GIS / geographic intelligence, and specialized Slovenian geospatial lookup tools for AI agents and LLMs.
Retrieves user geolocation information using EdgeOne Pages Functions and integrates it with large language models via MCP.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




