Happy slice of mcp pizzaMCP.pizza
Fire in da houseTop Tip:Paying $100+ per month for Perplexity, MidJourney, Runway, ChatGPT and other tools is crazy - get all your AI tools in one site starting at $15 per month with Galaxy AI Fire in da houseCheck it out free

mcp-server-ipinfo

MCP.Pizza Chef: briandconnelly

The mcp-server-ipinfo is an MCP server that integrates with the ipinfo.io API to fetch detailed geolocation and network information about IP addresses. It enables applications to determine approximate user location and network details in real time, enhancing context-aware workflows. This server is easy to install and configure, requiring an ipinfo.io API token, and is compatible with MCP clients like Claude desktop for seamless integration.

Use This MCP server To

Determine user location from IP address in real time Fetch network details for security or analytics Enhance chatbots with geolocation context Integrate IP geolocation into MCP-enabled apps Provide location-based content or services Log IP info for audit and monitoring Correlate IP data with user activity Support fraud detection with IP insights

README

IP Geolocation MCP Server

This is a simple Model Context Protocol server that uses the ipinfo.io API to get detailed information about an IP address. This can be used to determine where the user is located (approximately) and what network they are used.

IP Geolocation Server MCP server

Example conversation using mcp-server-ipinfo

Installation

You'll need to create a token to use the IPInfo API. If you don't already have one, you can sign up for a free account at https://ipinfo.io/signup.

To use with Claude desktop, add the following to the mcpServers section of your claude_desktop_config.json file:

    "ipinfo": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/briandconnelly/mcp-server-ipinfo.git",
        "mcp-server-ipinfo"
      ],
      "env": {
        "IPINFO_API_TOKEN": "<YOUR TOKEN HERE>"
      }
    }

Components

Tools

  • get_ip_details: This tool is used to get detailed information about an IP address.
    • Input: ip: The IP address to get information about.
    • Output: IPDetails: A Pydantic model containing detailed information about the IP, including location, organization, and country details.

Resources

No custom resources are included

Prompts

No custom prompts are included

License

MIT License - See LICENSE file for details.

Disclaimer

This project is not affiliated with IPInfo.

mcp-server-ipinfo FAQ

How do I obtain an API token for the ipinfo.io service?
You can sign up for a free account at https://ipinfo.io/signup to get your API token required for this MCP server.
Can this MCP server be used with multiple MCP clients?
Yes, it is compatible with any MCP client that supports server integration, including Claude desktop and others.
What kind of IP information does this server provide?
It provides detailed geolocation data such as city, region, country, postal code, and network details like ISP and organization.
Is the IP data updated in real time?
Yes, the server fetches live data from the ipinfo.io API ensuring up-to-date IP geolocation information.
Are there any usage limits or costs associated with the ipinfo.io API?
The ipinfo.io API has free tier limits and paid plans; check their website for details. This MCP server requires a valid token respecting those limits.
How do I configure this server with Claude desktop?
Add the server details to the mcpServers section in your claude_desktop_config.json file as shown in the documentation.
Does this server support IPv6 addresses?
Yes, the ipinfo.io API and this MCP server support both IPv4 and IPv6 address lookups.
Can I customize the data fields returned by the server?
The server returns standard ipinfo.io data fields; customization would require modifying the server code.