# IPinfo MCP server

> Lets AI assistants perform IP intelligence lookups including geolocation, network ownership, and privacy detection.

- Repository: https://github.com/ipinfo/mcp
- Page: https://hostedmcp.org/servers/ipinfo/mcp
- Transport: stdio, remote
- Stars: 2
- License: Apache-2.0
- Latest version: 0.3.2

## Install

### Claude Code

```sh
claude mcp add --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp -- uvx ipinfo-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "ipinfo-mcp-server"
      ],
      "env": {
        "IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ipinfo-mcp-server"
      ],
      "env": {
        "IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"uvx","args":["ipinfo-mcp-server"],"env":{"IPINFO_TOKEN":"<YOUR_IPINFO_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "ipinfo-mcp-server"
      ],
      "env": {
        "IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' -- uvx ipinfo-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "uvx"
args = ["ipinfo-mcp-server"]

[mcp_servers.mcp.env]
IPINFO_TOKEN = "<YOUR_IPINFO_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'IPINFO_TOKEN=<YOUR_IPINFO_TOKEN>' mcp uvx -- ipinfo-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "uvx",
      "args": [
        "ipinfo-mcp-server"
      ],
      "env": {
        "IPINFO_TOKEN": "<YOUR_IPINFO_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `IPINFO_TOKEN` | yes | yes | Your IPinfo API token. Get a free one at https://ipinfo.io/signup |
| `IPINFO_TRANSPORT` | no | no |  |

## Tools (14)

- `ipinfo_lookup`
- `ipinfo_geolocate`
- `ipinfo_asn`
- `ipinfo_check_privacy`
- `ipinfo_check_residential_proxy`
- `ipinfo_quota`
- `ipinfo_lite_lookup`
- `ips`
- `page`
- `page_size`
- `detailed`
- `results`
- `errors`
- `validation_errors`

## FAQ

### What kind of information can I get about an IP address?

You can find geolocation, network ownership (ASN), and metadata such as whether an IP is a VPN, proxy, Tor exit node, or residential proxy.

### Does the server support OAuth?

Yes, when using the hosted HTTP server, the first connection asks you to sign in with your IPinfo account through OAuth.

### Can I check if an IP is a residential proxy?

Yes, there is a specific tool called `ipinfo_check_residential_proxy` for residential proxy detection.