IP Geolocation MCP Server

Name: IP Geolocation MCP Server
Author: briandconnelly

@briandconnelly

Repository

About IP Geolocation MCP Server

IP Geolocation Server for MCP using ipinfo.io

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ip-geolocation-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-server-ipinfo"
      ],
      "env": {
        "IPINFO_API_TOKEN": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is IP Geolocation MCP Server?

A Model Context Protocol server that exposes the ipinfo.io API to AI agents. It geolocates IPv4 and IPv6 addresses, identifies ISPs and ASNs, detects VPN/proxy/Tor exit nodes, and generates interactive maps for sets of IPs.

How to use IP Geolocation MCP Server?

Install it via uvx or download the .mcpb bundle for Claude Desktop. Set the IPINFO_API_TOKEN environment variable (optional for free Lite tier). Tools are invoked by an MCP client using commands like ipinfo_lookup_ips.

Key features of IP Geolocation MCP Server?

Geolocate IPv4 and IPv6 addresses
Identify ISPs and ASNs
Detect VPN, proxy, and Tor exit nodes
Generate interactive IP maps
Batch lookup up to 500,000 IPs
Plan tiers: Lite, Core, Plus, Enterprise

Use cases of IP Geolocation MCP Server?

Analyze server logs for geographic distribution of visitors
Check if an IP is a known residential proxy exit node
Visualize IP addresses on a map for threat intelligence
Aggregate large IP sets by country, continent, or ASN
Enrich AI agent context with IP geolocation data

FAQ from IP Geolocation MCP Server

What is the difference between the free Lite tier and paid tiers?

The free Lite tier provides only country and ASN basics. Core tier adds full geolocation and privacy flags; Plus adds carrier/company data; Enterprise adds domains and abuse contacts.

How do I get an API token?

Sign up for a free IPInfo account at https://ipinfo.io/signup to obtain an API token. Set it as the IPINFO_API_TOKEN environment variable.

What are the batch size limits?

The ipinfo_lookup_ips tool is capped at 500,000 IPs per call. Invalid or special-use addresses are filtered out.

Does the server require an API token to run?

No. Without a token the server runs in free Lite mode, which returns only country, country code, continent, and ASN basics. For most features a token is needed.

How does the server handle errors?

Every tool raises a ToolError with a JSON envelope containing a stable code, a temporary flag, and hints for repair. Agents should parse the JSON and branch on the error code.

Comments

More Other MCP servers

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K