iplocate/mcp-server-iplocate

An MCP (Model Context Protocol) server for IPLocate.io - providing comprehensive IP address intelligence including geolocation, network information, privacy detection, and abuse contacts.
Features
This MCP server provides tools to look up detailed information about IP addresses:
- **Geolocation**: Country, city, coordinates, timezone, postal code and more
- **Network Information**: ASN name, number, type, network range, ISP information
- **Privacy & Security**: VPN detection, proxy detection, Tor exit nodes, hosting providers
- **Company Data**: Organization name, domain, business type
- **Abuse Contacts**: Email, phone, and address for reporting malicious activity
Requirements
To follow our quick start setup instructions, you will need:
- Node.js 18 or higher
- npm
- A compatible MCP client. For example, Cursor, Claude Desktop.
Quick Start
The easiest way to use this MCP server is through your MCP client. Simply configure your client with the setup instructions below:
Configure your MCP client
Cursor
One-click setup:
Manual configuration:
1. In your project directory, create the configuration:
2. Add the following to .cursor/mcp.json:
Replace your_api_key_here with your actual API key from IPLocate.io.
Claude Desktop
1. Open Claude Desktop settings
- On macOS: Cmd + ,
- On Windows: Ctrl + ,
2. Go to the "Developer" tab and click "Edit Config"
3. Add the IPLocate server configuration:
Replace your_api_key_here with your actual API key from IPLocate.io.
VS Code (Preview)
1. Create the VS Code MCP configuration:
2. Add the following to .vscode/mcp.json:
Replace your_api_key_here with your actual API key from IPLocate.io.
Available tools
The server provides the following tools:
lookup_ip_address_details
Get comprehensive information about an IP address including all available data.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up. If not provided, returns information about the caller's IP address.
**Example:**
**Returns:** All available data about the IP address, including geolocation, network information, privacy, and company data.
lookup_ip_address_location
Get geographic location information for an IP address.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up.
**Returns:** Country, city, coordinates, timezone, postal code, and more.
lookup_ip_address_privacy
Check whether an IP address is detected as a VPN, proxy, other anonymizing service; is on an abuse blocklist; or is a hosting provider.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up.
**Returns:** VPN status, proxy detection, Tor exit node status, hosting provider information.
lookup_ip_address_network
Get network and ASN (Autonomous System Number) information for an IP address.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up.
**Returns:** ASN details, network range, ISP information, regional registry.
lookup_ip_address_company
Get company/organization information for an IP address.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up.
**Returns:** Company name, domain, country, organization type.
lookup_ip_address_abuse_contacts
Get abuse contact information for an IP address to report malicious activity.
**Parameters:**
- ip (optional): IPv4 or IPv6 address to look up.