IP2Location Io MCP Server

What is IP2Location Io MCP Server about?

The server returns comprehensive geolocation data—including country, region, city, coordinates, ASN, ISP, proxy details, and more—for any IPv4 or IPv6 address supplied in a request.

How to use IP2Location Io MCP Server?

1. Clone the repository.
2. Install the uv package manager (see the Model Context Protocol quick‑start guide).
3. Configure Claude Desktop (or another MCP client) with a claude_desktop_config.json entry that points to the server script and provides the IP2LOCATION_API_KEY environment variable.
4. Start the server with the uv command as defined in the configuration.
5. In Claude Desktop, ask natural‑language questions about an IP address; the model will invoke the get_geolocation tool and display the returned data.

Key Features

• Full‑stack geolocation data – country, city, ZIP, latitude/longitude, time‑zone, etc.
• Network insights – ASN, ISP, domain, net speed, IDD/area codes.
• Security & proxy detection – proxy type, provider, threat level, fraud score.
• Asynchronous requests – non‑blocking calls to the IP2Location.io API via httpx.
• Simple MCP integration – exposed as the get_geolocation tool with a single ip argument.
• Free tier support – works without an API key (1,000 queries/day) or with a key for up to 50,000 queries/month.

Use Cases

• Enriching chat interactions with real‑time location context for IP addresses.
• Building security dashboards that flag suspicious proxy or fraud activity.
• Enhancing analytics pipelines with geographic and network metadata.
• Powering location‑based services (e.g., content localization, compliance checks).

FAQ

Do I need an API key?

• No. The server can operate without a key but is limited to 1,000 queries per day. Providing a key lifts the limit to 50,000 per month and unlocks additional fields.

Which package manager is required?

• The project uses uv. Install it following the MCP quick‑start guide.

How do I configure the server for Claude Desktop?

• Add an entry to claude_desktop_config.json under mcpServers as shown in the README, specifying the command, args, and the IP2LOCATION_API_KEY environment variable.

What request format does the tool accept?

• The get_geolocation tool takes a single string argument ip representing the IPv4 or IPv6 address.

What happens on invalid input?

• The tool returns an error string describing the problem (e.g., invalid IP format or API failure).

IP2Location.io MCP server

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.

Features

• 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 a FastMCP tool, allowing for easy integration into compatible systems.
• Asynchronous: Utilizes httpx for non-blocking asynchronous API requests.

Requirement

This MCP server supports to query without an API key, with a limitation of 1,000 queries per day. You can also sign up for a free API key and enjoy up to 50,000 queries per month.

The setup also use uv, which can be install by following the guide.

Setup

Follow the steps to use this MCP server with Claude Desktop:

1. Download the repository to your local.
2. Setup the uv package manager, you can once again refer to the guide to do so.
3. Make sure you have installed the Claude Desktop, if you haven't, kindly download from here for Windows and MacOS users, or follow this guide for Linux user.
4. Open the claude_desktop_config.json in your choice of editor, if you do not having one yet, follow this guide to create one.
5. Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. Remember to replace the /path/to/ip2locationio path with your actual path to IP2Location.io MCP server in local.
7. To get your API key, just login to your dashboard and get it from there. Replaced the <YOUR API key HERE> in above with your actual API key.
8. Restart the Claude Desktop after save the changes, and you should see it appear in the Search and tools menu.

Usage

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.

Environment Variable

IP2LOCATION_API_KEY

The IP2Location.io API key, which allows you to query up to 50,000 per month and more details of the IP address. You can sign up for a free API key, or subscribe to a plan to enjoy more benefits.

Tool

get_geolocation

Description Fetch geolocation for the given IP address. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address.

Arguments ip (str): The IP address (IPv4 or IPv6) to analyze.

Returns A JSON string containing the geolocation 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 the request fails or the IP address is invalid, the tool will return an error message as a string.

License

See the LICENSE file.