Bring IP intelligence into your AI workflow

Let your AI assistant look up IP geolocation, ISP, ASN, proxy signals, and more through the IP2Location.io MCP Server. Connect to our hosted endpoint or run the open-source server locally.

Connect MCP server   View on GitHub  
AI ASSISTANT · IP2LOCATION.IO MCP 
YOU: Where is 8.8.8.8 located?

MCP TOOL: get_geolocation
{
	"ip": "8.8.8.8",
	"country_code": "US",
	"asn": "AS15169"
}

ASSISTANT: United States · Google network.
Hosted endpoint Direct HTTP or npx bridge
IP geolocation IPv4 & IPv6
Network & security ISP, ASN & proxy data
Open Source GitHub project
CAPABILITIES

Make your AI tools IP-aware.

Explore the capabilities available through this IP2Location.io developer integration.

IP geolocation

Retrieve country, region, city, coordinates, postal code and time zone when available.

ISP & ASN intelligence

Investigate network ownership, service providers, Autonomous Systems and connection attributes.

Proxy & security signals

Explore proxy, VPN, Tor, data center and threat fields supported by your API plan.

Multiple IP lookup

Ask about several IP addresses in one prompt; supported plans can use the Bulk API.

Hosted or local MCP

Connect to the managed HTTP endpoint or run the open-source server with uvx.

Developer workflows

Use IP intelligence in compatible AI clients and Python agent frameworks.

HOW IT WORKS

From request to IP intelligence.

A clear view of the steps involved, from your preferred developer tool to the returned result.

💬
1. AI client You ask an IP-related question
⚙
2. MCP server The assistant invokes an available tool
🌐
3. IP2Location.io API returns IP information
✓
4. Answer Assistant summarizes the response
INSTALL & CONFIGURE

Connect in the way that works for you.

Choose cloud-hosted HTTP, an npx bridge for stdio-only clients, or a local server. All examples use your own IP2Location.io API key.

Hosted MCP via streamable HTTP

For clients that support remote HTTP MCP servers. Add the URL and API key using the client's native remote-server settings; JSON configuration format differs by client.

Setup instructions

  1. Open your MCP client’s remote-server settings.
  2. Enter https://mcp.ip2location.io/ as the server URL.
  3. Set the X-API-Key request header to your API key.
  4. Save your settings, connect the server, and enable its tools. 
{
	"mcpServers": {
		"ip2location": {
			"type": "http",
			"url": "https://mcp.ip2location.io/",
			"headers": {
				"X-API-Key": "YOUR_API_KEY"
			}
		}
	}
}

Keep your API key private and check the connection in your client after saving.

Claude Desktop via npx bridge

Add this configuration to claude_desktop_config.json, replace YOUR_API_KEY, and restart Claude Desktop. Node.js and npx are required.

Setup instructions

  1. Open your Claude Desktop configuration file (claude_desktop_config.json).
  2. Add the ip2location MCP entry below inside mcpServers, merging with any existing entries.
  3. Replace YOUR_API_KEY with your real API key.
  4. Save the file and restart Claude Desktop. 
{
	"mcpServers": {
		"ip2location": {
			"command": "npx",
			"args": [
				"-y",
				"mcp-remote@latest",
				"https://mcp.ip2location.io/",
				"--header",
				"X-API-Key:YOUR_API_KEY"
			]
		}
	}
}

This method connects Claude Desktop to the hosted IP2Location.io MCP server through an npx bridge.

Run the MCP server locally

Install uv / uvx, supply your IP2Location.io API key, and restart your MCP client. Python 3.13+ is required by the repository.

Setup instructions

  1. Install uv so the uvx command is available to your MCP client.
  2. Open your client’s MCP server configuration.
  3. Add the local server command below and set IP2LOCATION_API_KEY.
  4. Save the configuration and restart or reload your MCP client. 
{
	"mcpServers": {
		"ip2locationio": {
			"command": "uvx",
			"args": [
				"mcp-ip2location-io"
			],
			"env": {
				"IP2LOCATION_API_KEY": "YOUR_API_KEY"
			}
		}
	}
}

The local server runs through uvx and uses the IP2LOCATION_API_KEY environment variable.

Claude Code CLI — hosted HTTP

Run the following command in your terminal with Claude Code installed. Replace YOUR_API_KEY before executing.

Setup instructions

  1. Open a terminal where the claude command is available.
  2. Replace YOUR_API_KEY in the command below.
  3. Run the registration command.
  4. Check the MCP server registration in Claude Code. 
claude mcp add --transport http ip2location https://mcp.ip2location.io/ --header "X-API-Key: YOUR_API_KEY"

This command registers the hosted IP2Location.io MCP server in Claude Code.

VS Code HTTP MCP configuration

Add this configuration to your supported VS Code MCP settings. Verify your VS Code version and supported secret handling.

Setup instructions

  1. Open your workspace MCP configuration at .vscode/mcp.json, or use the supported user-level MCP settings.
  2. Add the server entry below, merging it into any existing servers object.
  3. Replace YOUR_API_KEY and save the configuration.
  4. Start or refresh the MCP server from VS Code and enable its tools. 
{
	"servers": {
		"ip2location": {
			"type": "http",
			"url": "https://mcp.ip2location.io/",
			"headers": {
				"X-API-Key": "YOUR_API_KEY"
			}
		}
	}
}

Use the remote HTTP MCP transport supported by your VS Code installation.

Generic stdio bridge

This configuration is intended for MCP clients supporting local stdio servers. Verify the configuration path and client-specific settings.

Setup instructions

  1. Open your editor’s MCP settings and locate the local stdio server configuration.
  2. Add the npx bridge configuration below in the format your client supports.
  3. Replace YOUR_API_KEY with your API key.
  4. Reload the MCP servers or restart your editor. 
{
	"mcpServers": {
		"ip2location": {
			"command": "npx",
			"args": [
				"-y",
				"mcp-remote@latest",
				"https://mcp.ip2location.io/",
				"--header",
				"X-API-Key:YOUR_API_KEY"
			]
		}
	}
}

The npx bridge connects the client to the hosted IP2Location.io MCP endpoint.

QUICK START

Get connected in three steps.

Use the cloud-hosted endpoint for the simplest supported setup; no local Python environment required with native HTTP clients.

STEP 1

Create an API key

Sign up for a free IP2Location.io account and retrieve your API key.

Sign up for a free

STEP 2

Choose your connection

Use direct HTTP for compatible clients or npx for clients that need a local stdio bridge.

Hosted endpoint 
https://mcp.ip2location.io/
STEP 3

Ask your first question

Enable the MCP server in your client and try a natural-language prompt.

Example prompt 
Where is 8.8.8.8 located?
MCP TOOL REFERENCE

One tool for single or multiple IPs.

The server exposes get_geolocation , which accepts one IP address or several addresses in a single string.

Category Tool / capability Description
Tool get_geolocation Fetch geolocation and network data for one or multiple IPv4/IPv6 addresses.
Required argument ip (string) Single IP or several IPs separated by commas, spaces or new lines.
Example 8.8.8.8 Single-IP lookup.
Example 1.1.1.1, 8.8.8.8 Multiple-IP lookup; Bulk API access requires an eligible paid plan.
Location Geolocation fields Country, region, district, city, ZIP/postal code, coordinates and time zone.
Network ISP & ASN fields ISP, ASN, AS name and other network attributes where available.
Security Proxy & threat fields Plan-dependent proxy, VPN, Tor, data center and risk intelligence.
Output JSON string Single-IP data or an object keyed by IP address for multiple-IP results.
PRACTICAL EXAMPLES

Use it in your workflow.

Copy these examples into your terminal or connected AI assistant.

Find an IP’s location

Ask for geographic context.

Example prompt 
Where is 8.8.8.8 located? Include country and city.

Investigate ownership

Get network context.

Example prompt 
Find the ISP and ASN associated with 1.1.1.1.

Look up IPv6

Query an IPv6 address.

Example prompt 
Look up 2001:4860:4860::8888.

Ask about proxies

Use plan-dependent security fields.

Example prompt 
What proxy information is available for 8.8.8.8?
TROUBLESHOOTING

Fix common setup issues.

A few quick checks before you dig into GitHub issues.

Server not visible

Verify the client configuration and restart the application.

Connection fails

Verify the endpoint, HTTPS access and HTTP transport support. For npx, check Node.js and the bridge command.

Authentication or missing data

Check your API key and the data included in your plan.

DEVELOPER ECOSYSTEM

Open source and framework integrations.

Bring the MCP server into your preferred AI workflow and Python agent stack.

⌘

Original Claude Desktop setup

Download the server source, install uv, add the local launch configuration in claude_desktop_config.json , and restart Claude Desktop.

Local command 
uv --directory /path/to/ip2locationio/src run server.py

View source on GitHub ↗

◇

Integration listings

View the open-source MCP project and browse community server directories. These are listings, not a claim of native or managed hosting.

mcp.so ↗

glama.ai ↗

GitHub ↗

smithery.ai ↗

FAQ

Frequently asked questions.

Answers to common questions about this integration.

What is the Model Context Protocol (MCP)?

MCP is a protocol that allows compatible AI clients to discover and invoke tools from connected servers. The IP2Location.io MCP server exposes IP intelligence through a tool named get_geolocation .

Can I connect without installing the server locally?

Yes. Compatible clients can connect to https://mcp.ip2location.io/ over streamable HTTP. For stdio-only clients, use the mcp-remote bridge through npx.

Do I need an IP2Location.io API key?

An API key is recommended and required by the hosted setup examples. The underlying REST API supports limited keyless access, but the documented MCP setup uses an API key.

Does the MCP server support IPv6 and bulk IP lookup?

Yes. The ip argument supports IPv4 and IPv6, including multiple addresses separated by commas, spaces or new lines. Bulk IP API access requires an eligible paid plan.

Can I use it with Claude Desktop, VS Code, Cursor or Windsurf?

You can use the server with MCP-compatible clients, subject to each client’s supported transport and configuration format. Choose direct HTTP where supported or an npx bridge/local stdio configuration otherwise.

Why are some attributes missing?

Available attributes depend on your subscription plan and the information available for each address. Advanced proxy, threat and mobile data are not guaranteed on every lookup.

Is IP geolocation the same as GPS?

No. IP geolocation estimates the geographic association of an IP address; it does not provide the precise physical location of a person or device.

LEARN MORE

Documentation & resources.

Continue with official source code, setup instructions and developer documentation.

GitHub repository Source code, latest setup and tool reference API documentation IP data fields, responses and integration details Plans & pricing Compare API allowances and available intelligence
READY TO BUILD?

Make your AI assistant IP-aware.

Connect directly to the hosted MCP server or run it locally.

Get free API key   View setup