Name: IP2Location.io MCP Server
Author: ip2location

LABSCO SUMMARY

A list of addresses costs one round trip instead of one per line.

The entire surface is get_geolocation, and most of its description is spent instructing the model to batch addresses into a single comma-separated string. That instruction is the interesting part: the common failure with a geolocation tool is an agent calling it once per row of a log, and this one is written to stop that. Nothing here reaches your own systems — an address goes out, location detail comes back.

What it is

A single-tool front end for the hosted IP2Location.io geolocation lookup.

What you get

get_geolocation, which returns detail such as country, region and city for an IP address.
Batched lookups: the tool takes several addresses as one comma-separated string, and its description tells the model to make exactly one call rather than looping.

Requirements

An IP2Location.io API key. The server is the hosted endpoint at mcp.ip2location.io, reached with that key as a request header.

Setup effort

Paste a URL — add the endpoint to your client

See installation options

USE CASES

01

Placing every address that turned up in an access log

Hand over the addresses as one comma-separated string and get country, region and city detail back for all of them in a single call rather than one call per line.

get_geolocation

1 tool

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`get_geolocation`

Fetch geolocation for the given IP address(es).

CRITICAL INSTRUCTION FOR AI AGENT: If the user provides multiple IP addresses in their prompt, DO NOT call this tool multiple times sequentially. You MUST batch all IP addresses together into a single comma-separated string and make exactly ONE tool call.

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.

Args: ip: The IP address to analyze (IPv4 or IPv6). For multiple IPs, you MUST combine them into a single string separated by commas (e.g., "1.1.1.1, 2.2.2.2").

Returns: A JSON string result includes:

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.

Note that some information may only available in paid plan. Learn more on this in https://www.ip2location.io/pricing.

BEFORE YOU INSTALL

What to know first

Tools you get

1 tool when we connected. Several addresses can go in one call, separated by commas, spaces or newlines. Without a key the limit is 1,000 queries a day, a free key gives 50,000 a month, and the Bulk API needs a paid plan.

Requires

npx on PATH

Where it runs

Of the 2 documented setups, 1 runs the server on your machine and 1 connects to a hosted endpoint.

CONTEXT COST

Light Standing cost

Rated by the size of the one tool definition that rides along on every turn

INSTALLATION

Connect your client

Add the endpoint to your client.

Server setup

ENDPOINT URL

https://mcp.ip2location.io/

MCP Clients

Claude Desktop — remote

CLAUDE DESKTOP — REMOTE · JSON

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:<YOUR_API_KEY>"
      ]
    }
  }
}

Claude Desktop — local

CLAUDE DESKTOP — LOCAL · JSON

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR_IP2LOCATION_API_KEY>"
      }
    }
  }
}

IP2Location.io MCP Server