mcp -iplocate

This MCP server integrates IP address geolocation and rich network data from IPLocate.io into your MCP client. It exposes a set of lookup tools that return structured data about an IP address, including geolocation, network/ASN information, privacy and abuse detection, and company details. The available tools are lookup_ip_address_details (comprehensive data), lookup_ip_address_location (geographic data), lookup_ip_address_privacy (VPN/proxy/hosting checks), lookup_ip_address_network (ASN and network info), lookup_ip_address_company (organization details), and lookup_ip_address_abuse_contacts (abuse contact information). You can provide an IP address as input or omit it to use the caller’s IP. In client configurations, set IPLOCATE_API_KEY via environment variables as shown in the example configurations, and point the MCP server to the @iplocate/mcp-server package using npx.

Prerequisites:

• Node.js 18 or higher
• npm (or yarn)

Option A: Run directly with npx (recommended for quick start)

1. Ensure Node.js and npm are installed.
2. Run the MCP server via npx:

npx -y @iplocate/mcp-server

Option B: Install globally from npm and run

1. Install globally:

npm install -g @iplocate/mcp-server

2. Start the server (the executable name may be mcp-server-iplocate or as provided by the package):

mcp-server-iplocate

Option C: Use Docker (if you prefer containerized deployment)

1. Build or pull a prebuilt image that runs the MCP server with the IPLocate bundle.
2. Run the container with the necessary environment variable for your API key, e.g.:

docker run -e IPLOCATE_API_KEY=your_api_key_here -it some-iplocate-mcp-image

Configuration tip: Regardless of the method, set IPLOCATE_API_KEY in your MCP client configuration (or as an environment variable) to authorize requests to IPLocate.io.

Tips and considerations:

• Always provide IPLOCATE_API_KEY in your client or environment to access IPLocate.io data.
• The API rate limits and quotas depend on your IPLocate.io plan; monitor usage to avoid throttling.
• In MCP client configs, you can reuse the same mcpServers.plt entry across different clients (Cursor, Claude Desktop, VS Code, etc.).
• The server supports both IPv4 and IPv6 addresses; if you omit the ip parameter, it will analyze the caller’s IP where possible.
• If you encounter connectivity or API-key issues, verify that IPLOCATE_API_KEY is correctly exported in your shell or included in the client’s environment sections.
• For development or testing, you can use the MCP Inspector to validate responses from the server.