briandconnelly/mcp-server-ipinfo

Overview

An MCP server that provides IP geolocation data by querying the ipinfo.io API. It exposes functions for retrieving location information about IP addresses, such as city, region, country, and ISP. The server is built in Python and designed to be used within the Model Context Protocol ecosystem.

Best for

Best for
Developers building MCP-based agents that need IP geolocation lookups.

Use cases

• Look up the geographic location of a given IP address.
• Retrieve ISP and network information for an IP.
• Verify IP origin or detect anomalies in network logs.

How to use

Tools exposed

• IPINFO_API_TOKEN
• IPINFO_CACHE_TTL
• IPINFO_CACHE_SIZE
• ipinfo_lookup_my_ip()
• ipinfo_lookup_ips(ips, detail='summary')
• ipinfo_summarize_ips(ips, group_by=('country', 'asn'), top_n=50)
• ipinfo_check_residential_proxy(ip)
• ipinfo_generate_map_url(ips)

Tested with

Claude Desktop

Example client config

{\n  "mcpServers": [\n    {\n      "id": "ipinfo",\n      "command": "uvx",\n      "arguments": [\n        "mcp-server-ipinfo"\n      ],\n      "env": {\n        "IPINFO_API_TOKEN": "<YOUR TOKEN>"\n      }\n    }\n  ]\n}

Notes

An MCP server that provides IP geolocation data by querying the ipinfo.io API. It exposes functions for retrieving location information about IP addresses, such as city, region, country, and ISP. The server is built in Python and designed to be used within the Model Context Protocol ecosystem.

43 stars on GitHub. Last updated 2026-05-31. Licensed MIT.

Use cases

• Look up the geographic location of a given IP address.
• Retrieve ISP and network information for an IP.
• Verify IP origin or detect anomalies in network logs.

Pros

• Lightweight and easy to integrate into MCP-compatible clients.
• Uses a reliable external API (ipinfo.io) for accurate geolocation.
• Simple Python implementation, straightforward to extend.

Cons

• Requires an ipinfo.io API key, which may have usage limits or cost.
• Only returns data for IPs that ipinfo.io can resolve; limited for private or reserved IPs.
• Not a standalone tool; requires an MCP runtime to function.

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.