The MCP server that teaches AI agents trading card games

Esplora la copertura di 15 giochi elencati. La tabella mostra quali regole, glossari e carte sono disponibili. Gli agenti possono leggere e citare le fonti disponibili tramite MCP.

Read-only Rate limited Stdio or HTTP

agent-config.json

Register the server with any MCP client

{
  "mcpServers": {
    "tcg-knowledge": {
      "command": "bun",
      "args": ["tools/tcg-mcp-server/server.ts"]
    }
  }
}

Remote HTTP (canonical production URL):

{
  "mcpServers": {
    "tcg-knowledge": {
      "url": "https://api.tcg.online/mcp"
    }
  }
}

Eight tools. Every question a rules adviser gets paid for.

No endpoints to memorize and no scrapes to babysit — an agent discovers coverage with list_games and works from there. Every answer ships with its citation.

search_rules
Ranked full-text search across comprehensive rules, errata, and release notes — every hit cited with document, heading, and line.
read_rules_document
Read any rules document in full, or jump straight to the section an agent needs by heading.
search_glossary
Term lookups with exact and related matches: keywords, zones, phases, and reminder text with per-term citations.
search_cards
Card search by name or rules text across every served game, with type filters and cross-game results.
get_card
The full record for one card: rules text, keywords, stats, printings with art, and format legalities where published.
list_card_sets
Sets and expansions per game with card counts where the catalog provides them.
list_rules_documents
The rules shelf for a game — document ids, kinds, and section counts agents can navigate.
list_games
Coverage discovery: which games have rules, glossaries, and cards, with caveats stated honestly.

Copertura dettagliata

Questa tabella usa il manifesto generato dei file di conoscenza. Mostra le sezioni disponibili in questa versione web.

Copertura di regole, glossari e carte per gioco nel server MCP TCG Knowledge
GiocoRegoleGlossarioCarte
Alpha ClashDisponibileNon disponibile 1426
Cyberpunk TCGDisponibileDisponibile 155
Disney's LorcanaDisponibileDisponibile 2477
Flesh and BloodDisponibileDisponibile 5195
Grand ArchiveDisponibileDisponibile 2495
Gundam Card GameDisponibileDisponibile 1060
One Piece Card GameDisponibileDisponibile 2392
Star Wars: UnlimitedDisponibileDisponibile 2189
Naruto Card Game PreviewNon disponibileNon disponibile 35 (anteprima)
Digimon Card GameLink ufficialiNon disponibileLink ufficiali
Dragon Ball Super Fusion WorldLink ufficialiNon disponibileLink ufficiali
Magic: The GatheringLink ufficialiNon disponibileLink ufficiali
Pokémon TCGLink ufficialiNon disponibileLink ufficiali
Yu-Gi-Oh! TCGLink ufficialiNon disponibileLink ufficiali
RiftboundNon disponibileNon disponibile Non disponibile

Questi cataloghi sono disponibili anche come testo semplice su /llm.txt.

Una domanda per ogni gioco

Prova queste domande per i giochi con cataloghi di carte pubblicati. Coprono regole, interazioni, ricerca di carte ed espansioni. La tabella indica dati provvisori o non disponibili.

Alpha Clash

«Trova le carte Alpha Clash con Dragon nel nome. Mostra tre esempi e collega la fonte.»

Esplora i file sorgente

Cyberpunk TCG

«Modded Kusanagi può attaccare quando viene giocata se il mio Rival controlla MaxTac Suppression Team? Collega entrambe le carte e le regole.»

Esplora i file sorgente

Disney's Lorcana

«Trova le carte Lorcana chiamate Woody. Mostra il testo stampato e collega la fonte.»

Esplora i file sorgente

Flesh and Blood

«Spiega la priorità in Flesh and Blood. Cita la regola 1.11 e collega la fonte TCG Online.»

Esplora i file sorgente

Grand Archive

«Trova le carte campione Merlin di Grand Archive. Elenca i nomi e collega il testo stampato.»

Esplora i file sorgente

Gundam Card Game

«Quali espansioni di Gundam Card Game sono indicizzate? Mostra il numero di carte e collega la fonte.»

Esplora i file sorgente

One Piece Card Game

«Trova le carte One Piece chiamate Monkey.D.Luffy. Distingui i leader dai personaggi e collega il testo stampato.»

Esplora i file sorgente

Star Wars: Unlimited

«Trova le carte Star Wars: Unlimited chiamate Luke Skywalker. Confronta i sottotitoli e collega la fonte.»

Esplora i file sorgente

Built to be pointed at, not watched

Read-only by construction

The tool surface has no write path at all. It serves rules text, glossary entries, and card records — nothing an agent does can create, change, or delete data.

Rate limited before work happens

Every HTTP client gets a token bucket — 60 requests a minute, burst 30 — checked before a query runs. Over the limit means a clean 429 with Retry-After, not a dropped connection.

Stateless and self-hostable

One process, no database, no session state. Serve it over stdio to a local agent or run streamable HTTP on /mcp; answers are capped so no single request can monopolize it.

Connect an agent

Point an MCP client at https://api.tcg.online/mcp for streamable HTTP, or run the zero-dependency Bun server from The Card Goat repository over stdio. Self-host HTTP with --http when you need a private endpoint.

Stdio — local agents

The standard MCP registration: one command, one process, pipe-sized trust boundary.

{
  "mcpServers": {
    "tcg-knowledge": {
      "command": "bun",
      "args": ["tools/tcg-mcp-server/server.ts"]
    }
  }
}

HTTP — remote agents

Canonical production URL is https://api.tcg.online/mcp — streamable HTTP, rate limited, with a /healthz probe. Self-host with the command below if you need a private copy.

{
  "mcpServers": {
    "tcg-knowledge": {
      "url": "https://api.tcg.online/mcp"
    }
  }
}
bun tools/tcg-mcp-server/server.ts --http --port 8180
# → stateless MCP endpoint on http://localhost:8180/mcp

Questions agents ask before agents do

Che cos’è il server MCP TCG Knowledge?

È un server MCP di sola lettura. Gli agenti IA possono consultare regole pubblicate, errata, glossari e cataloghi di carte tramite otto strumenti, tra cui search_rules, search_cards e get_card.

Quali giochi sono coperti?

La tabella in questa pagina mostra i file di regole e glossario disponibili e il numero di carte per ogni gioco. Le carte in anteprima sono indicate.

È sicuro usare il server con un agente?

Sì. Gli strumenti leggono solo dati pubblici. Non possono creare, modificare o eliminare dati. Le richieste HTTP e la dimensione delle risposte sono limitate.

Come collego un agente?

Collega un client MCP a https://api.tcg.online/mcp tramite HTTP streaming. Puoi anche eseguire il server dal repository di The Card Goat con Bun su stdio o ospitarlo via HTTP.

È a pagamento?

No. Il server è gratuito, open source, ospitabile in proprio e soggetto a limiti di richieste.

Start with the games, stay for the rulings

Usa i file indicizzati di regole e carte per esplorare i contenuti disponibili per ogni gioco.

Built in the open

The TCG Knowledge MCP server is developed alongside the engines and catalogs it serves, so card text and rules coverage stay in lockstep with the platform. Coverage gaps are recorded, not hidden — the same policy the server applies when an agent asks what it does not have.