home / mcp / iplocate mcp server

IPLocate MCP Server

MCP server for looking up IP address geolocation (IP to country, IP to city), network information, proxy and VPN detection, abuse contacts, and more - using the IPLocate.io API.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server provides IP address geolocation and network data from IPLocate.io. It powers rich insights like geolocation, ASN details, privacy signals, and abuse contacts, all accessible through your MCP client.

How to use

You use this MCP server by connecting an MCP client to the local or remote server configuration. The server exposes a set of endpoints (via MCP prompts and tools) that let you look up IP address details, geographic location, network information, privacy status, company data, and abuse contacts. To start, configure your MCP client with a local stdio setup that runs the MCP server command and passes your IPLocate API key. Once connected, you can query an IP address and receive a rich data payload for your analysis, automation, or decision making.

How to install

Prerequisites: Node.js 18 or higher and npm.

Option 1 — Run with npx (recommended):

export IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

Option 2 — Install from npm and run the server binary/name (as shown):

npm install -g @iplocate/mcp-server
mcp-server-iplocate

Option 3 — Install from source and start (for development or advanced usage):

git clone https://github.com/iplocate/mcp-server-iplocate.git
cd mcp-server-iplocate
yarn install
yarn build
yarn start
```

For development with auto-reload use:
```
yarn dev

Available tools

lookup_ip_address_details

Get comprehensive information about an IP address including geolocation, network information, privacy signals, company data, and abuse contacts.

lookup_ip_address_location

Get geographic location information for an IP address, including country, city, coordinates, timezone, and postal code.

lookup_ip_address_privacy

Check VPN, proxy, Tor, or hosting provider status for an IP address and related abuse/hosting details.

lookup_ip_address_network

Get network and ASN information such as ASN, network range, and ISP data.

lookup_ip_address_company

Retrieve company/organization data for an IP address, including name, domain, and type.

lookup_ip_address_abuse_contacts

Obtain abuse contact details for reporting malicious activity associated with an IP address.

check_ip_security

Prompt to analyze an IP address for security concerns like VPN or proxy usage and abuse history.

locate_ip_geographically

Prompt to fetch detailed geographic information for an IP address.

investigate_ip_ownership

Prompt to check ownership and operation details of an IP address.

ip_comparison

Prompt to compare geographic and network information between two IP addresses.