Skip to main content

MCP server

Our MCP (Model Context Protocol) server lets AI IDEs and assistants call the IPLocate API tools directly.

It exposes convenient tools for IP lookups, privacy checks, network/ASN info, company attribution, and abuse contacts.

Repository​

iplocate/mcp-server-iplocate on GitHub

MCP configuration​

Claude Desktop​

Open Developer settings → Edit Config and add:

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor​

Install MCP Server

Create .cursor/mcp.json in your project:

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code (Preview)​

Create .vscode/mcp.json:

{
  "servers": {
    "iplocate": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Sign up for a free API key to increase your free quota: iplocate.io/signup.

Available tools​

These tools map to IPLocate API capabilities:

  • lookup_ip_address_details: Full IP record (geo, network, privacy, company, abuse)
  • lookup_ip_address_location: Country, region, city, lat/lon, timezone, postal code
  • lookup_ip_address_privacy: VPN, proxy, Tor, hosting/provider signals
  • lookup_ip_address_network: ASN number/name, network range, ISP, RIR/registry
  • lookup_ip_address_company: Organization name, domain, business type
  • lookup_ip_address_abuse_contacts: Abuse contact email/phone/address and network range

Quick examples​

Check IP security posture​

{
  "tool": "lookup_ip_address_privacy",
  "params": {"ip": "8.8.8.8"}
}

Get full details​

{
  "tool": "lookup_ip_address_details",
  "params": {"ip": "1.1.1.1"}
}

Returns combined geolocation, ASN, privacy, company, and abuse data.

Compare two IPs (using prompts)​

Use the built-in ip_comparison prompt in your MCP client to summarize differences between two IPs, including geography and ASN.

For more options and examples, see the repository: iplocate/mcp-server-iplocate.