internetdata-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mslm Dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# [<img src="https://s3.internetdata.io/internetdata-public/brand/mark.svg" alt="InternetData" height="28"/>](https://internetdata.io/) InternetData MCP Server
+
+[![npm](https://img.shields.io/npm/v/internetdata-mcp.svg)](https://www.npmjs.com/package/internetdata-mcp)
+[![license](https://img.shields.io/npm/l/internetdata-mcp.svg)](LICENSE)
+
+The official [Model Context Protocol](https://modelcontextprotocol.io) server for the [InternetData](https://internetdata.io) API.
+
+InternetData publishes IP databases: VPN and proxy address space, hosting and CDN ranges, provider catalogs, bogons and more, as gzipped CSV and as MMDB. This server gives an AI agent four read-only tools over them - which databases your organization is licensed for, what is inside one, the digests to verify a copy you already hold, and your recent download history.
+
+## Getting Started
+
+You need an API key carrying the `db.download` scope. Databases are licensed by contract rather than bought self-serve, so a key arrives with the licence; see the [API documentation](https://docs.internetdata.io/api) or write to [dev@internetdata.io](mailto:dev@internetdata.io).
+
+Add this to your MCP client's config:
+
+```json
+{
+  "mcpServers": {
+    "internetdata": {
+      "command": "npx",
+      "args": ["-y", "internetdata-mcp"],
+      "env": { "INTERNETDATA_API_KEY": "your-key" }
+    }
+  }
+}
+```
+
+Then ask it something like *"which IP databases are we licensed for, and how big is the latest VPN build?"*.
+
+Requires Node.js 22 or newer. `INTERNETDATA_BASE_URL` overrides the endpoint if you need to point somewhere else.
+
+## Tools
+
+| Tool | What it answers |
+|---|---|
+| `list_databases` | The databases your organization is licensed for, with the licence type and term. |
+| `database_metadata` | A database's columns, sample rows, row count, build date and file sizes. |
+| `database_checksum` | The published digests for one database file. |
+| `list_downloads` | Your 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 **licence** 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](https://github.com/internetdata) 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, Ruby, and many popular frameworks such as Django, Rails, and Laravel. See our GitHub at https://github.com/internetdata for more.
+
+## About InternetData
+
+IP intelligence databases: VPN, proxy, hosting, CDN and relay address space, provider catalogs and network metadata, published as CSV and MMDB.
+
+[<img src="https://s3.internetdata.io/internetdata-public/brand/mark.svg" alt="InternetData" width="96"/>](https://internetdata.io/)
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createTools, registerTools, DOWNLOADS_LIMIT } from './tools.js';
+export type { ToolContext, ToolDef } from './tools.js';
+export { SPEC_VERSION } from './schema.gen.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createTools, registerTools, DOWNLOADS_LIMIT } from './tools.js';
+export { SPEC_VERSION } from './schema.gen.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/schema.gen.d.ts

@@ -0,0 +1,11 @@
+export declare const SPEC_VERSION = "2026.09.09";
+export interface ObjectSchema {
+    type: 'object';
+    properties?: Record<string, object>;
+    required?: string[];
+    [k: string]: unknown;
+}
+export declare const DATABASE_SCHEMA: ObjectSchema;
+export declare const DATABASE_METADATA_SCHEMA: ObjectSchema;
+export declare const DB_CHECKSUMS_SCHEMA: ObjectSchema;
+export declare const DOWNLOAD_SCHEMA: ObjectSchema;

package/dist/schema.gen.js

@@ -0,0 +1,272 @@
+// Code generated by scripts/gen-schema.mjs from spec/openapi.json. DO NOT EDIT.
+export const SPEC_VERSION = '2026.09.09';
+export const DATABASE_SCHEMA = {
+    "type": "object",
+    "description": "One database FAMILY, with your organization's licence beside it. A\nlicence covers the family, while a download names a specific version,\nso the ids passed to `download` and `checksum` come from `versions`.\n",
+    "required": [
+        "base",
+        "name",
+        "summary",
+        "standing",
+        "license_type",
+        "starts",
+        "expires",
+        "renews_at",
+        "notice_due_at",
+        "versions"
+    ],
+    "properties": {
+        "base": {
+            "type": "string",
+            "description": "The family, e.g. `vpn_ip`. What a licence is held against."
+        },
+        "name": {
+            "type": "string"
+        },
+        "summary": {
+            "type": "string",
+            "description": "One line on what the newest version contains."
+        },
+        "standing": {
+            "type": "string",
+            "enum": [
+                "licensed",
+                "expired",
+                "unlicensed"
+            ],
+            "description": "`licensed` is a live grant, `expired` one whose term has ended, and\n`unlicensed` a database published but never bought.\n"
+        },
+        "license_type": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+                "evaluation",
+                "standard",
+                "redistribute",
+                null
+            ],
+            "description": "What your licence permits you to do with the data. Null when there\nis no licence.\n"
+        },
+        "starts": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+        },
+        "expires": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "A hard stop. Null when the licence has no end date, which is the normal case for a rolling agreement, and when there is no licence. A rolling licence reports its turnover date in renews_at instead."
+        },
+        "renews_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When a rolling licence next renews. Null when the licence has no defined term, when expires sets a hard stop instead, and when there is no licence."
+        },
+        "notice_due_at": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "The last day notice of non-renewal can be given for the term ending at renews_at. Null whenever renews_at is, and when the agreement records no notice period."
+        },
+        "versions": {
+            "type": "array",
+            "description": "Every published version of this family, oldest first. Old versions\nare frozen rather than migrated, so both stay downloadable.\n",
+            "items": {
+                "type": "object",
+                "required": [
+                    "id",
+                    "version",
+                    "summary",
+                    "formats"
+                ],
+                "properties": {
+                    "id": {
+                        "type": "string",
+                        "description": "The versioned id. Pass this to `download`, `checksum` and `metadata`."
+                    },
+                    "version": {
+                        "type": "integer"
+                    },
+                    "summary": {
+                        "type": "string"
+                    },
+                    "formats": {
+                        "type": "array",
+                        "description": "The formats this version is BUILT in. Asking for another is a 400,\nnot a gap - the `_provider` catalogs are keyed by provider id, so no\nMMDB exists for them.\n",
+                        "items": {
+                            "type": "string",
+                            "enum": [
+                                "csvgz",
+                                "mmdb"
+                            ]
+                        }
+                    }
+                }
+            }
+        }
+    }
+};
+export const DATABASE_METADATA_SCHEMA = {
+    "type": "object",
+    "description": "The build document written by the exporter, served through unchanged.",
+    "required": [
+        "id",
+        "updated",
+        "entries",
+        "schema",
+        "size"
+    ],
+    "properties": {
+        "id": {
+            "type": "string"
+        },
+        "update_freq": {
+            "type": "string",
+            "description": "How often a new build is published."
+        },
+        "updated": {
+            "type": "string",
+            "format": "date",
+            "description": "ISO-8601 date (YYYY-MM-DD) the published build was generated on."
+        },
+        "entries": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Row count in the current build."
+        },
+        "schema": {
+            "type": "object",
+            "description": "Columns, keyed by format.",
+            "additionalProperties": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "required": [
+                        "name",
+                        "type"
+                    ],
+                    "properties": {
+                        "name": {
+                            "type": "string"
+                        },
+                        "type": {
+                            "type": "string"
+                        },
+                        "description": {
+                            "type": "string"
+                        }
+                    }
+                }
+            }
+        },
+        "sample": {
+            "type": "object",
+            "description": "A few real rows, keyed by format.",
+            "additionalProperties": {
+                "type": "array",
+                "items": {
+                    "type": "object"
+                }
+            }
+        },
+        "size": {
+            "type": "object",
+            "description": "Bytes per format.",
+            "additionalProperties": {
+                "type": "integer",
+                "format": "int64"
+            }
+        }
+    }
+};
+export const DB_CHECKSUMS_SCHEMA = {
+    "type": "object",
+    "required": [
+        "md5",
+        "sha1",
+        "sha256",
+        "sha512"
+    ],
+    "properties": {
+        "md5": {
+            "type": "string",
+            "description": "Hex-encoded MD5 digest."
+        },
+        "sha1": {
+            "type": "string",
+            "description": "Hex-encoded SHA-1 digest."
+        },
+        "sha256": {
+            "type": "string",
+            "description": "Hex-encoded SHA-256 digest."
+        },
+        "sha512": {
+            "type": "string",
+            "description": "Hex-encoded SHA-512 digest."
+        }
+    }
+};
+export const DOWNLOAD_SCHEMA = {
+    "type": "object",
+    "description": "One download ATTEMPT, refusals included.",
+    "required": [
+        "dataset_id",
+        "format",
+        "outcome",
+        "bytes",
+        "http_status",
+        "apikey_id",
+        "client_ip",
+        "user_agent",
+        "created"
+    ],
+    "properties": {
+        "dataset_id": {
+            "type": "string"
+        },
+        "format": {
+            "type": "string"
+        },
+        "outcome": {
+            "type": "string",
+            "enum": [
+                "ok",
+                "unauthorized",
+                "denied",
+                "expired",
+                "unknown",
+                "unavailable"
+            ]
+        },
+        "bytes": {
+            "type": "integer",
+            "format": "int64",
+            "nullable": true,
+            "description": "Object size at redirect time, NOT bytes delivered: the transfer is a\npresigned redirect straight to object storage, so we never observe\nhow much of it was taken.\n"
+        },
+        "http_status": {
+            "type": "integer",
+            "nullable": true
+        },
+        "apikey_id": {
+            "type": "string",
+            "nullable": true,
+            "description": "The key that made the request. Null when it could not be resolved."
+        },
+        "client_ip": {
+            "type": "string",
+            "nullable": true
+        },
+        "user_agent": {
+            "type": "string",
+            "nullable": true
+        },
+        "created": {
+            "type": "string",
+            "format": "date-time"
+        }
+    }
+};
+//# sourceMappingURL=schema.gen.js.map

package/dist/schema.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.gen.js","sourceRoot":"","sources":["../src/schema.gen.ts"],"names":[],"mappings":"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"}

package/dist/stdio.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/stdio.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+// The stdio entry point: the process an MCP client spawns.
+//
+// This is the one file that reads the environment. The MCP specification tells
+// stdio servers to take credentials that way rather than through the protocol's
+// OAuth profile, and everything below it takes its configuration as arguments.
+import { createRequire } from 'node:module';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { InternetData } from '@internetdata/internetdata';
+import { createTools, registerTools } from './tools.js';
+const version = createRequire(import.meta.url)('../package.json').version;
+async function main() {
+    const apiKey = process.env['INTERNETDATA_API_KEY'];
+    const client = new InternetData({
+        ...(apiKey === undefined || apiKey === '' ? {} : { apiKey: apiKey }),
+        ...(process.env['INTERNETDATA_BASE_URL'] === undefined
+            ? {} : { baseUrl: process.env['INTERNETDATA_BASE_URL'] }),
+    });
+    const server = new Server({ name: 'internetdata', version: version }, { capabilities: { tools: {} } });
+    registerTools(server, createTools({ client: client }));
+    await server.connect(new StdioServerTransport());
+}
+main().catch((err) => {
+    // stdout carries the protocol, so a diagnostic can only go to stderr.
+    console.error(err);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AAEA,2DAA2D;AAC3D,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAiB,CAAC;AAEpF,KAAK,UAAU,IAAI;IACf,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC5B,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,KAAK,SAAS;YAClD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,EAAE,CAAC;KAChE,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CACrB,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,EAC1C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAClC,CAAC;IACF,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAEvD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1B,sEAAsE;IACtE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,21 @@
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { InternetData } from '@internetdata/internetdata';
+/** The most history rows one `list_downloads` call may ask for. The API clamps to the same. */
+export declare const DOWNLOADS_LIMIT = 200;
+export interface ToolContext {
+    client: InternetData;
+}
+export interface ToolDef {
+    tool: Tool;
+    handler: (args: Record<string, unknown>) => Promise<CallToolResult>;
+}
+/**
+ * The tool manifest, and the single place either transport gets it from.
+ *
+ * Descriptions are read by a model rather than a developer, so they say what
+ * the tool answers and what it costs, not how it is implemented.
+ */
+export declare function createTools(ctx: ToolContext): ToolDef[];
+/** Mounts a manifest on a server. Both transports use this and nothing else. */
+export declare function registerTools(server: Server, defs: ToolDef[]): void;

package/dist/tools.js

@@ -0,0 +1,232 @@
+import { z } from 'zod';
+import { DATASET_FORMATS } from '@internetdata/internetdata';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { DATABASE_METADATA_SCHEMA, DATABASE_SCHEMA, DB_CHECKSUMS_SCHEMA, DOWNLOAD_SCHEMA, } from './schema.gen.js';
+/** The most history rows one `list_downloads` call may ask for. The API clamps to the same. */
+export const DOWNLOADS_LIMIT = 200;
+// The formats come from the SDK's own exported vocabulary rather than a literal
+// here. It is typed by the union generated from the spec, so a format this
+// package spells wrong does not compile, and one the API adds arrives with a
+// version bump instead of a silent divergence. The tuple cast is about z.enum
+// wanting a non-empty tuple, not a claim about the wire.
+const FORMATS = z.enum([...DATASET_FORMATS]);
+// Both spellings of a dataset id, stated wherever one is taken. `list_databases`
+// answers a `base` id (what a licence names) and a `versions[].id`; everything
+// else accepts only the versioned one. A model that has just read
+// `base: "bogon_ip"` will otherwise pass it and get a refusal that reads like a
+// bad dataset rather than a wrong spelling.
+const VERSIONED_ID = 'A VERSIONED database id, from `versions[].id` in `list_databases` - '
+    + '`bogon_ip_v1`, not `bogon_ip`. The unversioned base id is a licence reference and is '
+    + 'not accepted here.';
+/**
+ * The tool manifest, and the single place either transport gets it from.
+ *
+ * Descriptions are read by a model rather than a developer, so they say what
+ * the tool answers and what it costs, not how it is implemented.
+ */
+export function createTools(ctx) {
+    const defs = [
+        {
+            tool: {
+                name: 'list_databases',
+                title: 'List databases',
+                description: 'The IP database catalog as this API key\'s organization may see it, '
+                    + 'one entry per database FAMILY, with `standing` saying where their licence '
+                    + '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 licence 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.',
+                inputSchema: { type: 'object', additionalProperties: false },
+                outputSchema: objectSchema({
+                    databases: { type: 'array', items: DATABASE_SCHEMA },
+                }, ['databases']),
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: true,
+                    openWorldHint: true,
+                },
+            },
+            handler: async () => {
+                return ok({ databases: await ctx.client.database.list() });
+            },
+        },
+        {
+            tool: {
+                name: 'database_metadata',
+                title: 'Describe a database',
+                description: '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.',
+                inputSchema: jsonSchema(z.object({
+                    dataset_id: z.string().describe(VERSIONED_ID),
+                })),
+                outputSchema: DATABASE_METADATA_SCHEMA,
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: true,
+                    openWorldHint: true,
+                },
+            },
+            handler: async (args) => {
+                const { dataset_id } = z.object({ dataset_id: z.string() }).parse(args);
+                return ok(await ctx.client.database.metadata(dataset_id));
+            },
+        },
+        {
+            tool: {
+                name: 'database_checksum',
+                title: 'Get a database\'s checksums',
+                description: '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.',
+                inputSchema: jsonSchema(z.object({
+                    dataset_id: z.string().describe(VERSIONED_ID),
+                    format: FORMATS.describe('Which published file to digest.'),
+                })),
+                outputSchema: objectSchema({ checksums: DB_CHECKSUMS_SCHEMA }, ['checksums']),
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: true,
+                    openWorldHint: true,
+                },
+            },
+            handler: async (args) => {
+                const parsed = z.object({
+                    dataset_id: z.string(),
+                    format: FORMATS,
+                }).parse(args);
+                const checksums = await ctx.client.database.checksums(parsed.dataset_id, parsed.format);
+                return ok({ checksums: checksums });
+            },
+        },
+        {
+            tool: {
+                name: 'list_downloads',
+                title: 'List recent download attempts',
+                description: '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 '
+                    + `${DOWNLOADS_LIMIT} rows, so a database missing from the answer means it is `
+                    + 'not in this window - never that it was never downloaded.',
+                inputSchema: jsonSchema(z.object({
+                    limit: z.number().int().min(1).max(DOWNLOADS_LIMIT).optional().describe(`How many attempts to return, newest first. At most ${DOWNLOADS_LIMIT}; `
+                        + 'the API defaults to 50.'),
+                })),
+                outputSchema: objectSchema({
+                    downloads: { type: 'array', items: DOWNLOAD_SCHEMA },
+                }, ['downloads']),
+                annotations: {
+                    readOnlyHint: true,
+                    idempotentHint: false,
+                    openWorldHint: true,
+                },
+            },
+            handler: async (args) => {
+                const { limit } = z.object({
+                    limit: z.number().int().min(1).max(DOWNLOADS_LIMIT).optional(),
+                }).parse(args);
+                const downloads = await ctx.client.database.downloads(limit === undefined ? {} : { limit: limit });
+                return ok({ downloads: downloads });
+            },
+        },
+    ];
+    // A handler NEVER throws: an upstream 404 or a rejected argument is a result
+    // the model can read and correct itself from, while a JSON-RPC protocol error
+    // is not. Wrapping here rather than in `registerTools` keeps that true for
+    // any consumer of a ToolDef, including a transport that mounts its own.
+    return defs.map((d) => ({ tool: d.tool, handler: guard(d.handler) }));
+}
+/** Mounts a manifest on a server. Both transports use this and nothing else. */
+export function registerTools(server, defs) {
+    const byName = new Map(defs.map((d) => [d.tool.name, d]));
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: defs.map((d) => d.tool) };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const def = byName.get(req.params.name);
+        if (def === undefined) {
+            throw new Error(`Unknown tool: ${req.params.name}`);
+        }
+        return await def.handler(req.params.arguments ?? {});
+    });
+}
+function guard(handler) {
+    return async (args) => {
+        try {
+            return await handler(args);
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    };
+}
+/**
+ * The serialized structured content IS the text block, rather than a prose
+ * summary beside it. Writing it once puts the same answer in front of a client
+ * that reads `structuredContent` and one that only renders `content`.
+ */
+function ok(structured) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }],
+        structuredContent: structured,
+    };
+}
+/**
+ * An error carries no `structuredContent`, deliberately.
+ *
+ * A tool that declares an `outputSchema` has every structured result validated
+ * against it by the client, and an error is not shaped like a success - so
+ * attaching one turns a readable failure into a protocol error the model cannot
+ * act on. The text block is what it reads instead.
+ */
+function toolError(err) {
+    const known = asClientError(err);
+    const detail = known !== undefined
+        ? { kind: known.kind, message: known.message, retryable: known.retryable === true }
+        : { kind: 'internal', message: err instanceof Error ? err.message : String(err) };
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: detail }, null, 2) }],
+        isError: true,
+    };
+}
+/**
+ * Recognises an `InternetDataError` by SHAPE, not by `instanceof`.
+ *
+ * This package and whatever mounts it can each end up with their own copy of
+ * the `@internetdata/internetdata` module - the hosted service depends on both -
+ * and two copies of one class are two identities, so `instanceof` silently
+ * returns false and every upstream failure degrades to a generic `internal`. A
+ * caller then sees "internal" for what was really `forbidden`, and loses the
+ * `retryable` flag that decides whether trying again is worth anything.
+ */
+function asClientError(err) {
+    if (err === null || typeof err !== 'object') {
+        return undefined;
+    }
+    const e = err;
+    if (e.name !== 'InternetDataError' || typeof e.kind !== 'string') {
+        return undefined;
+    }
+    return e;
+}
+// One zod declaration yields both the published schema and the runtime parse, so
+// a cap advertised to a client is the same cap the handler enforces.
+function jsonSchema(schema) {
+    const out = z.toJSONSchema(schema, { io: 'input' });
+    delete out['$schema'];
+    return { ...out, type: 'object' };
+}
+function objectSchema(properties, required) {
+    return {
+        type: 'object',
+        properties: properties,
+        required: required,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "internetdata-mcp",
+  "version": "1.0.0",
+  "description": "Official MCP server for the InternetData API. Lets an LLM agent browse the IP databases an organization is licensed for, inspect what is inside one, and verify a copy it already holds.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://internetdata.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/internetdata/mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/internetdata/mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ip-database",
+    "ip-intelligence",
+    "ip-data",
+    "mmdb",
+    "maxmind-db",
+    "dataset",
+    "llm",
+    "agent"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "internetdata-mcp": "./dist/stdio.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "default": "./dist/tools.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@internetdata/internetdata": "^1.2.1",
+    "@modelcontextprotocol/sdk": "^1.20.2",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "generate": "node scripts/gen-schema.mjs",
+    "build": "rm -rf dist && pnpm run generate && tsc",
+    "test": "pnpm run build && node --test test/*.test.mjs"
+  }
+}