InternetData logo

InternetData

Inspect InternetData IP and ASN databases, license status, metadata, checksums, and recent download attempts through MCP.

Install InternetData

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "internetdata": {
      "command": "npx",
      "args": [
        "-y",
        "internetdata-mcp"
      ],
      "env": {
        "INTERNETDATA_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

InternetData MCP server exposes read-only access to the InternetData API's IP and ASN database catalog. Agents can inspect organization-specific license standing, database contents and sizes, file checksums, and recent download attempts, including refusals. Use the hosted streamable HTTP endpoint or run the npm package locally when an agent needs database information without transferring multi-gigabyte files.

Use cases

  • List database families and verify an organization's license standing
  • Inspect columns, sample rows, row counts, and file sizes before downloading
  • Check published digests against a locally held database copy
  • Diagnose refused or unsuccessful database download attempts
  • Identify database versions and supported file formats

Key features

  • Organization-specific database catalog and license status
  • Metadata inspection without downloading multi-gigabyte files
  • Published checksum lookup for database verification
  • Recent download history with refusals and HTTP statuses
  • Hosted streamable HTTP and local npm deployment
  • Read-only MCP tools

Tools4

What InternetData lets your agent do. Expand a tool for its parameters.

Verified live~686 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 21d

What it can do

From the 4 tools this server returned when we ran it; 4 declare their own safety hints.

Handles credentials · 1Makes network requests · 4Read-only tools · 4
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age47 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · internetdata-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads2.6kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How InternetData works

What InternetData MCP server does

InternetData MCP server provides read-only inspection of InternetData's IP and ASN databases. The catalog covers geolocation, anonymity, ownership, and network data published as gzipped CSV and MMDB files. Its tools help an agent determine which database families exist, whether an organization's license is active, what a build contains, whether a local copy still matches a published digest, and what happened during recent download attempts.

The server deliberately does not download database files. Published builds can be several gigabytes, so agents can use the metadata and checksum operations for planning and verification while using InternetData's API or client libraries to transfer the actual data.

How it works

InternetData can be reached at https://mcp.internetdata.io/mcp using an MCP client that supports authorization. It can also run locally through the internetdata-mcp npm package with Node.js 22 or newer. In both modes, results reflect the InternetData account or API key used for the connection, including that organization's licensing status.

The database catalog uses two identifiers. A database family has a base identifier, which is used in licensing information. Its version entries provide IDs such as vpn_ip_v1; those version IDs are required by database_metadata and database_checksum. Agents should query list_databases before using the other database-specific tools because the available versions and license standing are account-dependent.

Setup and configuration

For a local installation, configure an MCP client to run npx -y internetdata-mcp and provide an InternetData API key through INTERNETDATA_API_KEY. The key needs the db.download scope. INTERNETDATA_BASE_URL can replace the default API endpoint when a different endpoint is required.

The hosted endpoint supports sign-in through an MCP client's authorization flow. Clients without MCP authorization can send the key as a bearer token. Claude, ChatGPT, and Codex integrations provide account-based sign-in paths that keep the API key out of the client workflow described for those integrations.

Open databases, including tor_ip_v1, are available to every organization and are free under CC BY-SA 4.0. Other databases are governed by contractual licensing.

Tools and capabilities

  • list_databases returns the database families visible to the organization, their license standing, license details, and available version and format information.
  • database_metadata reports columns and types, sample rows, row count, build date, and file sizes before a transfer is planned.
  • database_checksum returns published digests for a database file so an existing copy can be checked or a build change detected. Access follows the same licensing rules as the database download.
  • list_downloads shows up to 200 recent organizational download attempts in newest-first order. Successful transfers and refusals are included, with refusal outcomes and HTTP status codes.

All four tools are read-only. A missing database in the download-history response only means it falls outside the returned window; it is not evidence that the database was never downloaded.

Limitations and notes

The server is intended for catalog, inspection, verification, and download-history questions rather than moving database contents into an agent conversation. It does not expose a download tool. Database access depends on the credentials and licensing attached to the requesting organization, and checksum lookups are also refused when that organization cannot download the corresponding database.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about InternetData

InternetData is an MCP server that connects AI clients to the InternetData API for IP and ASN databases. Its main tools list databases and license status, inspect metadata, retrieve file checksums, and review recent download attempts. All operations are read-only, and the server does not download database files into agent conversations.

Install it through an MCP client's local server configuration with `npx -y internetdata-mcp`. Set `INTERNETDATA_API_KEY` to an API key with the `db.download` scope, and use Node.js 22 or newer. You can instead connect to `https://mcp.internetdata.io/mcp` through a client that supports MCP authorization.

Yes, InternetData works with Cursor when configured as an MCP server. Use the hosted endpoint `https://mcp.internetdata.io/mcp` if Cursor supports the required authorization flow, or run the npm server locally and provide `INTERNETDATA_API_KEY` as an environment variable.

No, InternetData does not provide a download tool through MCP. Use `database_metadata` to estimate file sizes and inspect contents before transferring data through the InternetData API or an official client library.

Use `list_downloads` to inspect recent attempts, including refusals, outcomes, and HTTP status codes. The response is limited to the 200 newest attempts, so an older transfer may not appear. Check `list_databases` separately for the organization's current license standing.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInternetData AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/internetdata?style=directory)](https://allmcps.com/mcp/internetdata)
HTML Embed
<a href="https://allmcps.com/mcp/internetdata"><img src="https://allmcps.com/api/badge/internetdata?style=directory" alt="InternetData on AllMCPs" /></a>