IPLocate
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IPLocate look up location for 8.8.8.8"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for IP address geolocation and network data from IPLocate.io
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
Related MCP server: mcp-ipinfo
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
One-click setup:
Manual configuration:
In your project directory, create the configuration:
mkdir -p .cursor touch .cursor/mcp.jsonAdd the following to
.cursor/mcp.json:{ "mcpServers": { "iplocate": { "command": "npx", "args": ["-y", "@iplocate/mcp-server"], "env": { "IPLOCATE_API_KEY": "your_api_key_here" } } } }Replace
your_api_key_herewith your actual API key from IPLocate.io.
Open Claude Desktop settings
On macOS:
Cmd + ,On Windows:
Ctrl + ,
Go to the "Developer" tab and click "Edit Config"
Add the IPLocate server configuration:
{ "mcpServers": { "iplocate": { "command": "npx", "args": ["-y", "@iplocate/mcp-server"], "env": { "IPLOCATE_API_KEY": "your_api_key_here" } } } }Replace
your_api_key_herewith your actual API key from IPLocate.io.
Create the VS Code MCP configuration:
mkdir -p .vscode touch .vscode/mcp.jsonAdd the following to
.vscode/mcp.json:{ "servers": { "iplocate": { "type": "stdio", "command": "npx", "args": ["-y", "@iplocate/mcp-server"], "env": { "IPLOCATE_API_KEY": "your_api_key_here" } } } }Replace
your_api_key_herewith 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:
{
"ip": "8.8.8.8"
}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.
Returns: Abuse contact email, phone, address, and network range.
Available prompts
The server also provides pre-configured prompts to help with common IP analysis tasks:
check_ip_security
Analyze an IP address for security concerns including VPN, proxy, Tor usage, and abuse history.
Example usage: "Use the check_ip_security prompt to analyze 192.168.1.1"
locate_ip_geographically
Get detailed geographic information about an IP address.
Example usage: "Use the locate_ip_geographically prompt to find where I am"
investigate_ip_ownership
Get detailed information about who owns and operates an IP address.
Example usage: "Use the investigate_ip_ownership prompt to check who owns 8.8.8.8"
ip_comparison
Compare geographic and network information between two IP addresses.
Example usage: "Use the ip_comparison prompt to compare 1.1.1.1 and 8.8.8.8"
Add your API key
You can make up to 50 requests per day without an API key.
Sign up for a free API key at IPLocate.io to increase your free quota to 1,000 requests per day.
Sign up for a free API key
Create a free account
Get your API key from the dashboard
Using an API key with this server
The server automatically reads your API key from the IPLOCATE_API_KEY environment variable. Configure it in your MCP client settings (see the configuration examples above) or set it when running manually.
Running the server manually
If you need to run the server manually (for development or testing), you have several options:
Prerequisites
Node.js 18 or higher
npm or yarn
Using npx (recommended)
npx -y @iplocate/mcp-serverWith API key:
On macOS/Linux:
export IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-serverOn Windows:
set IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-serverInstall from npm
npm install -g @iplocate/mcp-server
mcp-server-iplocateInstall from source
git clone https://github.com/iplocate/mcp-server-iplocate.git
cd mcp-server-iplocate
yarn install
yarn build
yarn startFor development with auto-reload:
yarn devTesting
You can test the server using the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsAPI Response Format
The IPLocate API returns comprehensive data about IP addresses. Here's an example response structure:
{
"ip": "8.8.8.8",
"country": "United States",
"country_code": "US",
"city": "Mountain View",
"latitude": 37.386,
"longitude": -122.0838,
"asn": {
"asn": "AS15169",
"name": "Google LLC",
"domain": "google.com"
},
"privacy": {
"is_vpn": false,
"is_proxy": false,
"is_tor": false,
"is_hosting": true
}
// ... and more fields
}For full details, see the IPLocate API documentation.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support
For issues with this MCP server, please open an issue on GitHub
For IPLocate API support, contact support@iplocate.io
For IPLocate API documentation, visit https://iplocate.io/docs
Acknowledgments
Model Context Protocol for the MCP specification
Anthropic for the MCP TypeScript SDK
About IPLocate.io
Since 2017, IPLocate has set out to provide the most reliable and accurate IP address data.
We process 50TB+ of data to produce our comprehensive IP geolocation, IP to company, proxy and VPN detection, hosting detection, ASN, and WHOIS data sets. Our API handles over 15 billion requests a month for thousands of businesses and developers.
Email: support@iplocate.io
Website: iplocate.io
Documentation: iplocate.io/docs
Sign up for a free API Key: iplocate.io/signup
Available Tools
6 toolslookup_ip_address_abuse_contactsLook up IP Address Abuse ContactsA
Get abuse contact information for an IP address to report malicious activity. Includes email, phone, and address of the network administrator. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
lookup_ip_address_companyLook up IP Address CompanyA
Get company/organization information for an IP address including the company name, domain, and type of organization. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
lookup_ip_address_detailsLook up IP Address DetailsA
Get comprehensive information about an IP address including geolocation, network details, privacy/security information, company data, and abuse contacts. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
lookup_ip_address_locationLook up IP Address LocationA
Get geographic location information for an IP address including country, city, coordinates, timezone, and postal code. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
lookup_ip_address_networkLook up IP Address Network (ASN)A
Get network and ASN (Autonomous System Number) information for an IP address including the network operator, route, and regional registry. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
lookup_ip_address_privacyLook up IP Address Privacy & SecurityA
Check whether an IP address is detected as a VPN, proxy, other anonymizing service; is on an abuse blocklist; or is a hosting provider. Can look up any IPv4 or IPv6 address, or your own IP if no address is provided.
Inputs: ip.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct focus within IP address lookup, targeting specific aspects like abuse contacts, company details, location, network info, and privacy checks. However, there is some overlap as 'lookup_ip_address_details' appears to encompass multiple other tools' functionalities, which could cause confusion about when to use it versus the specialized tools.
All tool names follow a consistent 'lookup_ip_address_' prefix with a descriptive suffix (e.g., 'abuse_contacts', 'company', 'details'), using snake_case uniformly throughout. This predictable pattern makes it easy for agents to understand and navigate the toolset.
With 6 tools, the server is well-scoped for IP address information lookup, covering key aspects like geolocation, network details, privacy, and abuse contacts. Each tool serves a clear purpose, and the count is neither too sparse nor overwhelming for the domain.
The toolset provides comprehensive coverage for IP address lookup, including geolocation, network, company, privacy, and abuse contacts, with no obvious gaps in core functionality. A minor gap is the lack of tools for bulk lookups or historical data, but agents can handle single-address queries effectively.
Maintenance
Related MCP Connectors
IP geolocation, ASN and a 0-100 risk score (VPN, proxy, Tor, datacenter) for any IP address.
IP geolocation: country, continent, ASN and ISP lookup
Free abuse IP check: reputation score, threat-feed blacklist matches, Tor/VPN flags, domain WHOIS.
IP geolocation, ASN and network data, plus VPN, proxy and Tor detection. ASN tools need no key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables IP address intelligence lookup including geolocation, network information, privacy detection (VPN/proxy/Tor), company data, and abuse contacts using IPLocate.io API. Supports both IPv4 and IPv6 addresses with comprehensive analysis tools and security assessment capabilities.MIT
- AlicenseNot gradedqualityCmaintenanceProvides IP geolocation data via ipinfo.io, enabling querying IP addresses for location, ISP, and other details through natural language.280 npmMIT
- AlicenseAqualityDmaintenanceEnables AI assistants to perform IP geolocation, proxy detection, and domain WHOIS lookups using IP2Location.io and IP2WHOIS data.5MIT
- AlicenseNot gradedqualityCmaintenanceGeolocate any IP address with country, city, ISP, ASN, and VPN/proxy/Tor detection, with pay-per-call via x402 micropayments and no signup required.MIT