MCPgee
MCPgee
MCPgeeMCPgee

IPInfo

v1.0.0•Search & Data Extraction•stable

IP Geolocation Server for MCP

ipinfomcpai-integration
Share:
43
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is IPInfo?

IPInfo is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ip geolocation server for mcp

IP Geolocation Server for MCP

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • IP Geolocation Server for MCP

Use Cases

Query IP geolocation information
briandconnelly

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 10, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx ipinfo

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use IPInfo

The mcp-server-ipinfo package by Brian Connelly wraps the IPInfo.io geolocation API as an MCP server, giving AI assistants the ability to look up geographic and network information for IP addresses in real time. It exposes five tools covering single IP lookup, batch lookups of up to 500,000 IPs, statistical summarization by country or ASN, residential proxy detection, and interactive map generation. Security researchers, network engineers, and developers analyzing traffic logs can ask Claude questions about IP addresses and get structured geolocation data without writing any code.

Prerequisites

  • Python 3.10 or higher and the uv package manager installed
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • An IPInfo.io API token (optional — free Lite mode works without one, but a token unlocks higher rate limits and advanced fields)
1

Install uv (if not already installed)

The server uses uv as its Python package manager and runtime. Install it with the official installer script.

curl -LsSf https://astral.sh/uv/install.sh | sh
2

Get an IPInfo API token (optional)

Visit https://ipinfo.io/signup to create a free account and generate an API token. Without a token the server runs in Lite mode with rate limits. Copy your token for the next step.

3

Test the server manually

Run the server once to verify it launches correctly. It will exit immediately in STDIO mode without a client connected, which is expected.

uvx mcp-server-ipinfo
4

Add the server to your MCP client configuration

Add the server entry to claude_desktop_config.json. Include your API token if you have one; omit the env block to use Lite mode.

{
  "mcpServers": {
    "ipinfo": {
      "command": "uvx",
      "args": ["mcp-server-ipinfo"],
      "env": {
        "IPINFO_API_TOKEN": "your_token_here",
        "IPINFO_CACHE_TTL": "3600",
        "IPINFO_CACHE_SIZE": "4096"
      }
    }
  }
}
5

Restart your MCP client

Restart Claude Desktop (or reload MCP servers) so it discovers ipinfo and its five tools.

IPInfo Examples

Client configuration

Complete claude_desktop_config.json entry for mcp-server-ipinfo with an API token and caching settings.

{
  "mcpServers": {
    "ipinfo": {
      "command": "uvx",
      "args": ["mcp-server-ipinfo"],
      "env": {
        "IPINFO_API_TOKEN": "your_ipinfo_token_here",
        "IPINFO_CACHE_TTL": "3600",
        "IPINFO_CACHE_SIZE": "4096"
      }
    }
  }
}

Prompts to try

Example prompts for querying IP geolocation data through the MCP server.

- "What is my current public IP address and where is it located?"
- "Look up the geolocation for IP addresses 8.8.8.8 and 1.1.1.1 and compare their network owners"
- "Summarize this list of IPs by country and show the top 5 countries: 203.0.113.1, 198.51.100.5, 192.0.2.10"
- "Generate an interactive IPInfo map for these IP addresses from our server logs"
- "Is 123.45.67.89 a residential proxy or a legitimate user IP?"

Troubleshooting IPInfo

uvx command not found

Install uv with 'curl -LsSf https://astral.sh/uv/install.sh | sh' and restart your terminal. On macOS you can also use 'brew install uv'. Verify with 'uvx --version'.

API returns 429 Too Many Requests

You are hitting IPInfo's rate limit for the free Lite tier. Sign up for a free account at ipinfo.io/signup to get an API token and set it as IPINFO_API_TOKEN in your MCP config. Increasing IPINFO_CACHE_TTL also reduces repeated API calls.

Proxy detection tool returns 'feature not available'

Residential proxy detection (ipinfo_check_residential_proxy) requires an Enterprise+ IPInfo subscription. Use a standard paid plan or the free tier for country, city, ASN, and basic geolocation data instead.

Frequently Asked Questions about IPInfo

What is IPInfo?

IPInfo is a Model Context Protocol (MCP) server that ip geolocation server for mcp It connects AI assistants to external tools and data sources through a standardized interface.

How do I install IPInfo?

Follow the installation instructions on the IPInfo GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with IPInfo?

IPInfo works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is IPInfo free to use?

Yes, IPInfo is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

IPInfo Alternatives — Similar Search & Data Extraction Servers

Looking for alternatives to IPInfo? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.

TrendRadar

★ 58.0k

A real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va

Scrapling

★ 52.7k

🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

PDF Math Translate

★ 33.9k

[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero

GPT Researcher

★ 27.2k

An autonomous agent that conducts deep research on any data using any LLM providers

Agent Reach

★ 20.1k

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

Xiaohongshu

★ 13.7k

MCP for xiaohongshu.com

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Search & Data ExtractionBrowse All Servers

Quick Config Preview

{ "mcpServers": { "ipinfo": { "command": "npx", "args": ["-y", "ipinfo"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use IPInfo?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides