InternetData

io.github.internetdatav2.2.2Updated Oct 3, 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

Lets an assistant inspect InternetData's IP and ASN database catalog, license standing, metadata, checksums and download history.

What it does
The server exposes four read-only tools over InternetData's published IP and ASN databases: list_databases returns every database with your organization's license standing and license type and term; database_metadata returns columns, sample rows, row count, build date and file sizes; database_checksum returns published digests for a database file; and list_downloads returns recent download attempts, refusals included. It does not download database files.
When to use it
Use it when you need to know which InternetData databases your organization is licensed for, what a given database contains, how to verify a copy you already hold, or why a download attempt failed. It is a catalog and license-checking tool, not a way to fetch the multi-gigabyte data files themselves.
Requirements
Either the hosted endpoint at mcp.internetdata.io, signed in with an InternetData account, or a local npm package run with Node.js 22 or newer. The local option needs an API key with the db.download scope, supplied as INTERNETDATA_API_KEY; INTERNETDATA_BASE_URL can override the endpoint. Clients without MCP authorization can send a key as an Authorization Bearer header. Databases are licensed by contract, not self-serve.
Before you install
The local setup requires the secret INTERNETDATA_API_KEY, which carries the db.download scope; keep it out of shared configs and transcripts. All four tools are read-only, so nothing is written, sent or deleted, and no download tool exists. list_downloads exposes your organization's recent download attempts, including refusals and their HTTP status, so treat its output as organization-visible data.

Installation

In SourceWeft

  1. Open InternetData in the dashboard and add it to a workspace.
  2. 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.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mcp": {
      "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 rather than bought self-serve: 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 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",  "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 d1bc22b

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v2.2.2LatestOct 3, 2026