# tcgdata.dev

> REST API and MCP tools for trading-card metadata, current EUR prices and measured daily history across six catalogues.

The v1 API uses one request per admitted HTTP call, including batches, images, usage and admitted errors. Images use authenticated API paths. Live data access requires an activated account. History and metadata depend on available source data. Examples are synthetic; replace placeholder IDs with values returned by the catalogue.

## Start here

- [Agent quickstart](https://tcgdata.dev/docs/agents/index.md): Identity, workflow and request accounting rules.
- [Authentication](https://tcgdata.dev/docs/agents/authentication.md): Activated API keys, origins and server-side credentials.
- [Cursor, Codex and Claude Code setup](https://tcgdata.dev/docs/agents/clients.md): API-key client configurations, local STDIO and connection checks.
- [MCP connection and tools](https://tcgdata.dev/docs/agents/mcp.md): HTTP connection, tool schemas and structured results.
- [Errors and limits](https://tcgdata.dev/docs/agents/errors.md): Actionable recovery, reset times and retry instructions.
- [OpenAPI 3.1](https://tcgdata.dev/openapi.json): Complete machine-readable REST input/output schemas.

## Task recipes

- [Find a Japanese Pokémon card](https://tcgdata.dev/docs/agents/recipes/japanese-card.md): Find the source card, identify its printing and follow an explicit price-variant reference.
- [Sync inventory prices across games](https://tcgdata.dev/docs/agents/recipes/inventory-prices.md): Resolve exact variants once and sync a mixed-game inventory in batches.
- [Compare measured daily prices](https://tcgdata.dev/docs/agents/recipes/compare-history.md): Compare exact variants over a shared UTC date window and preserve observation gaps.

## REST operations

- [GET /v1/catalog/variants/{id}/history](https://tcgdata.dev/docs/agents/endpoints/variant-history.md): Read history without a current price
- [GET /v1/catalog/variants](https://tcgdata.dev/docs/agents/endpoints/variant-search.md): Browse stored card metadata
- [GET /v1/catalog/variants/{id}](https://tcgdata.dev/docs/agents/endpoints/variant-detail.md): Get metadata without requiring a price
- [GET /v1/cards](https://tcgdata.dev/docs/agents/endpoints/search.md): Search priceable cards
- [GET /v1/cards/{id}](https://tcgdata.dev/docs/agents/endpoints/detail.md): Get card details
- [GET /v1/cards/{id}/image](https://tcgdata.dev/docs/agents/endpoints/image.md): Download a card image
- [GET /v1/cards/{id}/prices](https://tcgdata.dev/docs/agents/endpoints/price.md): Get current prices
- [POST /v1/prices/batch](https://tcgdata.dev/docs/agents/endpoints/batch.md): Batch prices across games
- [GET /v1/cards/{id}/history](https://tcgdata.dev/docs/agents/endpoints/history.md): Get daily price history
- [GET /v1/{game}/{language}/cards](https://tcgdata.dev/docs/agents/endpoints/readable-search.md): Search by game and language
- [GET /v1/{game}/{language}/cards/{slug}](https://tcgdata.dev/docs/agents/endpoints/readable-detail.md): Get a readable card
- [GET /v1/{game}/{language}/cards/{slug}/prices](https://tcgdata.dev/docs/agents/endpoints/readable-price.md): Get readable prices
- [GET /v1/{game}/{language}/cards/{slug}/history](https://tcgdata.dev/docs/agents/endpoints/readable-history.md): Get readable history
- [GET /v1/catalog/cards](https://tcgdata.dev/docs/agents/endpoints/catalog-search.md): Browse cards independently of prices
- [GET /v1/catalog/cards/{id}](https://tcgdata.dev/docs/agents/endpoints/catalog-detail.md): Get a Japanese catalogue card
- [GET /v1/catalog/sets](https://tcgdata.dev/docs/agents/endpoints/catalog-sets.md): Browse Japanese sets
- [GET /v1/usage](https://tcgdata.dev/docs/agents/endpoints/usage.md): Check shared usage

## Field references

- [Pokémon](https://tcgdata.dev/docs/agents/fields/pokemon.md): game=pokemon, artwork language=en
- [Pokémon JP](https://tcgdata.dev/docs/agents/fields/pokemon_jp.md): game=pokemon_jp, artwork language=ja
- [Magic: The Gathering](https://tcgdata.dev/docs/agents/fields/magic.md): game=magic, artwork language=en
- [Lorcana](https://tcgdata.dev/docs/agents/fields/lorcana.md): game=lorcana, artwork language=en
- [One Piece](https://tcgdata.dev/docs/agents/fields/onepiece.md): game=onepiece, artwork language=en
- [Yu-Gi-Oh!](https://tcgdata.dev/docs/agents/fields/yugioh.md): game=yugioh, artwork language=en
- [Response diagnostics](https://tcgdata.dev/docs/agents/fields/diagnostics.md)
- [Japanese source-card fields](https://tcgdata.dev/docs/agents/fields/catalogue.md)

## Optional

- [Human quickstart](https://tcgdata.dev/docs)
- [Interactive API reference](https://tcgdata.dev/api-reference)