# tcgmcp

> tcgmcp is a free, unauthenticated, read-only MCP (Model Context Protocol)
> server that returns live TCGplayer market prices for trading card games.
> Paste a decklist or ask about a single card and get back resolved lines,
> prices, a total, and a buy link. No account, no API key, no setup beyond
> adding the connector URL.

## Endpoint

- URL: https://mcp.tcgmcp.com/mcp
- Transport: MCP over Streamable HTTP
- Auth: none required

## Tools

- `price_deck` — input: freeform decklist text, optional game name. Output:
  resolved lines (quantity, card name, set, unit price, line total), grand
  total, any unresolved lines with did-you-mean suggestions, and one
  affiliate-wrapped TCGplayer buy link for the whole list.
- `price_card` — input: card name, optional set/number/game. Output: best
  matching card, current market price (both nonfoil and, when available, a
  real foil price), an affiliate product link, and alternates when the name
  is ambiguous.
- `list_printings` — input: card name, optional game/set/intent. Output:
  every known printing of that card (any set it was ever printed in), each
  with nonfoil + foil prices, treatment tags (border, frame, promo, full
  art), and an affiliate buy link. Use this to compare printings or find a
  specific treatment/finish instead of just the cheapest default.
- `market_index` — input: a game (e.g. `pokemon`) or a set (`game/set`, e.g.
  `magic/fdn`), optional comma-separated `vs` compares (up to 3 scopes total),
  optional track (`all`/`singles`/`sealed`). Output: a chain-linked price
  index (base 100) with 7/30/90-day movement, the total market value of one of
  every product, the median price, and how many products are priced. Use this
  for "how is this game/set trending" instead of a single card's price.

## Coverage

Magic: The Gathering, Pokemon, Yu-Gi-Oh, One Piece, Lorcana, Flesh and Blood,
Star Wars Unlimited, Digimon, and more — 20+ trading card games, one tool.

## Install

- Claude: Settings → Connectors → Add custom connector → paste
  https://mcp.tcgmcp.com/mcp
- Claude Code: `claude mcp add --transport http tcgmcp https://mcp.tcgmcp.com/mcp`
- Cursor: add to mcp.json —
  `{"mcpServers":{"tcgmcp":{"url":"https://mcp.tcgmcp.com/mcp"}}}`
- ChatGPT: Settings → Connectors → developer mode → Add connector → paste
  https://mcp.tcgmcp.com/mcp

## Notes

- Free, no account, read-only. tcgmcp never sees or stores your collection.
- Buy links are TCGplayer affiliate links (see /terms.html) — this is how the
  free service is funded; it does not change the price shown or charged.
- Prices are sourced from TCGplayer market data, refreshed regularly.
- Personal assistant use only — not a bulk data feed. See /terms.html.

## Docs

- Home: https://tcgmcp.com
- Terms: https://tcgmcp.com/terms.html
- Privacy: https://tcgmcp.com/privacy.html

## Machine-readable

- MCP manifest: https://tcgmcp.com/.well-known/mcp.json (endpoint, all four
  tools, and their JSON Schema input definitions)
- Sitemap: https://tcgmcp.com/sitemap.xml