IP2Location.io MCP server
Geolocation lookup server for IP addresses via Model Context Protocol.
Key Features
Use Cases
README
IP2Location.io MCP server
This is a simple Model Context Protocol (MCP) server implementation for IP2Location.io API. It will return a detailed geolocation information for any given IPv4 or IPv6 address.
Features
- Comprehensive Geolocation Data: Retrieves a wide range of information, including country, region, city, latitude, longitude, ZIP code, time zone, and more.
- Network Details: Provides network-related data such as ASN, ISP, domain, and network speed.
- Security Insights: Detects proxy information, including proxy type and provider.
- Simple Integration: Built as a
FastMCPtool, allowing for easy integration into compatible systems. - Asynchronous: Utilizes
httpxfor non-blocking asynchronous API requests.
Requirement
This MCP server supports to query without an API key, with a limitation of 1,000 queries per day. You can also sign up for a free API key and enjoy up to 50,000 queries per month.
The setup also use uv, which can be install by following the guide.
Setup
Follow the steps to use this MCP server with Claude Desktop:
- Download the repository to your local.
- Setup the
uvpackage manager, you can once again refer to the guide to do so. - Make sure you have installed the Claude Desktop, if you haven't, kindly download from here for Windows and MacOS users, or follow this guide for Linux user.
- Open the
claude_desktop_config.jsonin your choice of editor, if you do not having one yet, follow this guide to create one. - Add the following to your
claude_desktop_config.json:
{
"mcpServers": {
"ip2locationio": {
"command": "uv",
"args": [
"--directory",
"/path/to/ip2locationio/src",
"run",
"server.py"
],
"env": {
"IP2LOCATION_API_KEY": "<YOUR API key HERE>"
}
}
}
}
- Remember to replace the
/path/to/ip2locationiopath with your actual path to IP2Location.io MCP server in local. - To get your API key, just login to your dashboard and get it from there. Replaced the
<YOUR API key HERE>in above with your actual API key. - Restart the Claude Desktop after save the changes, and you should see it appear in the
Search and toolsmenu.
Usage
Just enter your query about the IP in a chat in Claude Desktop. Some of the example query will be:
- Where is the location of (IP)?
- Where is (IP) located?
- What is the coordinate of (IP)?
For instance, below is the result of the IP 8.8.8.8:
In Claude Desktop, the model will automatically generate the output based on the result returned by IP2Location.io MCP server.
Environment Variable
IP2LOCATION_API_KEY
The IP2Location.io API key, which allows you to query up to 50,000 per month and more details of the IP address. You can sign up for a free API key, or subscribe to a plan to enjoy more benefits.
Tool
get_geolocation
Description Fetch geolocation for the given IP address. It helps users to retrieve detailed information such as country, region, city, latitude, longitude, ZIP code, time zone, ASN, and proxy information for any IPv4 or IPv6 address.
Arguments ip (str): The IP address (IPv4 or IPv6) to analyze.
Returns A JSON string containing the geolocation data. The result may include the following fields, depending on your API plan:
- Location & Geography: Country, region, district, city, ZIP code, latitude & longitude, time zone.
- Network & Connectivity: ASN (Autonomous System Number), ISP (Internet Service Provider), domain, net speed, IDD code, area code, address type, usage type.
- Mobile Information: MNC (Mobile Network Code), MCC (Mobile Country Code), Mobile Brand.
- Currency & Language: currency code, currency name, currency symbol, language code, language name.
- Proxy & Security: proxy type, last seen, threat level/type, proxy provider, fraud score.
- Others: IAB category, weather, elevation, population, and more.
If the request fails or the IP address is invalid, the tool will return an error message as a string.
License
See the LICENSE file.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
IPLocate MCP Server
Comprehensive IP address geolocation and network intelligence via MCP.
Provides an MCP server interface to IPLocate.io, delivering detailed IP address intelligence including geolocation, network details, privacy detection, and abuse contact information. Easily integrates with popular MCP clients like Cursor and Claude Desktop for seamless IP lookups. Enables users to retrieve geographic, organizational, and security-related data associated with IPv4 and IPv6 addresses by connecting to the IPLocate.io API.
- ⭐ 11
- MCP
- iplocate/mcp-server-iplocate
IP Find MCP Server
A Model Context Protocol server for IP location lookups by AI assistants.
IP Find MCP Server acts as a Model Context Protocol (MCP) server, allowing AI assistants to access geolocation data from the IP Find API. It connects the IP Find API with AI tools, enabling the retrieval of IP address location information in standardized contexts. Designed for integration with MCP clients such as the Claude Desktop App, it simplifies configuration and secure API key management. The server is certified by MCPHub.
- ⭐ 2
- MCP
- ipfind/ipfind-mcp-server
MCP-Geo
Geocoding and reverse geocoding MCP server for LLMs.
MCP-Geo provides geocoding and reverse geocoding capabilities to AI models using the Model Context Protocol, powered by the GeoPY library. It offers various tools such as address lookup, reverse lookup from coordinates, distance calculations, and batch processing of locations, all accessible via standard MCP tool interfaces. Safety features like rate limiting and robust error handling ensure reliable and compliant usage of geocoding services. The server is compatible with environments like Claude Desktop and can be easily configured elsewhere.
- ⭐ 28
- MCP
- webcoderz/MCP-Geo
Aiwen MCP Server for IP Geolocation
High-precision IP geolocation and risk analysis via MCP-compatible API server.
Provides an MCP (Model Context Protocol) server interface for Aiwen Technology’s high-precision IP location services, offering a range of geolocation, network, risk, and identity APIs compatible with AI context standards. Supports detailed IP information retrieval, including geolocation to city, district, or street level, network characteristics, industry classification, risk profiling, and user authenticity analysis. Enables seamless AI model integration and context-aware processing by following the MCP protocol.
- ⭐ 4
- MCP
- ipfred/aiwen-mcp-server-geoip
NearbySearch MCP Server
IP-based nearby search via Google Places, packaged as an MCP tool.
NearbySearch MCP Server enables users to search for nearby places using their IP-based location, leveraging the Google Places API. Designed to run as an MCP server, it offers an accessible interface for location-aware searches with customizable radius and filter options. The tool supports integration with clients such as Claude Desktop and features a simple setup process using Python 3.10+. Ideal for use cases where model context needs to be enriched with location-based search results.
- ⭐ 21
- MCP
- kukapay/nearby-search-mcp
Dappier MCP Server
Real-time web search and premium data access for AI agents via Model Context Protocol.
Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.
- ⭐ 35
- MCP
- DappierAI/dappier-mcp
Didn't find tool you were looking for?