Valo.IA (ValoTCG)

Valo.IA — MCP server for trading card prices

Ask your AI agent what any trading card is worth, and get a sourced, dated answer. Valo.IA is the hosted MCP server behind ValoTCG: 540,000+ card references across 14 games, with the real European price (Cardmarket in EUR), the US market price, what the card actually sold for on eBay, graded sales and PSA populations, sealed products and 365 days of history. One line of config, one API key, and your agent prices a collection, a shop inventory or a single pull like a market analyst.

Games covered: Pokémon · One Piece Card Game · Disney Lorcana · Yu-Gi-Oh! · Magic: The Gathering · Dragon Ball Super Card Game (Masters) · Dragon Ball Super Card Game Fusion World · Union Arena · Riftbound: League of Legends TCG · Cyberpunk Trading Card Game · Naruto Mythos TCG · Flesh and Blood · Gundam Card Game · Star Wars: Unlimited. Cards in English, French, Japanese and Chinese where the game prints them; the live coverage per source is at https://valotcg.com/developers/coverage.

Why agents like it

• Every price says where it comes from, in which currency and on which day. No blended figure, no silent conversion, and status: "missing" instead of a guess when a source has nothing.
• Graded and raw in the same call: eBay medians for PSA 9 and PSA 10 over 30 and 90 days next to the raw price, plus PSA and CCC populations by grade, to decide whether a card is worth grading.
• Ready-made answers: price_summary returns a recommended price with its reliability and recent change, top_movers and top_priced rank a whole set, compare_prices lines up ten cards side by side.
• Built for tooling: 16 read-only, idempotent tools, credit metering in the response, errors never billed, free Sandbox key to try.
• Endpoint: https://api.valotcg.com/mcp (Streamable HTTP, stateless, JSON responses)
• Registry name: com.valotcg/valo-ia
• Auth: Authorization: Bearer <Valo.Data API key> — initialize and tools/list work without a key; tool calls need one
• Docs: https://valotcg.com/developers/docs · Product page: https://valotcg.com/developers/ia

This repository holds the public metadata of the server (server.json), setup instructions and examples. The server itself runs on ValoTCG's infrastructure; nothing needs to be installed or built from here.

Quick start

1. Create a free Sandbox key at https://valotcg.com/developers/account (no credit card). Keys look like vd_test_… (Sandbox) or vd_live_… (paid plans).
2. Add the server to your client.

Claude Code

claude mcp add --transport http valotcg https://api.valotcg.com/mcp \
  --header "Authorization: Bearer $VALO_DATA_API_KEY"

Cursor, VS Code, Windsurf and other JSON-configured clients

{
  "mcpServers": {
    "valotcg": {
      "type": "streamable-http",
      "url": "https://api.valotcg.com/mcp",
      "headers": {
        "Authorization": "Bearer vd_live_…"
      }
    }
  }
}

1. Ask your agent something like "What is the current Cardmarket price of Charizard ex 199/165 from 151, French print?" — it will call identify_card then get_card_prices or price_summary.

Tools

All 16 tools are read-only and idempotent. Each call is metered in Valo.Data credits (the credit cost is documented per tool in tools/list); an error is never billed.

A quote that does not exist comes back with status: "missing" and a null amount, never an invented figure. Every price carries its source, currency and observation date; nothing is converted between currencies.

Behaviour and limits

• initialize and tools/list answer without a key, so directories and clients can inspect the server. A tools/call without a valid key returns a tool error (invalid_api_key, not billed) pointing to the key page.
• GET and DELETE on /mcp return 405: the server is stateless, without SSE streams or sessions.
• Coverage differs by game; the live matrix is at https://valotcg.com/developers/coverage.
• The Sandbox key is for prototyping and non-commercial use; paid plans add the commercial licence. Prices are net, VAT not applicable (art. 293 B of the French tax code). Plans: https://valotcg.com/developers/pricing.

Links

• Official MCP Registry: https://registry.modelcontextprotocol.io/v0.1/servers?search=com.valotcg/valo-ia
• Glama: https://glama.ai/mcp/connectors/com.valotcg/valo-ia
• mcptry: https://mcptry.com/servers/com.valotcg/valo-ia
• REST API (same key, same data): https://valotcg.com/developers/api/pokemon
• Contact: <contact@valotcg.com>

Licence

The files in this repository are released under the MIT licence (see LICENSE). Use of the Valo.IA service itself is governed by the API terms.