by ip2location
Provides detailed geolocation, network, and security information for IPv4 and IPv6 addresses via the IP2Location.io API.
Delivers comprehensive geolocation data—including country, region, city, coordinates, ZIP code, time zone—plus network details (ASN, ISP, domain, speed) and security insights (proxy type, provider, threat level) for any IPv4 or IPv6 address.
uv
package manager.claude_desktop_config.json
with the MCP server command and set the IP2LOCATION_API_KEY
environment variable (optional; limited free queries are available without a key).get_geolocation
becomes available in the "Search and tools" menu.httpx
for non‑blocking API calls.Q: Do I need an API key? A: The server works without a key but is limited to 1,000 queries per day. Supplying a free API key raises the limit to 50,000 queries per month.
Q: Which IP versions are supported? A: Both IPv4 and IPv6 addresses are supported.
Q: How is the server started?
A: Use uv --directory <repo_path>/src run server.py
(see serverConfig
below).
Q: Can I use this with other AI assistants?
A: Yes, any client that can call an MCP server and handle the JSON response can integrate the get_geolocation
tool.
Q: What environment variable is required?
A: IP2LOCATION_API_KEY
(optional for higher query limits).
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.
Please log in to share your review and rating for this MCP.
{ "mcpServers": { "ip2locationio": { "command": "uv", "args": [ "--directory", "/path/to/ip2locationio/src", "run", "server.py" ], "env": { "IP2LOCATION_API_KEY": "<YOUR_API_KEY>" } } } }
Discover more MCP servers with similar functionality and use cases
by danny-avila
Provides a customizable ChatGPT‑like web UI that integrates dozens of AI models, agents, code execution, image generation, web search, speech capabilities, and secure multi‑user authentication, all open‑source and ready for self‑hosting.
by ahujasid
BlenderMCP integrates Blender with Claude AI via the Model Context Protocol (MCP), enabling AI-driven 3D scene creation, modeling, and manipulation. This project allows users to control Blender directly through natural language prompts, streamlining the 3D design workflow.
by pydantic
Enables building production‑grade generative AI applications using Pydantic validation, offering a FastAPI‑like developer experience.
by GLips
Figma-Context-MCP is a Model Context Protocol (MCP) server that provides Figma layout information to AI coding agents. It bridges design and development by enabling AI tools to directly access and interpret Figma design data for more accurate and efficient code generation.
by mcp-use
Easily create and interact with MCP servers using custom agents, supporting any LLM with tool calling and offering multi‑server, sandboxed, and streaming capabilities.
by sonnylazuardi
This project implements a Model Context Protocol (MCP) integration between Cursor AI and Figma, allowing Cursor to communicate with Figma for reading designs and modifying them programmatically.
by lharries
WhatsApp MCP Server is a Model Context Protocol (MCP) server for WhatsApp that allows users to search, read, and send WhatsApp messages (including media) through AI models like Claude. It connects directly to your personal WhatsApp account via the WhatsApp web multi-device API and stores messages locally in a SQLite database.
by idosal
GitMCP is a free, open-source remote Model Context Protocol (MCP) server that transforms any GitHub project into a documentation hub, enabling AI tools to access up-to-date documentation and code directly from the source to eliminate "code hallucinations."
by Klavis-AI
Klavis AI provides open-source Multi-platform Control Protocol (MCP) integrations and a hosted API for AI applications. It simplifies connecting AI to various third-party services by managing secure MCP servers and authentication.