The MCP server that teaches AI agents trading card games

Explore coverage for 15 listed games. The table shows which rules, glossaries, and cards are available. Agents can read available sources over MCP and cite them.

Connect an agent Explore the games

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.

Coverage, stated exactly

This table uses the generated knowledge-file manifest. It shows the sections available in this web release.

Rules, glossary, and card coverage per game in the TCG Knowledge MCP server
GameRulesGlossaryCards
Alpha ClashAvailableUnavailable 1,428
Cyberpunk TCGAvailableAvailable 155
Disney's LorcanaAvailableAvailable 2,477
Flesh and BloodAvailableAvailable 5,195
Grand ArchiveAvailableAvailable 2,495
Gundam Card GameAvailableAvailable 1,060
One Piece Card GameAvailableAvailable 2,392
Star Wars: UnlimitedAvailableAvailable 2,189
Naruto Card Game PreviewUnavailableUnavailable 35 (preview)
Digimon Card GameOfficial linksUnavailableOfficial links
Dragon Ball Super Fusion WorldOfficial linksUnavailableOfficial links
Magic: The GatheringOfficial linksUnavailableOfficial links
Pokémon TCGOfficial linksUnavailableOfficial links
Yu-Gi-Oh! TCGOfficial linksUnavailableOfficial links
RiftboundUnavailableUnavailable Unavailable

These catalogs are also available as plain text at /llm.txt.

A question for every game

Try these prompts for games with published card catalogs. They cover rules, card interactions, card search, and sets. Check the coverage table for preview or unavailable data.

Alpha Clash

“Find Alpha Clash cards with Dragon in their names. Show three examples and link the source.”

Explore source files

Cyberpunk TCG

“Can Modded Kusanagi attack when played if my Rival controls MaxTac Suppression Team? Link both cards and the rules.”

Explore source files

Disney's Lorcana

“Find Lorcana cards named Woody. Show their printed text and link the source.”

Explore source files

Flesh and Blood

“Explain Flesh and Blood priority. Cite rule 1.11 and link the TCG Online source.”

Explore source files

Grand Archive

“Find Grand Archive Merlin champion cards. List their names and link their printed text.”

Explore source files

Gundam Card Game

“Which Gundam Card Game sets are indexed? Show their card counts and link the source.”

Explore source files

One Piece Card Game

“Find One Piece cards named Monkey.D.Luffy. Distinguish leaders from characters and link their printed text.”

Explore source files

Star Wars: Unlimited

“Find Star Wars: Unlimited cards named Luke Skywalker. Compare their subtitles and link the source.”

Explore source files

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

What is the TCG Knowledge MCP server?

It is a read-only MCP server. AI agents can search the published game rules, errata, glossaries, and card catalogs through eight tools, including search_rules, search_cards, and get_card.

Which games are covered?

The table on this page lists available rules and glossary files and card counts for each indexed game. Preview cards are marked.

Is the server safe to expose to an agent?

Yes. Its tools only read public data. They cannot create, change, or delete data. HTTP requests are rate limited and answers have size limits.

How do I connect an agent today?

Connect an MCP client to https://api.tcg.online/mcp using streamable HTTP. You can also run the server from The Card Goat repository with Bun over stdio or host it over HTTP.

Does it cost anything?

No. The server is free, open source, self-hostable, and rate limited.

Start with the games, stay for the rulings

Use the indexed rules and card files to explore the available content for each game.

Browse games Learn to play

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.