# IPGeolocation.io MCP server

> Look up IP geolocation, security signals, ASN data, abuse contacts, time zones, astronomy and user-agent details.

- Listing: https://mcp.tc/i/ipgeolocation-io
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: API key
- Category: [Utilities](https://mcp.tc/c/utilities)
- Vendor: IPGeolocation.io
- Homepage: <https://ipgeolocation.io/integrations/ipgeolocation-io-mcp>
- Docs: <https://ipgeolocation.io/integrations/ipgeolocation-io-mcp>
- Repository: <https://github.com/IPGeolocation/ipgeolocation-io-mcp>
- Package: npm `ipgeolocation-io-mcp`

## About

Connects an assistant to the IPGeolocation.io APIs. It covers IP geolocation, company and ASN ownership, network and BGP data, VPN, proxy and Tor detection, abuse contacts, currency data, time zones, astronomy and user-agent parsing. Bulk tools accept up to 250 inputs per request by default.

Runs locally over stdio with npx (Node.js 22 or later). It needs an IPGeolocation.io API key in IPGEOLOCATION\_API\_KEY; free and paid keys work, and available endpoints depend on the plan. Only get\_my\_ip works without a key.

## What it can do

- Geolocate single or bulk IPv4 and IPv6 addresses
- Detect VPN, proxy, Tor and bot traffic with threat scores
- Look up ASN details, company ownership and BGP network data
- Find abuse contact details for an IP
- Get time zones, convert times and read astronomy data
- Parse user-agent strings into device, browser and OS
- Replay cached result pages without extra API credits

## Tools (17)

- `lookup_ip`: Geolocation for a public IPv4/IPv6 address; domain lookup needs a paid plan
- `bulk_lookup_ip`: Bulk IP geolocation, up to 250 inputs per request by default
- `get_my_ip`: Returns the public egress IP of the machine running the server
- `lookup_company`: Company details and ASN ownership for an IP
- `lookup_currency`: Currency and country metadata for an IP address
- `lookup_network`: BGP route prefix, connection type and anycast indicator
- `check_security`: VPN, proxy, Tor, bot flags and threat scores for an IP
- `bulk_security_check`: Bulk security check, up to 250 inputs per request by default
- `get_timezone`: Timezone lookup by IANA name, coordinates, IP or airport code
- `convert_timezone`: Convert time between two locations
- `get_astronomy`: Sunrise, sunset, moonrise, moonset, twilight and moon phases
- `get_astronomy_time_series`: Daily astronomy data for a date range up to 90 days
- `parse_user_agent`: Parse a user-agent string into device, browser and OS details
- `bulk_parse_user_agent`: Bulk parse up to 250 user-agent strings per request by default
- `lookup_asn`: ASN details with optional peers, upstreams, downstreams, routes and WHOIS
- `get_abuse_contact`: Abuse contact email, phone and address for a public IP
- `get_cached_result`: Read or replay a cached JSON page without an API call or credits

## Example prompts

- "Where is 8.8.8.8 located?"
- "Check whether 203.0.113.5 is a VPN or proxy"
- "Who is the abuse contact for 1.1.1.1?"
- "What time is sunrise in Berlin for the next week?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio ipgeolocation-io --env "IPGEOLOCATION_API_KEY=<YOUR_IPGEOLOCATION_API_KEY>" -- npx -y ipgeolocation-io-mcp
```

2. Start Claude Code and type `/mcp`. **ipgeolocation-io** should show as connected.

Add `--scope user` to make it available in every project. Replace the placeholders with your own values.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ipgeolocation-io": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

2. Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=ipgeolocation-io&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImlwZ2VvbG9jYXRpb24taW8tbWNwIl0sImVudiI6eyJJUEdFT0xPQ0FUSU9OX0FQSV9LRVkiOiI8WU9VUl9JUEdFT0xPQ0FUSU9OX0FQSV9LRVk%2BIn19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "ipgeolocation-io": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

Needs Node.js on your computer. Replace the placeholders with your own values.

### VS Code

Add it to `.vscode/mcp.json`. VS Code asks for the secret the first time and stores it securely:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "ipgeolocation-io": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "${input:ipgeolocation-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "ipgeolocation-api-key",
      "description": "IPGEOLOCATION_API_KEY",
      "password": true
    }
  ]
}
```

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "ipgeolocation-io": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

2. Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add ipgeolocation-io --env "IPGEOLOCATION_API_KEY=<YOUR_IPGEOLOCATION_API_KEY>" -- npx -y ipgeolocation-io-mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.ipgeolocation-io]
command = "npx"
args = ["-y", "ipgeolocation-io-mcp"]
env = { IPGEOLOCATION_API_KEY = "<YOUR_IPGEOLOCATION_API_KEY>" }
```

Needs Node.js on your computer. Replace the placeholders with your own values.

### Gemini CLI

```bash
gemini mcp add -e "IPGEOLOCATION_API_KEY=<YOUR_IPGEOLOCATION_API_KEY>" ipgeolocation-io npx -- -y ipgeolocation-io-mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "ipgeolocation-io": {
      "command": "npx",
      "args": [
        "-y",
        "ipgeolocation-io-mcp"
      ],
      "env": {
        "IPGEOLOCATION_API_KEY": "<YOUR_IPGEOLOCATION_API_KEY>"
      }
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer. Replace the placeholders with your own values.

## Recent changes

- 2026-11-05 11:28 UTC: New version 2.0.3 (was 2.0.2), read from npm. Source: automatic check.
- 2026-10-27 20:45 UTC: New version 2.0.2 (was 2.0.1), read from npm. Source: automatic check.
- 2026-10-25 05:24 UTC: Tracking started: 17 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/ipgeolocation-io#history (Atom feed: https://mcp.tc/i/ipgeolocation-io/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 2.0.3
- Last checked: 2026-10-25
- Listed: 2026-10-25
- Updated: 2026-10-25

---
Source: https://mcp.tc/i/ipgeolocation-io (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
