MCP Server

The Ipregistry MCP server exposes our IP intelligence to LLMs and AI agents over the Model Context Protocol. Point any MCP client at it and your agent can geolocate addresses, check threats, look up autonomous systems and parse user agents, all with live Ipregistry data. See mcp.ipregistry.co for one-click setup buttons and the full client list.

Endpoint

The server speaks the Streamable HTTP transport:

https://mcp.ipregistry.co/mcp

Authentication

Every caller authenticates with their own API key, using the same options as the REST API: an Authorization header, or a key query parameter for clients that cannot send headers.

Authorization: ApiKey YOUR_API_KEY

https://mcp.ipregistry.co/mcp?key=YOUR_API_KEY

No key yet? Create one for free, trial credits included.

Available tools

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

Tool	Purpose
ipregistry_check_ip_security	VPN, proxy, Tor, relay, abuser, attacker, bogon and cloud provider flags.
ipregistry_geolocate_ip	Location facet only: continent down 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 to 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.

Client setup

Claude Code

Run in your terminal:

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

Claude and Claude Desktop

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

https://mcp.ipregistry.co/mcp?key=YOUR_API_KEY

Cursor

Add to ~/.cursor/mcp.json:

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

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_API_KEY" }
        }
    }
}

Other clients

Codex CLI, Gemini CLI, LM Studio, Windsurf and Smithery are supported too, with ready-to-copy snippets on mcp.ipregistry.co.