# InternetData

Lets an agent browse InternetData's IP and ASN databases: which ones your organization is licensed for, what a database holds, and its digests.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: internetdata
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/internetdata/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/internetdata

## What it does

InternetData ships databases covering IP addresses and AS numbers — geolocation, anonymity, ownership, network data — as gzipped CSV or MMDB. This server exposes four read-only tools: the full catalog with your organization's license standing, metadata for a single database, published digests, and your recent download history.

It is hosted at `https://mcp.internetdata.io/mcp` and you sign in with an InternetData account. Running it locally from npm needs Node.js 22 or newer plus an API key carrying the `db.download` scope. `INTERNETDATA_BASE_URL` points the server at a different endpoint. Without that scope on the key, the local setup will not work.

There is no download tool, and that is on purpose: published builds reach several gigabytes, too much to pull into a conversation. Use `database_metadata` to see what a transfer would cost, then move the bytes with the client libraries or the API. Watch the two id spellings — a license names the `base`, while `database_metadata` and `database_checksum` take `versions[].id`. Requests get refused when the two are mixed up.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.internetdata.io/mcp`
- Environment variables: `INTERNETDATA_API_KEY`, `INTERNETDATA_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.internetdata.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env INTERNETDATA_API_KEY=<INTERNETDATA_API_KEY> --env INTERNETDATA_BASE_URL=<INTERNETDATA_BASE_URL> --transport stdio internetdata -- npx -y internetdata-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add internetdata --url https://mcp.internetdata.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add internetdata --env INTERNETDATA_API_KEY=<INTERNETDATA_API_KEY> --env INTERNETDATA_BASE_URL=<INTERNETDATA_BASE_URL> -- npx -y internetdata-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "internetdata": {
            "url": "https://mcp.internetdata.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "internetdata": {
            "command": "npx",
            "args": [
                "-y",
                "internetdata-mcp"
            ],
            "env": {
                "INTERNETDATA_API_KEY": "<INTERNETDATA_API_KEY>",
                "INTERNETDATA_BASE_URL": "<INTERNETDATA_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "internetdata": {
            "type": "http",
            "url": "https://mcp.internetdata.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "internetdata": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "internetdata-mcp"
            ],
            "env": {
                "INTERNETDATA_API_KEY": "<INTERNETDATA_API_KEY>",
                "INTERNETDATA_BASE_URL": "<INTERNETDATA_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http internetdata https://mcp.internetdata.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e INTERNETDATA_API_KEY=<INTERNETDATA_API_KEY> -e INTERNETDATA_BASE_URL=<INTERNETDATA_BASE_URL> internetdata npx -y internetdata-mcp
```
Replace <…> with your own values

## When to use it
- check which InternetData databases your organization is licensed for
- see a database's row count and build date before downloading
- verify the digests of a copy you already have
- find out why a database download stopped working
- review recent download attempts, refusals included

## Example prompts
- List every InternetData database and our license standing for each
- What is inside `vpn_ip_v1` — columns, row count, file sizes?
- Show the digests for `tor_ip_v1` and our recent download attempts

## Similar
- [geofeed-tuner](https://affpapa.org/en/nevibecode/skills/geofeed-tuner.md) — skill · 1300 installs
- [mcp-ip2location-io](https://affpapa.org/en/nevibecode/mcp/mcp-ip2location-io.md) — MCP server · ★ 16
- [fastah-ip-geo-tools](https://affpapa.org/en/nevibecode/plugins/fastah-ip-geo-tools.md) — plugin · ★ 40451
- [database-architect](https://affpapa.org/en/nevibecode/agents/database-architect.md) — subagent · 12224 installs
- [indexion-segment](https://affpapa.org/en/nevibecode/skills/indexion-segment.md) — skill · 4900 installs
- [turbo-pipelines](https://affpapa.org/en/nevibecode/skills/turbo-pipelines.md) — skill · 3600 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md