Ip2location Io MCP server
io.github.ip2location/mcp-ip2location-io·v1.1.1·17 starsIP Geolocation MCP server that query the geolocation information using IP2Location.io API.
17 stars20 downloads/wk
Reviews
Write oneNobody has reviewed Ip2location Io yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Ip2location Io tools (1)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_geolocationFetch geolocation for the given IP address(es).
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 30 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
How Ip2location Io compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 77/100
- higher than 50% of 48,255 servers
- Tools
- 1
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 17
- more than 90% of 28,688 servers
- Downloads a week
- 20
- more than 7% of 12,191 servers with a package
What its tools let an agent do: 1 read
Install Ip2location Io in Claude Code, Cursor or VS Code
claude mcp add mcp-ip2location-io -- uvx mcp-ip2location-io
What the publisher says
From the Ip2location Io repository's README, as published. We do not edit it. Read it on GitHub
IP2Location.io MCP server
IP2Location.io MCP Server is a Model Context Protocol (MCP) server that enables MCP-compatible AI clients to perform IP address geolocation and network intelligence lookups using the IP2Location.io API.
Give it an IPv4 or IPv6 address and the MCP server can retrieve information such as geographic location, ASN, ISP, domain, network type, and proxy information, depending on your IP2Location.io API plan.
This makes it useful for IP investigation, network troubleshooting, traffic analysis, localization, security analysis, and enriching IP addresses found in logs or other datasets.
Features
- Comprehensive Geolocation Data: Retrieve country, region, city, ZIP/postal code, latitude, longitude, time zone, and other location information.
- ASN Lookup: Identify the Autonomous System Number (ASN) and Autonomous System (AS) associated with an IP address.
- Network Intelligence: Retrieve information such as ISP, domain, connection speed, usage type, and other network attributes depending on your plan.
- Proxy and Security Information: Detect proxy-related information and, on supported plans, additional VPN, Tor, data center, threat, and fraud information.
- IPv4 and IPv6 Support: Query both IPv4 and IPv6 addresses.
- Bulk IP Lookup: Send multiple IP addresses in one prompt and automatically use the IP2Location.io Bulk API when available.
- MCP Integration: Use IP intelligence directly from MCP-compatible AI applications.
- Asynchronous Requests: Uses httpx for asynchronous API requests.
[!NOTE]
The fields returned by IP2Location.io depend on your API subscription plan.
Requirements
There are two ways to use this MCP server.
Cloud-hosted MCP server
Recommended when you want to connect directly to the hosted IP2Location.io MCP server.
You need:
- An MCP-compatible client such as Claude Desktop
- Node.js / npx
- An IP2Location.io API key
Local MCP server
Use this option when you want to run the MCP server locally.
You need:
- Python 3.13 or later
- uv
- An MCP-compatible client such as Claude Desktop
- An IP2Location.io API key
You can sign up for a free IP2Location.io API key. The Free plan provides up to 50,000 IP Geolocation API queries per month.
The underlying IP2Location.io REST API also supports limited keyless access of up to 1,000 queries per day. For this MCP server, configuring an API key is recommended and is used in the setup examples below.
Setup
You can use this MCP server in Claude Desktop in either of the following ways:
- Cloud-hosted MCP server: Recommended if you want to connect directly to the hosted IP2Location.io MCP server.
- Local MCP server: Use this if you want to download and run the original MCP server on your own machine.
Option 1: Cloud-hosted MCP server
Follow these steps to connect Claude Desktop to the hosted IP2Location.io MCP server.
- Make sure you have installed Claude Desktop. If you have not installed it yet, download it from here for Windows and macOS, or follow this guide for Linux users.
- Open the claudedesktopconfig.json file in your choice of editor. If you do not have one yet, follow this guide to create one.
- Add the following to your claudedesktopconfig.json:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Ip2location Io: common questions
- Is Ip2location Io MCP server safe?
- Mostly: it is graded B (77/100). Read the Ip2location Io safety report
- How do I install Ip2location Io?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Ip2location Io need an API key?
- Yes. The registry entry asks for
IP2LOCATION_API_KEY. - Is Ip2location Io maintained?
- The last commit was 68 days ago (2026-08-28). The latest release is v1.1.1.
- How does Ip2location Io compare with other MCP servers?
- safety score 77/100 (higher than 50% of 48,255 servers); tools 1 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.