IP2Location.io API integration to retrieve the geolocation information for an IP address.
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.
FastMCP
tool, allowing for easy integration into compatible systems.httpx
for non-blocking asynchronous API requests.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.
Follow the steps to use this MCP server with Claude Desktop:
uv
package manager, you can once again refer to the guide to do so.claude_desktop_config.json
in your choice of editor, if you do not having one yet, follow this guide to create one.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>"
}
}
}
}
/path/to/ip2locationio
path with your actual path to IP2Location.io MCP server in local.<YOUR API key HERE>
in above with your actual API key.Search and tools
menu.Just enter your query about the IP in a chat in Claude Desktop. Some of the example query will be:
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.
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.
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:
If the request fails or the IP address is invalid, the tool will return an error message as a string.
See the LICENSE file.
Analyzes user search keyword intent for SEO support using the AI Search Intent API.
MCP server that performs whois lookup against domain, IP, ASN and TLD.
Search for Google images, view results, and download them directly within your IDE.
An MCP server for the Context7 project, providing HTTP streaming and search endpoints for library information without local installation.
A bridge server for connecting to a SearXNG metasearch engine instance.
Query and analyze Portuguese companies using the NIF.PT public API. Supports search by NIF, company name, and city.
Enable Similarity-Distance-Magnitude statistical verification for your search, software, and data science workflows
RAG Search over your content powered by Inkeep
A server for performing deep web searches using the @just-every/search library, requiring API keys via an environment file.
Search and book from over 2 million hotels with shopping and booking capabilities.