home / mcp / ip geolocation mcp server

IP Geolocation MCP Server

IP Geolocation Server for MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "briandconnelly-mcp-server-ipinfo": {
      "command": "uvx",
      "args": [
        "mcp-server-ipinfo"
      ],
      "env": {
        "IPINFO_API_TOKEN": "<YOUR TOKEN>"
      }
    }
  }
}

This MCP server uses the ipinfo.io API to fetch detailed information about a given IP address, enabling you to approximate a user’s location and network context for your applications.

How to use

You run the IP geolocation MCP server through the MCP command line interface. Start it with your IPInfo API token to enable querying IP detail data. You can either begin from a stable release command or pull the latest version during development.

How to install

Prerequisites you need before starting include the MCP CLI tool (uvx) and an IPInfo API token. If you don’t have a token yet, sign up for a free account at ipinfo.io/signup and generate your token.

Install and run the server using the standard MCP run command. The command uses the mcp-server-ipinfo entry and requires your IPINFO_API_TOKEN to be set in the environment.

Development version can be used to fetch the latest changes directly from GitHub. Use the --from option to pull the repository and then run the same mcp server entry.

Copy these example commands and adjust your token accordingly.

Additional notes

Tokens: You must provide an IPINFO_API_TOKEN to enable API calls to ipinfo.io. Create this token in your IPInfo account and substitute it in the commands below.

Example usage patterns include a stable run and a development run. The development run pulls the latest code from GitHub, while the stable run uses the published release.

Configuration example

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

Available tools

get_ip_details

Retrieves detailed information about a given IP address, returning a structured IPDetails object that includes location, organization, and country data.