mcp server ipinfo

Local 2025-08-31 23:17:14 0
Security And IAM @briandconnelly/mcp-server-ipinfo

A Model Context Protocol server that retrieves detailed geographic information about IP addresses using the ipinfo.io API, helping determine user location and network details.

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.

[
  {
    "description": "Get information about an IP address.nnUse this tool to:n- Determine the user's geographic location to coarse granularityn- Get information about the user's internet service providern- Get information about a specific IP addressnnArgs:n    ip (str | None): The IP address to look up. If None, returns informationn        about the requesting client's IP address.n    ctx (Context): The MCP request context.nnReturns:n    IPDetails: Object containing information about the IP address,n        including geographic location, network operator, and more.nnNote:n    This tool requires an IPInfo API Token specified via the IPINFO_API_TOKENn    environment variable for full functionality.n",
    "inputSchema": {
      "properties": {
        "ip": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ip"
        }
      },
      "required": [
        "ip"
      ],
      "title": "get_ip_detailsArguments",
      "type": "object"
    },
    "name": "get_ip_details"
  }
]