@pokemontcgapi/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pokemontcgapi.com
+
+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,153 @@
+# @pokemontcgapi/mcp
+
+An [MCP](https://modelcontextprotocol.io) server for the Pokémon TCG API at
+[pokemontcgapi.com](https://pokemontcgapi.com). It gives an agent eight tools over a
+catalogue of **615 sets and 52,337 cards** — 379 Japanese sets, 176 international, 60 Simplified
+Chinese — with card names in six languages, illustrators, images, and prices that carry their source,
+basis, grade and sample size.
+
+Unofficial. Not produced, endorsed, supported by or affiliated with Nintendo, Creatures Inc.,
+GAME FREAK inc. or The Pokémon Company International. Pokémon and all related marks are trademarks of
+their respective owners.
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add pokemontcgapi --env PTCG_API_KEY=your-key -- npx -y @pokemontcgapi/mcp
+```
+
+Claude Desktop — `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pokemontcgapi": {
+      "command": "npx",
+      "args": ["-y", "@pokemontcgapi/mcp"],
+      "env": { "PTCG_API_KEY": "your-key" }
+    }
+  }
+}
+```
+
+Cursor — `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "pokemontcgapi": {
+      "command": "npx",
+      "args": ["-y", "@pokemontcgapi/mcp"],
+      "env": { "PTCG_API_KEY": "${env:PTCG_API_KEY}" }
+    }
+  }
+}
+```
+
+VS Code — `.vscode/mcp.json`. Note the top-level key is `servers`, not `mcpServers`, and `inputs`
+keeps the key out of the committed file:
+
+```json
+{
+  "inputs": [
+    { "id": "ptcg-key", "type": "promptString", "description": "pokemontcgapi key", "password": true }
+  ],
+  "servers": {
+    "pokemontcgapi": {
+      "command": "npx",
+      "args": ["-y", "@pokemontcgapi/mcp"],
+      "env": { "PTCG_API_KEY": "${input:ptcg-key}" }
+    }
+  }
+}
+```
+
+Environment: `PTCG_API_KEY` (optional today), `PTCG_BASE_URL` (defaults to
+`https://api.pokemontcgapi.com`). Node ≥ 20.
+
+## The tools
+
+Eight tools, not one per endpoint. `tools/list` sits in the model's context on every turn, so the
+whole surface is just over 9 KB, and each tool is shaped like a question rather than like a route —
+the model does not have to chain four calls to answer one thing.
+
+| Tool | Answers |
+|---|---|
+| `ptcg_search_cards` | "Charizard cards from Japanese sets", by name, set, region, rarity, artist or release window |
+| `ptcg_get_cards` | Up to 100 ids in one call; `base1-4` and `bs-4` both resolve |
+| `ptcg_get_card_prices` | Every current observation for a card, with printing, grade, `as_of` and `sample_n` |
+| `ptcg_list_sets` | "Every Japanese set released in 2024" |
+| `ptcg_get_reference` | The exact strings for types, supertypes and rarities, so filters are not guessed |
+| `ptcg_list_artists` | Illustrators and how many cards each drew |
+| `ptcg_get_catalogue_status` | What the catalogue does and does **not** contain, measured live |
+| `ptcg_identify_card_from_image` | "Which card is this a photo of?" — ranked candidates, and an explicit refusal when reprints share the artwork. 25 credits a call |
+
+Every tool is annotated `readOnlyHint: true` and `destructiveHint: false`. Nothing here writes.
+`ptcg_identify_card_from_image` is the one marked `idempotentHint: false`, because the same photo costs
+25 credits every time it is sent — a client must not retry it on its own.
+
+## What this API does not have
+
+The last tool exists because of this section, and it returns these facts from a live call rather
+than leaving a model to infer them:
+
+- **No Korean cards.** Zero `KR` sets and zero `ko` translations. The print region and the locale are
+  modelled in the schema and carry no data, so filtering on them returns an empty result, not an error.
+- **No card game text.** `attacks`, `abilities`, `weaknesses`, `resistances`, `subtypes`,
+  `retreat_cost`, `rules`, `flavor_text` and `legalities` are empty for every card; `types` and
+  `national_pokedex_numbers` are populated only on part of the Scarlet & Violet era. If the question
+  is about what a card does in play, this API cannot answer it.
+
+Both statements are measured, dated in the source, and repeated verbatim in the tool descriptions —
+so an agent is told before it calls, not after.
+
+## Reading prices correctly
+
+There is no printing filter. First Edition, Unlimited, holofoil, reverse holofoil and graded rows all
+come back together, so read `printing`, `condition` and `grading` on each row rather than taking the
+first number. `basis` separates `GUIDE` (published upstream) from `DERIVED` (computed by us);
+`PTCG_INDEX` is our own composite in EUR and carries `sample_n`. Every observation has an `as_of`
+date and is delayed by at least a day — never quote a price without it.
+
+## Context discipline
+
+Results are capped at 50 rows regardless of what the API allows, sent as aligned tables rather than
+JSON (about 40% fewer tokens, and models misread them less often), with a compact field projection.
+Truncation is always announced along with the cursor to continue. Price rows are the one thing never
+truncated.
+
+## Protocol
+
+Built on `@modelcontextprotocol/server` v2, implementing the
+[2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28) revision. stdio transport.
+
+## Also available
+
+- **TypeScript SDK**, zero runtime dependencies: [`@pokemontcgapi/sdk`](https://www.npmjs.com/package/@pokemontcgapi/sdk) — [source](https://github.com/pokemontcgapi/sdk-typescript)
+- **Docs**: <https://pokemontcgapi.com/docs>
+- **Coverage, measured live**: <https://pokemontcgapi.com/coverage>
+
+## Build from source
+
+```bash
+npm ci
+npm run typecheck
+npm run build
+```
+
+Node >= 20. No test suite lives here yet: what CI enforces is that the package
+typechecks and builds on both Node 20 and Node 22, and that `npm pack` produces
+the file list the registry is meant to receive.
+
+This package is developed inside the private monorepo that runs
+[pokemontcgapi.com](https://pokemontcgapi.com) and mirrored here on each release,
+so a merged pull request travels back by hand rather than by merge button. That
+is not a reason to send patches elsewhere — open the issue or the PR here, it is
+the address that gets read.
+
+## Licence
+
+MIT. Data served by the API carries per-source redistribution terms — see
+<https://pokemontcgapi.com/legal/attribution>.

package/dist/api.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Client HTTP minimo verso api.pokemontcgapi.com.
+ *
+ * PERCHE' NON DIPENDE DA @pokemontcgapi/sdk, che pure esiste in questo repo:
+ * questo server usa sei endpoint in sola lettura e non pagina mai in
+ * profondita' (ogni risposta e' tagliata a 50 righe prima di tornare a un
+ * modello), quindi dell'SDK userebbe il trasporto e nient'altro. In cambio
+ * porterebbe un secondo pacchetto da tenere allineato in versione a ogni
+ * pubblicazione. La copia e' ottanta righe e si legge tutta; la dipendenza
+ * sarebbe piu' cara della copia. Se un giorno questo server dovesse iterare
+ * collezioni intere, la scelta va rifatta al contrario.
+ *
+ * Provenienza: la gestione degli errori e la forma dell'envelope sono le stesse
+ * di packages/sdk-typescript/src/{client,errors}.ts.
+ */
+export interface ApiErrorShape {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+    readonly request_id?: string;
+}
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details: Record<string, unknown> | undefined;
+    readonly requestId: string | undefined;
+    constructor(status: number, body: ApiErrorShape);
+}
+export interface Envelope<T> {
+    readonly data: readonly T[];
+    readonly meta?: {
+        readonly limit: number;
+        readonly count: number;
+        readonly total_count?: number;
+        readonly has_more: boolean;
+    };
+    readonly links?: {
+        readonly next?: string;
+    };
+}
+export declare class Api {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(baseUrl?: string, apiKey?: string | undefined);
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * POST di un'immagine, per il riconoscimento.
+     *
+     * Metodo separato e non un parametro di `get`: la forma della richiesta e'
+     * diversa in tutto — verbo, corpo, assenza di query — e schiacciarle in una
+     * sola funzione produrrebbe una firma con quattro argomenti opzionali di cui
+     * tre sempre inutilizzati.
+     */
+    postImage<T>(path: string, image: Uint8Array, fields?: Record<string, string>): Promise<T>;
+}

package/dist/api.js

@@ -0,0 +1,127 @@
+/**
+ * Client HTTP minimo verso api.pokemontcgapi.com.
+ *
+ * PERCHE' NON DIPENDE DA @pokemontcgapi/sdk, che pure esiste in questo repo:
+ * questo server usa sei endpoint in sola lettura e non pagina mai in
+ * profondita' (ogni risposta e' tagliata a 50 righe prima di tornare a un
+ * modello), quindi dell'SDK userebbe il trasporto e nient'altro. In cambio
+ * porterebbe un secondo pacchetto da tenere allineato in versione a ogni
+ * pubblicazione. La copia e' ottanta righe e si legge tutta; la dipendenza
+ * sarebbe piu' cara della copia. Se un giorno questo server dovesse iterare
+ * collezioni intere, la scelta va rifatta al contrario.
+ *
+ * Provenienza: la gestione degli errori e la forma dell'envelope sono le stesse
+ * di packages/sdk-typescript/src/{client,errors}.ts.
+ */
+const DEFAULT_BASE_URL = 'https://api.pokemontcgapi.com';
+const TIMEOUT_MS = 20_000;
+export class ApiError extends Error {
+    code;
+    status;
+    details;
+    requestId;
+    constructor(status, body) {
+        super(`${body.code}: ${body.message}`);
+        this.name = 'ApiError';
+        this.status = status;
+        this.code = body.code;
+        this.details = body.details;
+        this.requestId = body.request_id;
+    }
+}
+export class Api {
+    baseUrl;
+    apiKey;
+    constructor(baseUrl = process.env['PTCG_BASE_URL'] ?? DEFAULT_BASE_URL, apiKey = process.env['PTCG_API_KEY']) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.apiKey = apiKey;
+    }
+    async get(path, params = {}) {
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null || value === '')
+                continue;
+            search.set(key, Array.isArray(value) ? value.join(',') : String(value));
+        }
+        const query = search.toString();
+        const url = `${this.baseUrl}${path}${query === '' ? '' : `?${query}`}`;
+        const headers = {
+            accept: 'application/json',
+            'user-agent': '@pokemontcgapi/mcp',
+        };
+        if (this.apiKey !== undefined)
+            headers['x-api-key'] = this.apiKey;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const response = await fetch(url, { headers, signal: controller.signal });
+            if (!response.ok) {
+                let body = { code: `HTTP_${response.status}`, message: response.statusText };
+                try {
+                    const parsed = (await response.json());
+                    if (parsed.error?.code !== undefined)
+                        body = parsed.error;
+                }
+                catch {
+                    /* la risposta non era il nostro envelope: si tiene quella costruita sopra */
+                }
+                throw new ApiError(response.status, body);
+            }
+            return (await response.json());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * POST di un'immagine, per il riconoscimento.
+     *
+     * Metodo separato e non un parametro di `get`: la forma della richiesta e'
+     * diversa in tutto — verbo, corpo, assenza di query — e schiacciarle in una
+     * sola funzione produrrebbe una firma con quattro argomenti opzionali di cui
+     * tre sempre inutilizzati.
+     */
+    async postImage(path, image, fields = {}) {
+        const form = new FormData();
+        // Il tipo generico e non `image/jpeg`: il formato lo riconosce il server
+        // dai magic byte, e dichiarare quello sbagliato e' peggio che tacere.
+        form.set('image', new Blob([image], { type: "application/octet-stream" }), 'card');
+        for (const [key, value] of Object.entries(fields))
+            form.set(key, value);
+        const headers = {
+            accept: 'application/json',
+            'user-agent': '@pokemontcgapi/mcp',
+        };
+        // Nessun content-type esplicito: il boundary del multipart lo scrive fetch,
+        // e impostarlo a mano produce un corpo che il server non sa separare.
+        if (this.apiKey !== undefined)
+            headers['x-api-key'] = this.apiKey;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                method: 'POST',
+                headers,
+                body: form,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                let body = { code: `HTTP_${response.status}`, message: response.statusText };
+                try {
+                    const parsed = (await response.json());
+                    if (parsed.error?.code !== undefined)
+                        body = parsed.error;
+                }
+                catch {
+                    /* la risposta non era il nostro envelope */
+                }
+                throw new ApiError(response.status, body);
+            }
+            return (await response.json());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/caveats.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Le avvertenze che devono comparire IDENTICHE ovunque.
+ *
+ * Una descrizione di strumento MCP e' l'unico canale in cui mettiamo parole
+ * nostre dentro la memoria di lavoro di un modello, a ogni sessione, senza
+ * passare da un crawler. Vale la pena scriverle una volta sola e riusarle: se
+ * la descrizione di `ptcg_search_cards` dice una cosa e quella di
+ * `ptcg_get_cards` un'altra, il modello si fida della piu' recente e sbaglia.
+ *
+ * Misurate il 2026-08-27. Quando il dato a monte cambia, si cambia QUI.
+ */
+export declare const MEASURED_ON = "2026-08-27";
+/**
+ * La regola 4 del progetto — non dichiarare mai dati che non abbiamo — vive
+ * tecnicamente qui: nessun enum di questo server elenca `ko` o `KR` come se
+ * fossero popolati, e questa frase e' quella che uno strumento restituisce
+ * quando gli viene chiesto della copertura.
+ */
+export declare const KOREAN_COVERAGE: string;
+export declare const GAMEPLAY_FIELDS: string;
+export declare const PRICE_CAVEAT: string;
+export declare const LANGUAGE_CAVEAT: string;
+export declare const REGION_CAVEAT: string;

package/dist/caveats.js

@@ -0,0 +1,39 @@
+/**
+ * Le avvertenze che devono comparire IDENTICHE ovunque.
+ *
+ * Una descrizione di strumento MCP e' l'unico canale in cui mettiamo parole
+ * nostre dentro la memoria di lavoro di un modello, a ogni sessione, senza
+ * passare da un crawler. Vale la pena scriverle una volta sola e riusarle: se
+ * la descrizione di `ptcg_search_cards` dice una cosa e quella di
+ * `ptcg_get_cards` un'altra, il modello si fida della piu' recente e sbaglia.
+ *
+ * Misurate il 2026-08-27. Quando il dato a monte cambia, si cambia QUI.
+ */
+export const MEASURED_ON = '2026-08-27';
+/**
+ * La regola 4 del progetto — non dichiarare mai dati che non abbiamo — vive
+ * tecnicamente qui: nessun enum di questo server elenca `ko` o `KR` come se
+ * fossero popolati, e questa frase e' quella che uno strumento restituisce
+ * quando gli viene chiesto della copertura.
+ */
+export const KOREAN_COVERAGE = 'No Korean (KR) sets are present in the catalogue and no Korean (ko) card translations exist. ' +
+    'The KR print region and the ko locale are modelled in the schema but carry no data, so filtering ' +
+    'on them returns an empty result rather than an error.';
+export const GAMEPLAY_FIELDS = 'This catalogue does NOT carry card game text. attacks, abilities, weaknesses, resistances, subtypes, ' +
+    'retreat_cost, rules, flavor_text and legalities are empty for every card; types and ' +
+    'national_pokedex_numbers are populated only on part of the Scarlet & Violet era. If the question is ' +
+    'about what a card does in play, deck legality, or damage numbers, this API cannot answer it — say so ' +
+    'rather than inferring from the card name.';
+export const PRICE_CAVEAT = 'There is no printing filter: 1st Edition, Unlimited, holofoil, reverse holofoil and graded rows all come ' +
+    'back together, so you must read printing, condition and grading on each row rather than taking the first ' +
+    'price. basis distinguishes GUIDE (a figure published upstream) from DERIVED (computed by us). ' +
+    'PTCG_INDEX is our own composite in EUR and carries sample_n. Every observation carries as_of and is ' +
+    'delayed by at least a day — never quote a price without its as_of date and its source.';
+export const LANGUAGE_CAVEAT = 'Card names exist in six locales: en, ja, fr, de, es, it. Passing lang= replaces the name field itself ' +
+    'and falls back to English when a translation is missing. Set names are not translated.';
+export const REGION_CAVEAT = 'Print regions are WEST (176 sets), JP (379 sets) and CN (60 sets, Simplified Chinese), measured ' +
+    MEASURED_ON +
+    '. Japanese sets are not translations of Western ones: they have their own boundaries, their own ' +
+    'numbering and their own release dates, so a Japanese set and its international counterpart are two ' +
+    'different rows.';
+//# sourceMappingURL=caveats.js.map

package/dist/caveats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caveats.js","sourceRoot":"","sources":["../src/caveats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,+FAA+F;IAC/F,mGAAmG;IACnG,uDAAuD,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAC1B,uGAAuG;IACvG,sFAAsF;IACtF,sGAAsG;IACtG,uGAAuG;IACvG,2CAA2C,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GACvB,2GAA2G;IAC3G,2GAA2G;IAC3G,gGAAgG;IAChG,sGAAsG;IACtG,wFAAwF,CAAC;AAE3F,MAAM,CAAC,MAAM,eAAe,GAC1B,wGAAwG;IACxG,wFAAwF,CAAC;AAE3F,MAAM,CAAC,MAAM,aAAa,GACxB,kGAAkG;IAClG,WAAW;IACX,kGAAkG;IAClG,qGAAqG;IACrG,iBAAiB,CAAC"}

package/dist/collect.d.ts

@@ -0,0 +1,32 @@
+import type { Envelope } from './api.js';
+/**
+ * Raccolta paginata con filtro locale.
+ *
+ * Serve perche' due filtri che un agente chiede continuamente — "carte
+ * giapponesi" e "set usciti nel 2024" — l'endpoint non li accetta: la regione
+ * sta sul set e non e' un campo della grammatica di ricerca delle carte, e le
+ * finestre temporali sui set non sono parametri. Filtrare la PRIMA pagina e
+ * basta e' cio' che faceva la versione precedente di questo server, e su un
+ * elenco ordinato per data decrescente rispondeva "nessun risultato" a
+ * "set giapponesi del 2024" — perche' la prima pagina e' fatta di set del 2026.
+ *
+ * Due garanzie, entrambe necessarie:
+ *
+ * - `stop` permette di terminare presto quando la lista e' ordinata e siamo
+ *   usciti dalla finestra: senza, scorrere fino al 1996 per prendere il 2024
+ *   costerebbe decine di richieste.
+ * - `exhausted` dice se la scansione ha davvero visto tutto. Se e' falso il
+ *   chiamante DEVE dirlo nella risposta: un elenco parziale presentato come
+ *   completo e' il modo in cui un agente conclude che una carta non esiste.
+ */
+export interface Collected<T> {
+    readonly rows: readonly T[];
+    /** true se la scansione e' arrivata in fondo o ha incontrato `stop`. */
+    readonly exhausted: boolean;
+    readonly scannedPages: number;
+    readonly nextCursor: string | undefined;
+}
+export type Verdict = 'keep' | 'skip' | 'stop';
+export declare function collect<T>(fetchPage: (cursor: string | undefined) => Promise<Envelope<T>>, verdict: (row: T) => Verdict, limit: number, maxPages?: number): Promise<Collected<T>>;
+/** Il cursore e' opaco: si estrae dall'URL che l'API ha costruito, mai ricomposto. */
+export declare function cursorOf(nextUrl: string): string | undefined;

package/dist/collect.js

@@ -0,0 +1,44 @@
+export async function collect(fetchPage, verdict, limit, maxPages = 8) {
+    const rows = [];
+    let cursor;
+    let pages = 0;
+    let stopped = false;
+    while (pages < maxPages) {
+        const body = await fetchPage(cursor);
+        pages += 1;
+        for (const row of body.data) {
+            const call = verdict(row);
+            if (call === 'stop') {
+                stopped = true;
+                break;
+            }
+            if (call === 'keep')
+                rows.push(row);
+            if (rows.length >= limit)
+                break;
+        }
+        const next = body.links?.next;
+        if (stopped || rows.length >= limit || next === undefined) {
+            return {
+                rows,
+                exhausted: stopped || next === undefined,
+                scannedPages: pages,
+                nextCursor: rows.length >= limit ? (next === undefined ? undefined : cursorOf(next)) : undefined,
+            };
+        }
+        cursor = cursorOf(next);
+        if (cursor === undefined)
+            break;
+    }
+    return { rows, exhausted: false, scannedPages: pages, nextCursor: cursor };
+}
+/** Il cursore e' opaco: si estrae dall'URL che l'API ha costruito, mai ricomposto. */
+export function cursorOf(nextUrl) {
+    try {
+        return new URL(nextUrl).searchParams.get('cursor') ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=collect.js.map

package/dist/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../src/collect.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAA+D,EAC/D,OAA4B,EAC5B,KAAa,EACb,QAAQ,GAAG,CAAC;IAEZ,MAAM,IAAI,GAAQ,EAAE,CAAC;IACrB,IAAI,MAA0B,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,CAAC;QAEX,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACR,CAAC;YACD,IAAI,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAM;QAClC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9B,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1D,OAAO;gBACL,IAAI;gBACJ,SAAS,EAAE,OAAO,IAAI,IAAI,KAAK,SAAS;gBACxC,YAAY,EAAE,KAAK;gBACnB,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aACjG,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;IAClC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Entry stdio.
+ *
+ * `serveStdio` riceve una FABBRICA e non un'istanza: nella revisione 2026-07-28
+ * il server e' senza sessione, e l'istanza viene fissata dall'apertura della
+ * connessione. Passare un server gia' costruito e' il modo v1 di farlo, e qui
+ * non funzionerebbe.
+ *
+ * Nessun `console.log` in questo processo, mai: su stdio quel canale E' il
+ * protocollo, e una riga di log ci finisce dentro come frame malformato. La
+ * diagnostica va su stderr.
+ */
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { createServer } from './server.js';
+const handle = serveStdio(() => createServer(), {
+    onerror: (error) => {
+        process.stderr.write(`[pokemontcgapi-mcp] ${error.message}\n`);
+    },
+});
+for (const signal of ['SIGINT', 'SIGTERM']) {
+    process.on(signal, () => {
+        void handle.close().finally(() => process.exit(0));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE;IAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IACjE,CAAC;CACF,CAAC,CAAC;AAEH,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Il budget di contesto.
+ *
+ * Questo file decide se un agente tiene il server caricato o lo toglie. Ogni
+ * risposta che esce da uno strumento finisce nella finestra di contesto del
+ * modello e ci resta per tutto il turno, quindi le regole sono tre e non sono
+ * negoziabili:
+ *
+ * 1. **Tabelle, non JSON.** Una tabella allineata costa circa il 40% dei token
+ *    dello stesso dato in JSON, e i modelli la leggono con meno errori. Il JSON
+ *    esatto va comunque in `structuredContent`, che il client puo' leggere
+ *    senza che passi dal testo.
+ * 2. **Il taglio si dichiara.** Se restano righe, la risposta lo dice e dice
+ *    come prenderle. Un troncamento silenzioso fa concludere al modello di aver
+ *    visto tutto, ed e' il modo in cui un agente risponde con sicurezza a meta'
+ *    del problema.
+ * 3. **I prezzi non si tagliano mai.** Sono poche righe e sono esattamente il
+ *    motivo della chiamata: buttare via la riga giusta per risparmiare venti
+ *    token e' il peggior scambio possibile.
+ */
+/** Tetto nostro, piu' basso di quello dell'API: 250 righe non sopravvivono a un contesto. */
+export declare const MAX_ROWS = 50;
+export declare function clampLimit(requested: number | undefined): number;
+type Cell = string | number | null | undefined;
+/**
+ * Tabella a larghezza fissa. Niente bordi in ASCII: le pipe e i trattini
+ * costerebbero token quanto una colonna in piu' e non aggiungono niente per un
+ * lettore che non ha bisogno di vederci una griglia.
+ */
+export declare function table(headers: readonly string[], rows: readonly (readonly Cell[])[]): string;
+/**
+ * La riga che si aggiunge in fondo quando la collezione continua.
+ *
+ * Il cursore va ripetuto per intero: e' opaco e porta la firma
+ * dell'ordinamento, quindi un modello che prova a ricostruirlo ottiene un
+ * `INVALID_CURSOR`. Meglio spendere i token del cursore che una chiamata persa.
+ */
+export declare function moreLine(meta: {
+    total_count?: number;
+} | undefined, nextUrl: string | undefined): string;
+export {};

package/dist/render.js

@@ -0,0 +1,68 @@
+/**
+ * Il budget di contesto.
+ *
+ * Questo file decide se un agente tiene il server caricato o lo toglie. Ogni
+ * risposta che esce da uno strumento finisce nella finestra di contesto del
+ * modello e ci resta per tutto il turno, quindi le regole sono tre e non sono
+ * negoziabili:
+ *
+ * 1. **Tabelle, non JSON.** Una tabella allineata costa circa il 40% dei token
+ *    dello stesso dato in JSON, e i modelli la leggono con meno errori. Il JSON
+ *    esatto va comunque in `structuredContent`, che il client puo' leggere
+ *    senza che passi dal testo.
+ * 2. **Il taglio si dichiara.** Se restano righe, la risposta lo dice e dice
+ *    come prenderle. Un troncamento silenzioso fa concludere al modello di aver
+ *    visto tutto, ed e' il modo in cui un agente risponde con sicurezza a meta'
+ *    del problema.
+ * 3. **I prezzi non si tagliano mai.** Sono poche righe e sono esattamente il
+ *    motivo della chiamata: buttare via la riga giusta per risparmiare venti
+ *    token e' il peggior scambio possibile.
+ */
+/** Tetto nostro, piu' basso di quello dell'API: 250 righe non sopravvivono a un contesto. */
+export const MAX_ROWS = 50;
+export function clampLimit(requested) {
+    if (requested === undefined || !Number.isFinite(requested))
+        return 20;
+    return Math.max(1, Math.min(Math.trunc(requested), MAX_ROWS));
+}
+function cell(value) {
+    if (value === null || value === undefined || value === '')
+        return '—';
+    return String(value);
+}
+/**
+ * Tabella a larghezza fissa. Niente bordi in ASCII: le pipe e i trattini
+ * costerebbero token quanto una colonna in piu' e non aggiungono niente per un
+ * lettore che non ha bisogno di vederci una griglia.
+ */
+export function table(headers, rows) {
+    if (rows.length === 0)
+        return 'No rows.';
+    const widths = headers.map((header, index) => Math.max(header.length, ...rows.map((row) => cell(row[index]).length)));
+    const line = (values) => values
+        .map((value, index) => cell(value).padEnd(widths[index] ?? 0))
+        .join('  ')
+        .trimEnd();
+    return [line(headers), widths.map((width) => '-'.repeat(width)).join('  '), ...rows.map(line)].join('\n');
+}
+/**
+ * La riga che si aggiunge in fondo quando la collezione continua.
+ *
+ * Il cursore va ripetuto per intero: e' opaco e porta la firma
+ * dell'ordinamento, quindi un modello che prova a ricostruirlo ottiene un
+ * `INVALID_CURSOR`. Meglio spendere i token del cursore che una chiamata persa.
+ */
+export function moreLine(meta, nextUrl) {
+    if (nextUrl === undefined)
+        return '';
+    const cursor = new URL(nextUrl).searchParams.get('cursor') ?? '';
+    // Si dice il totale, non "quante ne restano": il resto dipende da quante
+    // pagine sono gia' state lette in questa conversazione, che questo processo
+    // non sa. Un numero sbagliato qui e' peggio di nessun numero.
+    const total = meta?.total_count;
+    const scope = total === undefined ? 'More rows' : `${total} rows match in total; more`;
+    return `
+
+${scope} available. Call again with cursor="${cursor}".`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,UAAU,CAAC,SAA6B;IACtD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAChE,CAAC;AAID,SAAS,IAAI,CAAC,KAAW;IACvB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IACtE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,OAA0B,EAAE,IAAkC;IAClF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAC3C,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CACvE,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,MAAuB,EAAU,EAAE,CAC/C,MAAM;SACH,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,EAAE,CAAC;IAEf,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5G,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAA0C,EAAE,OAA2B;IAC9F,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjE,yEAAyE;IACzE,4EAA4E;IAC5E,8DAA8D;IAC9D,MAAM,KAAK,GAAG,IAAI,EAAE,WAAW,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,4BAA4B,CAAC;IACvF,OAAO;;EAEP,KAAK,uCAAuC,MAAM,IAAI,CAAC;AACzD,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import { MEASURED_ON } from './caveats.js';
+export declare function createServer(): McpServer;
+export { MEASURED_ON };

package/dist/server.js

@@ -0,0 +1,515 @@
+import { McpServer, fromJsonSchema } from '@modelcontextprotocol/server';
+import { Api, ApiError } from './api.js';
+import { GAMEPLAY_FIELDS, KOREAN_COVERAGE, LANGUAGE_CAVEAT, MEASURED_ON, PRICE_CAVEAT, REGION_CAVEAT, } from './caveats.js';
+import { collect } from './collect.js';
+import { MAX_ROWS, clampLimit, moreLine, table } from './render.js';
+/**
+ * Sette strumenti, non sedici.
+ *
+ * La tentazione e' mappare uno strumento per endpoint: e' meccanico e sembra
+ * completo. Costa due cose. La prima e' che `tools/list` sta nel contesto a
+ * OGNI turno, quindi sedici schemi si pagano anche nelle conversazioni che non
+ * toccano le carte. La seconda, peggiore, e' che costringe il modello a
+ * incatenare chiamate — cerca il set, prendi il codice, elenca le carte,
+ * prendi i prezzi — e ogni anello e' un punto in cui puo' sbagliare.
+ *
+ * Qui gli strumenti hanno la forma delle DOMANDE ("quali set giapponesi sono
+ * usciti nel 2024", "quanto vale questo Charizard in euro"), e i parametri sono
+ * enumerati dove l'API accetterebbe testo libero: un enum e' un errore che il
+ * modello non puo' commettere.
+ *
+ * Cio' che NON e' esposto, e perche':
+ * - gli endpoint di prezzo dedicati e il feed delle modifiche: rispondono 404
+ *   sul servizio in esercizio, e uno strumento che fallisce e' peggio di uno
+ *   assente perche' il modello lo riprova;
+ * - gli export bulk: un agente non deve tirarsi in contesto un dump.
+ *
+ * L'ottavo strumento e' il riconoscimento da foto, ed e' l'unico che non e' una
+ * lettura. Sta qui perche' e' esattamente cio' che un agente multimodale non
+ * puo' fare da solo: guardare una carta e riconoscerla dall'illustrazione e'
+ * il compito su cui un modello generico allucina con la massima sicurezza —
+ * dice "Charizard Base Set" davanti a una ristampa e non ha modo di sapere di
+ * aver sbagliato. Qui la risposta e' misurata, e quando e' ambigua lo dichiara.
+ */
+const api = new Api();
+/** Solo cio' che esiste davvero. Un enum e' una promessa. */
+const REGIONS = ['WEST', 'JP', 'CN'];
+const LOCALES = ['en', 'ja', 'fr', 'de', 'es', 'it'];
+const READ_ONLY = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+/** Proiezione compatta: senza, ogni riga porta quaranta campi di cui il modello ne legge sei. */
+const CARD_FIELDS = ['id', 'name', 'number', 'rarity', 'set_code', 'set_name', 'release_date', 'print_region', 'artist_name', 'index_eur'];
+function textResult(text, structured) {
+    return { content: [{ type: 'text', text }], structuredContent: structured };
+}
+/**
+ * Un errore dell'API torna come `isError`, non come eccezione: il modello deve
+ * poterlo leggere e correggersi da solo. `details.valid_fields` e simili sono
+ * la parte utile, quindi si riportano invece di essere riassunti.
+ */
+function errorResult(error) {
+    if (error instanceof ApiError) {
+        const detail = error.details === undefined ? '' : `\n${JSON.stringify(error.details)}`;
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `${error.code}: ${error.message}${detail}` }],
+        };
+    }
+    return {
+        isError: true,
+        content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],
+    };
+}
+export function createServer() {
+    const server = new McpServer({ name: 'pokemontcgapi', version: '0.1.0' }, { capabilities: { tools: {} } });
+    // ── 1 · ricerca carte ─────────────────────────────────────────────────────
+    server.registerTool('ptcg_search_cards', {
+        title: 'Search Pokémon cards',
+        description: 'Search the Pokémon TCG card catalogue by name, set, print region, rarity, artist or release window. ' +
+            'Returns one row per printing with its set, rarity, illustrator and euro price index. ' +
+            REGION_CAVEAT +
+            ' ' +
+            LANGUAGE_CAVEAT +
+            ' ' +
+            GAMEPLAY_FIELDS,
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Card name or part of it, e.g. "charizard".' },
+                set: { type: 'string', description: 'Set code, e.g. "bs", "sv3". Use ptcg_list_sets to find it.' },
+                region: { type: 'string', enum: [...REGIONS], description: 'Print region of the set the card belongs to.' },
+                rarity: { type: 'string', description: 'Exact printed rarity. Use ptcg_get_reference to list valid values.' },
+                artist: { type: 'string', description: 'Illustrator name.' },
+                released_from: { type: 'string', description: 'ISO date, inclusive lower bound on the set release date.' },
+                released_to: { type: 'string', description: 'ISO date, inclusive upper bound on the set release date.' },
+                lang: { type: 'string', enum: [...LOCALES], description: 'Return card names in this locale.' },
+                order_by: { type: 'string', description: 'e.g. "-set.releaseDate", "name". Sorting always ends with id.' },
+                limit: { type: 'integer', minimum: 1, maximum: MAX_ROWS, description: `Rows, capped at ${MAX_ROWS}.` },
+                cursor: { type: 'string', description: 'Opaque cursor from a previous call. Never construct one.' },
+                q: {
+                    type: 'string',
+                    description: 'Escape hatch: raw Lucene-style query. Field names are camelCase and dotted (set.code, ' +
+                        'set.releaseDate, nationalPokedexNumbers) while response keys are snake_case. Only use this ' +
+                        'when the named arguments above cannot express the question.',
+                },
+            },
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const clauses = [];
+            // Niente wildcard iniziali: l'API le rifiuta con QUERY_UNSUPPORTED, e
+            // ha ragione — un pattern che comincia per "*" non ha prefisso su cui
+            // cercare. `name:charizard` gia' matcha come sottostringa.
+            if (args.name !== undefined && args.name !== '')
+                clauses.push(`name:${JSON.stringify(args.name)}`);
+            if (args.rarity !== undefined && args.rarity !== '')
+                clauses.push(`rarity:${JSON.stringify(args.rarity)}`);
+            if (args.artist !== undefined && args.artist !== '')
+                clauses.push(`artist:${JSON.stringify(args.artist)}`);
+            if (args.released_from !== undefined)
+                clauses.push(`set.releaseDate:[${args.released_from} TO *]`);
+            if (args.released_to !== undefined)
+                clauses.push(`set.releaseDate:[* TO ${args.released_to}]`);
+            if (args.q !== undefined && args.q !== '')
+                clauses.push(args.q);
+            const limit = clampLimit(args.limit);
+            // `print_region` non e' un campo della grammatica: sta sul set, non
+            // sulla carta. Si scorre finche' non si sono raccolte abbastanza righe,
+            // e se la scansione non e' finita lo si DICE.
+            const collected = await collect((cursor) => api.get('/v1/cards', {
+                q: clauses.length === 0 ? undefined : clauses.join(' '),
+                set: args.set,
+                lang: args.lang,
+                orderBy: args.order_by,
+                cursor: cursor ?? args.cursor,
+                limit: args.region === undefined ? limit : 100,
+                select: CARD_FIELDS,
+            }), (card) => (args.region === undefined || card.print_region === args.region ? 'keep' : 'skip'), limit);
+            const rows = collected.rows;
+            const trailer = collected.nextCursor !== undefined
+                ? `
+
+More rows available. Call again with cursor="${collected.nextCursor}".`
+                : collected.exhausted
+                    ? ''
+                    : `
+
+Scan stopped after ${collected.scannedPages} pages without reaching the end of the catalogue; there may be more matches.`;
+            const text = table(['id', 'name', 'set', 'rarity', 'region', 'released', 'EUR idx'], rows.map((c) => [c.id, c.name, c.set_code, c.rarity, c.print_region, c.release_date, c.index_eur])) + trailer;
+            return textResult(text, { cards: rows, complete: collected.exhausted });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 2 · carte per id ──────────────────────────────────────────────────────
+    server.registerTool('ptcg_get_cards', {
+        title: 'Get Pokémon cards by id',
+        description: 'Fetch one or many cards by id, in a single call. Ids are the printed coordinate — set code, dash, ' +
+            'collector number, e.g. "bs-4" — and the alternate legacy id ("base1-4") resolves on the same route. ' +
+            'Ids that do not exist are omitted from the result; compare requested against found. ' +
+            GAMEPLAY_FIELDS,
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                ids: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    maxItems: 100,
+                    description: 'Card ids, 1 to 100.',
+                },
+                lang: { type: 'string', enum: [...LOCALES] },
+                include_prices: { type: 'boolean', description: 'Attach the full price list to each card.' },
+            },
+            required: ['ids'],
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const ids = args.ids.slice(0, 100);
+            const body = await api.get('/v1/cards/batch', {
+                ids,
+                lang: args.lang,
+                include: args.include_prices === true ? 'prices' : undefined,
+                select: args.include_prices === true ? undefined : CARD_FIELDS,
+            });
+            const missing = ids.filter((id) => !body.data.some((c) => c.id === id));
+            const text = table(['id', 'name', 'set', 'rarity', 'region', 'released', 'EUR idx'], body.data.map((c) => [c.id, c.name, c.set_code, c.rarity, c.print_region, c.release_date, c.index_eur])) +
+                (missing.length === 0 ? '' : `\n\nNot found: ${missing.join(', ')}`);
+            return textResult(text, { cards: body.data, requested: body.requested, found: body.found, missing });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 3 · prezzi ────────────────────────────────────────────────────────────
+    server.registerTool('ptcg_get_card_prices', {
+        title: 'Get prices for a Pokémon card',
+        description: 'Every current price observation for one card, each with its source, basis, printing, grade, sample ' +
+            'size and the day it is for. ' +
+            PRICE_CAVEAT,
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Card id, e.g. "bs-4" or "base1-4".' },
+                currency: {
+                    type: 'string',
+                    enum: ['EUR', 'USD'],
+                    description: 'Only show rows already denominated in this currency. Nothing is ever converted.',
+                },
+            },
+            required: ['id'],
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const card = await api.get(`/v1/cards/${encodeURIComponent(args.id)}`, { include: 'prices' });
+            const all = card.prices ?? [];
+            const rows = args.currency === undefined ? all : all.filter((p) => p.currency === args.currency);
+            // I prezzi non si tagliano: vedi il commento in render.ts.
+            const text = `${card.name} (${card.id}) — composite index ${card.index_eur ?? '—'} EUR, last recomputed ${card.last_price_at ?? '—'}\n\n` +
+                table(['source', 'variant', 'basis', 'price', 'cur', 'printing', 'grade', 'as_of', 'n'], rows.map((p) => [
+                    p.source,
+                    p.variant,
+                    p.basis,
+                    p.price,
+                    p.currency,
+                    p.printing,
+                    p.grading === null ? null : `${p.grading.company} ${p.grading.score}`,
+                    p.as_of,
+                    p.sample_n,
+                ]));
+            return textResult(text, {
+                card: { id: card.id, name: card.name, index_eur: card.index_eur, last_price_at: card.last_price_at },
+                prices: rows,
+            });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 4 · set ───────────────────────────────────────────────────────────────
+    server.registerTool('ptcg_list_sets', {
+        title: 'List Pokémon TCG sets',
+        description: 'Every set with its code, series, print region, release date and printed total. One call answers ' +
+            'questions like "every Japanese set released in 2024". ' +
+            REGION_CAVEAT,
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                region: { type: 'string', enum: [...REGIONS] },
+                series: { type: 'string', description: 'Era or series name, e.g. "Scarlet & Violet".' },
+                name: { type: 'string', description: 'Set name or part of it.' },
+                released_from: { type: 'string', description: 'ISO date, inclusive lower bound.' },
+                released_to: { type: 'string', description: 'ISO date, inclusive upper bound.' },
+                order_by: { type: 'string', description: 'e.g. "-release_date" (default) or "release_date".' },
+                limit: { type: 'integer', minimum: 1, maximum: MAX_ROWS },
+                cursor: { type: 'string' },
+            },
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const limit = clampLimit(args.limit);
+            const orderBy = args.order_by ?? '-release_date';
+            // L'ordinamento di default e' per data decrescente: appena una riga e'
+            // piu' vecchia del limite inferiore, tutte le successive lo sono, e la
+            // scansione puo' fermarsi. E' cio' che rende praticabile "i set
+            // giapponesi del 2024" in una sola chiamata.
+            const descendingByDate = orderBy === '-release_date';
+            const collected = await collect((cursor) => api.get('/v1/sets', {
+                region: args.region,
+                series: args.series,
+                // `q` su /v1/sets e' testo libero, NON la grammatica a campi
+                // delle carte: `name:Base` non trova nulla, `Base` si'.
+                q: args.name,
+                orderBy,
+                cursor,
+                limit: 100,
+            }), (set) => {
+                if (set.release_date === null) {
+                    return args.released_from === undefined && args.released_to === undefined ? 'keep' : 'skip';
+                }
+                if (args.released_to !== undefined && set.release_date > args.released_to)
+                    return 'skip';
+                if (args.released_from !== undefined && set.release_date < args.released_from) {
+                    return descendingByDate ? 'stop' : 'skip';
+                }
+                return 'keep';
+            }, limit);
+            const rows = collected.rows;
+            const trailer = collected.nextCursor !== undefined
+                ? `
+
+More rows available. Call again with cursor="${collected.nextCursor}".`
+                : collected.exhausted
+                    ? ''
+                    : `
+
+Scan stopped after ${collected.scannedPages} pages; there may be more matching sets.`;
+            const text = table(['code', 'name', 'region', 'released', 'printed', 'total'], rows.map((set) => [set.code, set.name, set.region, set.release_date, set.printed_total, set.total])) + trailer;
+            return textResult(text, { sets: rows, complete: collected.exhausted });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 5 · vocabolari ────────────────────────────────────────────────────────
+    server.registerTool('ptcg_get_reference', {
+        title: 'List the closed vocabularies',
+        description: 'The exact strings the catalogue uses for types, supertypes and rarities. Call this before filtering ' +
+            'on a rarity or a type rather than guessing the wording — "Rare Rainbow" and "Rainbow Rare" are not ' +
+            'the same string, and only one of them matches. Note that subtypes is currently an empty list.',
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                vocabulary: { type: 'string', enum: ['types', 'supertypes', 'rarities', 'subtypes'] },
+            },
+            required: ['vocabulary'],
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const body = await api.get(`/v1/${args.vocabulary}`);
+            const note = body.data.length === 0 ? ' (this vocabulary is not populated in the catalogue today)' : '';
+            return textResult(`${args.vocabulary}${note}:\n${body.data.join('\n')}`, {
+                vocabulary: args.vocabulary,
+                values: body.data,
+            });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 6 · illustratori ──────────────────────────────────────────────────────
+    server.registerTool('ptcg_list_artists', {
+        title: 'List card illustrators',
+        description: 'Illustrators with the number of cards each has drawn, deduplicated across 30 years of printings. ' +
+            'Use the returned name with the artist argument of ptcg_search_cards to get their cards.',
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Illustrator name or part of it.' },
+                limit: { type: 'integer', minimum: 1, maximum: MAX_ROWS },
+                cursor: { type: 'string' },
+            },
+            additionalProperties: false,
+        }),
+    }, async (args) => {
+        try {
+            const body = await api.get('/v1/artists', {
+                q: args.name,
+                limit: clampLimit(args.limit),
+                cursor: args.cursor,
+            });
+            const text = table(['slug', 'name', 'cards'], body.data.map((a) => [a.slug, a.name, a.card_count])) +
+                moreLine(body.meta, body.links?.next);
+            return textResult(text, { artists: body.data, meta: body.meta ?? null });
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 7 · copertura ─────────────────────────────────────────────────────────
+    /**
+     * Questo strumento esiste per una ragione sola, ed e' la regola 4.
+     *
+     * Un modello a cui viene chiesto "questa API ha le carte coreane?" altrimenti
+     * risponderebbe deducendolo da un enum o da un nome di prodotto, cioe'
+     * inventando. Qui la risposta e' un fatto misurato che arriva da una chiamata,
+     * ed e' scritta a lettere.
+     */
+    server.registerTool('ptcg_get_catalogue_status', {
+        title: 'What this catalogue actually covers',
+        description: 'Live counts and coverage for the catalogue: sets per print region, card total, which locales carry ' +
+            'card names, and which data is explicitly NOT present. Call this before telling a user what the API ' +
+            'can and cannot answer.',
+        annotations: READ_ONLY,
+        inputSchema: fromJsonSchema({ type: 'object', properties: {}, additionalProperties: false }),
+    }, async () => {
+        try {
+            const status = await api.get('/v1/status');
+            const perRegion = await Promise.all(['WEST', 'JP', 'CN', 'KR'].map(async (region) => {
+                const body = await api.get('/v1/sets', { region, limit: 1 });
+                return { region, sets: body.meta?.total_count ?? 0 };
+            }));
+            const coverage = {
+                measured_at: new Date().toISOString(),
+                sets: status.catalog.sets,
+                cards: status.catalog.cards,
+                sealed_products: status.catalog.sealed,
+                sets_by_print_region: Object.fromEntries(perRegion.map((r) => [r.region, r.sets])),
+                card_name_locales: [...LOCALES],
+                price_sources: ['TCGPLAYER', 'CARDMARKET', 'CARDTRADER', 'EBAY_SOLD', 'PTCG_INDEX', 'COMMUNITY'],
+                coverage_notes: [KOREAN_COVERAGE, GAMEPLAY_FIELDS, LANGUAGE_CAVEAT],
+            };
+            const text = [
+                `Catalogue: ${status.catalog.sets} sets, ${status.catalog.cards} cards, ${status.catalog.sealed} sealed products.`,
+                '',
+                table(['print region', 'sets'], perRegion.map((r) => [r.region, r.sets])),
+                '',
+                `Card-name locales: ${LOCALES.join(', ')}`,
+                `Price sources: ${coverage.price_sources.join(', ')}`,
+                '',
+                KOREAN_COVERAGE,
+                '',
+                GAMEPLAY_FIELDS,
+            ].join('\n');
+            return textResult(text, coverage);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    // ── 8 · riconoscimento da foto ────────────────────────────────────────────
+    /**
+     * L'unico strumento che scrive qualcosa (un'immagine) e l'unico che costa 25
+     * crediti invece di uno. Entrambe le cose stanno nella descrizione, perche' un
+     * modello che non le sa lo mette in un ciclo.
+     *
+     * Il contratto verso il modello e' scritto per essere difficile da sbagliare:
+     * la risposta dice a lettere cosa fare in ognuno dei tre casi, invece di
+     * lasciare che sia il modello a dedurre cosa significhi `ambiguous`. Un
+     * assistente che consegna la ristampa sbagliata in una collezione fa un danno
+     * che l'utente scopre mesi dopo, quando prova a venderla.
+     */
+    server.registerTool('ptcg_identify_card_from_image', {
+        title: 'Identify a card from a photo',
+        description: 'Recognise a Pokemon card from a photograph and return ranked candidates. Use this instead of guessing ' +
+            'from what you see in an image: reprints share their artwork, so visual identification alone cannot ' +
+            'name a printing, and this tool says so when it cannot. Costs 25 credits per call against 1 for a ' +
+            'lookup — do not call it in a loop. Pass `set` or `region` when the user has told you either.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            // NON idempotente: la stessa foto costa 25 crediti ogni volta che la
+            // mandi. Dichiararlo idempotente inviterebbe un client a ritentare.
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+        inputSchema: fromJsonSchema({
+            type: 'object',
+            properties: {
+                image_base64: {
+                    type: 'string',
+                    description: 'The photograph, base64-encoded. A data: URL prefix is accepted and stripped.',
+                },
+                set: { type: 'string', description: 'Set code to restrict to, e.g. "sv3". Resolves reprint ties.' },
+                region: { type: 'string', enum: [...REGIONS], description: 'Print region to restrict to.' },
+                top_k: { type: 'integer', minimum: 1, maximum: 10, description: 'Candidates to return. Default 3.' },
+            },
+            required: ['image_base64'],
+            additionalProperties: false,
+        }),
+    }, async ({ image_base64, set, region, top_k }) => {
+        try {
+            const cleaned = image_base64.includes(',') && image_base64.startsWith('data:')
+                ? image_base64.slice(image_base64.indexOf(',') + 1)
+                : image_base64;
+            const bytes = Uint8Array.from(Buffer.from(cleaned, 'base64'));
+            if (bytes.byteLength === 0) {
+                throw new ApiError(400, { code: 'INVALID_PARAMETER', message: 'image_base64 decoded to nothing.' });
+            }
+            const fields = {};
+            if (set !== undefined)
+                fields['set'] = set;
+            if (region !== undefined)
+                fields['region'] = region;
+            if (top_k !== undefined)
+                fields['top_k'] = String(top_k);
+            const body = await api.postImage('/v1/vision/identify', bytes, fields);
+            // La riga di istruzione viene PRIMA della tabella, non dopo: un modello
+            // che legge dall'alto deve incontrare il vincolo prima dei dati su cui
+            // sarebbe tentato di agire.
+            const verdict = body.data.decision === 'match'
+                ? `MATCH — one candidate is clearly closest. Safe to treat ${body.data.id} as the card.`
+                : body.data.decision === 'ambiguous'
+                    ? 'AMBIGUOUS — two or more printings share this illustration and cannot be told apart from the ' +
+                        'image. Do NOT pick one. Present the candidates to the user, or ask which set it came from ' +
+                        'and call again with `set`.'
+                    : body.meta.regions_detected === 0
+                        ? 'NO MATCH — and no card-shaped region was found in the photo at all. Ask for a photo where ' +
+                            'the card fills more of the frame, on a plain background. This is a framing problem, not ' +
+                            'evidence that the card is missing from the catalogue.'
+                        : 'NO MATCH — a card was found in the photo but nothing in the catalogue is close enough. ' +
+                            'Do not guess a name from what you see.';
+            const rows = body.data.candidates.map((c) => [
+                c.id,
+                c.name,
+                `${c.set.code} ${c.number}`,
+                c.set.print_region,
+                c.rarity ?? '—',
+                c.distance,
+            ]);
+            const text = [
+                verdict,
+                '',
+                rows.length === 0
+                    ? 'No candidates within range.'
+                    : table(['id', 'name', 'set / no.', 'region', 'rarity', 'distance'], rows),
+                '',
+                'distance is 0-512, lower is closer; real matches land well under 150. ' +
+                    `Compared against ${body.meta.cards_indexed} indexed card images.`,
+            ].join('\n');
+            return textResult(text, body.data);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    return server;
+}
+export { MEASURED_ON };
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@pokemontcgapi/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Pokémon TCG API: search cards, sets, illustrators and prices from any MCP client.",
+  "license": "MIT",
+  "type": "module",
+  "engines": { "node": ">=20" },
+  "bin": { "pokemontcgapi-mcp": "dist/index.js" },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md"],
+  "mcpName": "com.pokemontcgapi/mcp",
+  "keywords": ["mcp", "modelcontextprotocol", "pokemon", "pokemon-tcg", "tcg", "card-prices", "agent", "ai"],
+  "repository": { "type": "git", "url": "git+https://github.com/pokemontcgapi/mcp-server.git" },
+  "homepage": "https://pokemontcgapi.com/mcp",
+  "bugs": { "url": "https://github.com/pokemontcgapi/mcp-server/issues" },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.3"
+  }
+}