ipregistry

MCP Server

IP intelligence tools for LLMs and AI agents

Connect — Streamable HTTP

https://mcp.ipregistry.co/mcp

Authentication supports the same options as the Ipregistry API: an Authorization: ApiKey header or a ?key= query parameter.

Get a free API key →

Client setup

Every caller authenticates with their own Ipregistry API key — create one for free, trial credits included.

Claude / Claude Desktop

Custom connectors cannot send headers, so put the key in the URL: Settings → Connectors → Add custom connector, then paste:

https://mcp.ipregistry.co/mcp?key=YOUR_IPREGISTRY_API_KEY
Claude Code

Run in your terminal:

claude mcp add --transport http ipregistry https://mcp.ipregistry.co/mcp \
  --header "Authorization: ApiKey YOUR_IPREGISTRY_API_KEY"
Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.ipregistry]
url = "https://mcp.ipregistry.co/mcp?key=YOUR_IPREGISTRY_API_KEY"
Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ipregistry": {
      "url": "https://mcp.ipregistry.co/mcp",
      "headers": { "Authorization": "ApiKey YOUR_IPREGISTRY_API_KEY" }
    }
  }
}
Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "ipregistry": {
      "httpUrl": "https://mcp.ipregistry.co/mcp",
      "headers": { "Authorization": "ApiKey YOUR_IPREGISTRY_API_KEY" }
    }
  }
}
LM Studio

Add to mcp.json (in-app: Program → Install → Edit mcp.json), or use the one-click button below:

{
  "mcpServers": {
    "ipregistry": {
      "url": "https://mcp.ipregistry.co/mcp",
      "headers": { "Authorization": "ApiKey YOUR_IPREGISTRY_API_KEY" }
    }
  }
}
Smithery

Open the ipregistry/mcp-server listing on Smithery, paste your API key, and follow the generated instructions for your client — connections go through the Smithery gateway:

https://smithery.ai/server/ipregistry/mcp-server
Visual Studio Code

Add to .vscode/mcp.json (or run MCP: Add Server):

{
  "servers": {
    "ipregistry": {
      "type": "http",
      "url": "https://mcp.ipregistry.co/mcp",
      "headers": { "Authorization": "ApiKey YOUR_IPREGISTRY_API_KEY" }
    }
  }
}
Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (restart Windsurf afterwards):

{
  "mcpServers": {
    "ipregistry": {
      "serverUrl": "https://mcp.ipregistry.co/mcp",
      "headers": { "Authorization": "ApiKey YOUR_IPREGISTRY_API_KEY" }
    }
  }
}

Available tools

Batch-first and read-only: every tool accepts up to 1024 targets per call, repeated lookups are served from a session cache at no cost, and every response reports credit usage.

ipregistry_check_ip_security

VPN, proxy, Tor, relay, abuser, attacker, bogon, cloud provider.

ipregistry_geolocate_ip

Location facet only: continent to coordinates, plus time zone.

ipregistry_lookup_asn

ASN registration and routing data, with announced prefixes on request.

ipregistry_lookup_ip

Complete intelligence for 1–1024 IPs: location, network, company, carrier, currency, time zone, security.

ipregistry_lookup_ip_network

Ownership facet: ASN, organization, route, connection type, carrier.

ipregistry_my_ip

Public IP of the MCP client connection, with its full profile.

ipregistry_parse_user_agent

Parse User-Agent strings into browser, device, engine, and OS.