The MCP server that teaches AI agents trading card games

Consulta la cobertura de 15 juegos incluidos. La tabla muestra qué reglas, glosarios y cartas están disponibles. Los agentes pueden leer y citar las fuentes disponibles mediante 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.

Cobertura detallada

Esta tabla usa el manifiesto generado de archivos de conocimiento. Muestra las secciones disponibles en esta versión web.

Cobertura de reglas, glosarios y cartas por juego en el servidor MCP de TCG Knowledge
JuegoReglasGlosarioCartas
Alpha ClashDisponibleNo disponible 1426
Cyberpunk TCGDisponibleDisponible 155
Disney's LorcanaDisponibleDisponible 2477
Flesh and BloodDisponibleDisponible 5195
Grand ArchiveDisponibleDisponible 2495
Gundam Card GameDisponibleDisponible 1060
One Piece Card GameDisponibleDisponible 2392
Star Wars: UnlimitedDisponibleDisponible 2189
Naruto Card Game PreviewNo disponibleNo disponible 35 (vista previa)
Digimon Card GameEnlaces oficialesNo disponibleEnlaces oficiales
Dragon Ball Super Fusion WorldEnlaces oficialesNo disponibleEnlaces oficiales
Magic: The GatheringEnlaces oficialesNo disponibleEnlaces oficiales
Pokémon TCGEnlaces oficialesNo disponibleEnlaces oficiales
Yu-Gi-Oh! TCGEnlaces oficialesNo disponibleEnlaces oficiales
RiftboundNo disponibleNo disponible No disponible

Estos catálogos también están disponibles como texto sin formato en /llm.txt.

Una pregunta para cada juego

Prueba estas preguntas para juegos con catálogos de cartas publicados. Incluyen reglas, interacciones, búsqueda de cartas y colecciones. La tabla de cobertura señala los datos preliminares o no disponibles.

Alpha Clash

«Busca cartas de Alpha Clash con Dragon en el nombre. Muestra tres ejemplos y enlaza la fuente.»

Explorar archivos fuente

Cyberpunk TCG

«¿Puede Modded Kusanagi atacar al jugarse si mi Rival controla MaxTac Suppression Team? Enlaza ambas cartas y las reglas.»

Explorar archivos fuente

Disney's Lorcana

«Busca cartas de Lorcana llamadas Woody. Muestra su texto impreso y enlaza la fuente.»

Explorar archivos fuente

Flesh and Blood

«Explica la prioridad en Flesh and Blood. Cita la regla 1.11 y enlaza la fuente de TCG Online.»

Explorar archivos fuente

Grand Archive

«Busca cartas de campeón Merlin de Grand Archive. Enumera sus nombres y enlaza su texto impreso.»

Explorar archivos fuente

Gundam Card Game

«¿Qué colecciones de Gundam Card Game están indexadas? Muestra el número de cartas y enlaza la fuente.»

Explorar archivos fuente

One Piece Card Game

«Busca cartas de One Piece llamadas Monkey.D.Luffy. Distingue líderes de personajes y enlaza su texto impreso.»

Explorar archivos fuente

Star Wars: Unlimited

«Busca cartas de Star Wars: Unlimited llamadas Luke Skywalker. Compara sus subtítulos y enlaza la fuente.»

Explorar archivos fuente

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

¿Qué es el servidor MCP de TCG Knowledge?

Es un servidor MCP de solo lectura. Los agentes de IA pueden consultar reglas publicadas, erratas, glosarios y catálogos de cartas mediante ocho herramientas, entre ellas search_rules, search_cards y get_card.

¿Qué juegos están cubiertos?

La tabla de esta página muestra los archivos de reglas y glosario disponibles y el número de cartas de cada juego. Las cartas preliminares están marcadas.

¿Es seguro usar el servidor con un agente?

Sí. Sus herramientas solo leen datos públicos. No pueden crear, modificar ni borrar datos. Las solicitudes HTTP y el tamaño de las respuestas están limitados.

¿Cómo conecto un agente?

Conecta un cliente MCP a https://api.tcg.online/mcp mediante HTTP transmisible. También puedes ejecutar el servidor desde el repositorio de The Card Goat con Bun por stdio o alojarlo por HTTP.

¿Tiene algún costo?

No. El servidor es gratuito, de código abierto, se puede alojar por cuenta propia y tiene límites de solicitudes.

Start with the games, stay for the rulings

Usa los archivos indexados de reglas y cartas para explorar el contenido disponible de cada juego.

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.