InternetData

io.internetdataPublished by internetdata.ioOfficial publisherv3.1.11Updated Nov 7, 2026

List InternetData's IP and ASN databases, your license for each, what one holds, and its digests.

VerifiedStreamable HTTPWeb executableDatabasesData & Analytics

Overview

AI-generated overview

Read-only MCP access to InternetData's IP and ASN database catalog: license standing, contents, checksums and download history.

What you can do
  • List every published IP and ASN database with your organization's license standing and license type and term
  • Inspect one database's columns, sample rows, row count, build date and file sizes
  • Fetch the published digests for a database file to verify a copy you already hold
  • Review your organization's recent download attempts, refusals included
When to use it
Useful when you work with InternetData geolocation, anonymity, ownership or network data and want an assistant to check which databases your organization is licensed for, what a database contains, or whether a local copy matches the published checksums.
Requirements
Remote endpoint with sign-in through an InternetData account, or a local npm package run with npx that needs Node.js 22 or newer and an API key with the db.download scope in INTERNETDATA_API_KEY. INTERNETDATA_BASE_URL can override the endpoint.
Before you install
The local package requires an API key, which is passed as INTERNETDATA_API_KEY; the hosted endpoint signs in with your account instead. Databases are licensed by contract, and most are not free, so check standing before relying on one. All tools are read-only and there is deliberately no download tool.

Installation

In SourceWeft

  1. Open InternetData in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.internetdata%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "internetdata": {
      "type": "http",
      "url": "https://mcp.internetdata.io/mcp"
    }
  }
}

README

[InternetData] InternetData MCP Server

[npm] [license]

The official Model Context Protocol server for the InternetData API.

InternetData publishes IP and ASN databases: geolocation, anonymity, ownership and network data, as gzipped CSV and as MMDB. This server gives an AI agent four read-only tools over them - every database we publish and where your organization's license for each one stands, what is inside one, the digests to verify a copy you already hold, and your recent download history.

Getting Started

We host it at https://mcp.internetdata.io/mcp, and you sign in to it with your InternetData account. It also runs on your own machine from npm. Either way it sees where your organization's license for each database stands. Databases are licensed by contract. The Open ones, tor_ip_v1 among them, are licensed to every organization from the start and are free under CC BY-SA 4.0. For the rest, see the API documentation, or request an evaluation if your organization doesn't have a license yet.

In Claude

In claude.ai, the desktop app or Cowork, add https://mcp.internetdata.io/mcp as a custom connector and choose Use Claude's published identity when asked. In Claude Code, install our plugin, which adds the server with skills:

console
/plugin marketplace add internetdata/claude-plugin/plugin install internetdata@internetdata

Either way you sign in with your InternetData account, and Claude never sees your API key. The steps, the skills and how to disconnect: docs.internetdata.io/integrations/claude.

In ChatGPT and Codex

InternetData is in the plugin directory ChatGPT and Codex share: add it from its listing. Codex also installs our plugin from the command line, which adds the server with skills:

console
codex plugin marketplace add internetdata/openai-plugincodex plugin add internetdata@internetdatacodex mcp login internetdata

Either way you sign in with your InternetData account, and neither sees your API key. The steps: docs.internetdata.io/integrations/chatgpt and docs.internetdata.io/integrations/codex. On the OpenAI API, the Responses API's mcp tool takes the server as its server_url and your key as its authorization.

In any other MCP client

Point it at https://mcp.internetdata.io/mcp. A client that supports MCP authorization signs in the same way. One that doesn't can send a key instead, as Authorization: Bearer your-key.

On your own machine

You need an API key carrying the db.download scope. Add this to your MCP client's config:

json
{  "mcpServers": {    "internetdata": {      "command": "npx",      "args": ["-y", "internetdata-mcp"],      "env": { "INTERNETDATA_API_KEY": "your-key" }    }  }}

Requires Node.js 22 or newer. INTERNETDATA_BASE_URL overrides the endpoint if you need to point somewhere else.

Tools

ToolWhat it answers
list_databasesEvery database we publish, with its standing for your organization (licensed, expired or unlicensed) and the type and term of any license.
database_metadataA database's columns, sample rows, row count, build date and file sizes.
database_checksumThe published digests for one database file.
list_downloadsYour organization's recent download attempts, refusals included.

Every tool is read-only.

Two spellings of a database ID

list_databases answers a base ID and a versions array:

json
{  "base": "vpn_ip",  "standing": "licensed",  "open": false,  "versions": [{ "id": "vpn_ip_v1", "version": 1, "formats": ["csvgz", "mmdb"] }]}

The base is what a license names. versions[].id is what a download names, and it is the one database_metadata and database_checksum accept. The tools say so in their own descriptions, so an agent generally gets this right on its own; it is worth knowing when you read a transcript where one was refused.

There is no download tool, deliberately

The published builds run to several GB, which is not something an agent should pull into a conversation. database_metadata is how you find out what a transfer would cost, and the client libraries or the API are how you actually move the bytes.

Reading the download history

list_downloads is a bounded window - at most 200 attempts, newest first - and it lists refusals alongside successes, because a denial and its http_status are what answer "it stopped working". A database missing from the answer means it is not in that window, never that it was never fetched.

Other Libraries

There are official InternetData client libraries available for many languages including PHP, Python, Go, Java, and Ruby. See our GitHub at https://github.com/internetdata for more.

About InternetData

Geolocation, anonymity, ownership and network databases for IP addresses and AS numbers, licensed as files you download and query yourself.

[InternetData]

License

This project is licensed under the MIT License.

Source: README.md at commit 8c1c17b

Tools

4

list_databases

List databases

The IP database catalog as this API key's organization may see it, one entry per database FAMILY, with `standing` saying where their license stands: `licensed` if the family is theirs today, `expired` if the term has ended, `unlicensed` if it is published but has never been bought. Each entry has a `base` ID, which is what a license names, and a `versions` array whose `id` is what the other tools take - pass `versions[].id` (`bogon_ip_v1`), never the `base` (`bogon_ip`). Ask again rather than holding on to this: it is answered per key and is not the same for everyone.

Takes no parameters.

database_metadata

Describe a database

What is inside one database before you fetch it: the columns in each published format with their types, a few sample rows, the row count, the build date and the file sizes. Use this to answer questions about what a database contains without downloading it - the files reach several GB - and to budget a transfer before starting one.

Parametersdataset_idrequired

database_checksum

Get a database's checksums

The published digests for one database file, for verifying a copy you already hold or deciding whether a build has changed since you last fetched it. It is licensed like the download itself, so a database this key cannot download is refused here too. Looking up a checksum is not a download and does not appear in `list_downloads`.

Parametersformatrequireddataset_idrequired

list_downloads

List recent download attempts

This organization's own recent download attempts, newest first, REFUSALS INCLUDED - a denial carries the `outcome` and `http_status` that answer "it stopped working", which nothing else here can. Use it to explain a failing fetch, to confirm a transfer ran, or to check whether a request was theirs. This is a bounded WINDOW of at most 200 rows, so a database missing from the answer means it is not in this window - never that it was never downloaded.

Parameterslimit

Version history

4
  1. v3.1.11LatestNov 7, 2026
  2. v3.1.10Nov 3, 2026
  3. v3.1.7Oct 21, 2026
  4. v3.1.6Oct 19, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Internetdata integrations

InternetData

Published by GitHub account internetdata

Read-only MCP access to InternetData's IP and ASN database catalog: license standing, metadata, checksums and download history.

Streamable HTTPWeb executable
DatabasesNot indexed yetOct 17, 2026