Valo.IA (ValoTCG)

Precios de cartas coleccionables de 14 TCG (Pokémon, One Piece, Lorcana, Yu-Gi-Oh!, Magic y más): precios de Cardmarket, del mercado estadounidense y de ventas completadas en eBay, ventas de cartas graduadas, poblaciones de PSA, productos sellados e historial de 365 días. 16 herramientas de solo lectura, clave Sandbox gratuita.

Servidor MCP alojado

npx add-mcp 'https://api.valotcg.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

TCG MCP server: card prices for Claude, ChatGPT and your agents

A remote MCP server for trading card games: 16 read-only tools over the catalogue and prices of 14 games, from Pokémon and Magic: The Gathering to One Piece and Yu-Gi-Oh!. Your AI calls a tool, the server answers with sourced, dated prices.

Works withClaudeClaude CodeCursorVS CodeWindsurfChatGPTPythonNode.jsn8n

Your AI clientvalotcg · connected

How much is the Dracaufeu ex 199 from 151, in French?

Dracaufeu-ex 199 · 151

Dracaufeu-ex 199 · 151

Recommended price

€276.02

ebay_30d · observed on Nov 5, 2026

Real answer, captured from production on Nov 7, 2026.

How it works

From the key to the price, in four steps

  1. Get a free key

    Create a Sandbox key in the portal: 500 credits a month, no card.
  2. Add the server

    One command in Claude Code, one JSON block in Cursor, a few lines in your agent.
  3. Ask in plain words

    Your AI picks the tools itself: identify the card, then read its price.
  4. Get sourced prices

    Every price comes back with its source and its date, never a guess.

Setup

Connect your AI client in one command

POST https://api.valotcg.com/mcp

  • One key. Your Valo.Data key in an Authorization header, never in the URL.
  • Nothing to host. A remote server over Streamable HTTP: no local process, no install.
  • Free to list. initialize and tools/list cost nothing; a tool costs the credits of its REST route.
#!/usr/bin/env sh
# Valo.Data (and Valo.Vision with a Vision plan) as tools of Claude Code, over MCP (Streamable HTTP).
# VALO_DATA_API_KEY=vd_live_... sh claude_code.sh
# Every tool call spends the credits of its REST route (identify_card 1, price_summary 1, top_movers 3...);
# errors are never billed. The key travels in a header, never in the URL. \`--scope user\` keeps it in your own
# ~/.claude.json for every project; never put it in a committed .mcp.json.
claude mcp add --transport http --scope user valotcg https://api.valotcg.com/mcp \
  --header "Authorization: Bearer $VALO_DATA_API_KEY"

# Check the connection and the tools your key opens:
# claude mcp get valotcg
# Then ask, for instance: "Combien vaut Dracaufeu ex 199/165 de 151 en français, et sa tendance sur 30 jours ?"
{
  "mcpServers": {
    "valotcg": {
      "url": "https://api.valotcg.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VALO_DATA_API_KEY}"
      }
    }
  }
}
"""Valo.Data over MCP with the official Python SDK (Python 3.10+, \`pip install "mcp>=2.3"\`).

Usage: VALO_DATA_API_KEY=vd_live_... python python_client.py "dracaufeu 199 151 fr"
Identifies the card from free text (1 credit), then prints the price the ValoTCG app shows (1 credit).
A tool result carries the REST JSON in \`structured_content\` and the credits spent in \`meta\`; a refused call is a
result with \`is_error\` and the stable error code (\`card_not_found\`, \`quota_exceeded\`...), never billed.
Cursor: copy cursor/mcp.json to .cursor/mcp.json. Claude Code: see claude_code.sh.
"""

import asyncio
import os
import sys

import httpx2
from mcp import Client
from mcp.client.streamable_http import streamable_http_client

URL = os.environ.get("VALO_DATA_API_URL", "https://api.valotcg.com") + "/mcp"
KEY = os.environ["VALO_DATA_API_KEY"]

async def call(client: Client, tool: str, arguments: dict) -> dict:
    result = await client.call_tool(tool, arguments)
    if result.is_error:
        error = result.structured_content["error"]
        sys.exit(f"{tool}: {error['code']}: {error['message']} ({error['request_id']})")
    print(f"{tool}: {result.content[0].text} ({result.meta['credits_used']} credit(s))")
    return result.structured_content

async def main(query: str) -> None:
    headers = {"Authorization": f"Bearer {KEY}", "User-Agent": "valo-mcp-example/1.0"}
    async with httpx2.AsyncClient(headers=headers, timeout=httpx2.Timeout(30.0)) as http:
        async with Client(streamable_http_client(URL, http_client=http)) as client:
            print("Tools:", ", ".join(tool.name for tool in (await client.list_tools()).tools))
            candidates = (await call(client, "identify_card", {"query": query}))["candidates"]
            if not candidates:
                sys.exit(f"No card matches {query!r}.")
            card = candidates[0]["card"]
            summary = await call(client, "price_summary", {"card_id": card["card_id"]})

    price = summary["recommended"]  # amount is null when no source qualifies: never estimate it
    shown = f"{price['amount']} EUR ({price['source']})" if price["amount"] is not None else "no price yet"
    print(f"{card['name']} {card['number']} [{card['language']}]: {shown}, reliability {summary['reliability']}.")
    print("Data: ValoTCG")

if __name__ == "__main__":
    asyncio.run(main(" ".join(sys.argv[1:]) or "dracaufeu 199 151 fr"))

The key travels in a header, never in the URL; initialize and tools/list are free.

Tools

Sixteen tools, three families

Catalogue and prices · 9 tools

The Valo.Data routes, read-only.

  • list_games List games Free
  • search_cards Search cards 1 credit
  • get_card Card sheet 1 credit
  • get_card_prices Card prices 1 credit
  • get_cards_batch Batch prices 1 credit
  • get_price_history Price history 3 credits
  • list_editions List editions 1 credit
  • search_sealed Search sealed products 1 credit
  • get_sealed_prices Sealed product prices 1 credit

Analyst · 6 tools

What the ValoTCG app shows, ready to use.

  • identify_card Identify a card 1 credit
  • price_summary Price summary 1 credit
  • top_movers Top movers 3 credits
  • top_priced Most valuable 3 credits
  • compare_prices Compare prices 1 credit
  • edition_overview Edition overview 3 credits

Vision · 1 tool

With a Valo.Vision plan, billed in scans.

  • scan_card Scan a card photo 1 scan

Arguments and cost of each toolThe full reference, tool by tool.

Catalogue and prices · 9 tools

data:read

The Valo.Data routes, read-only.

ToolDescriptionArgumentsCost
list_gamesList gamesGames of the catalogue with their slugs, card languages and price coverage per source.—0 credit
search_cardsSearch cardsSearch the cards of a game by name or number, edition, language or rarity.game*, q, edition_id, language, rarity, cursor, page_size (20)1 credit per page
get_cardCard sheetFull sheet of one card: edition, number, rarity, images, marketplace ids (Growth and up).card_id*1 credit
get_card_pricesCard pricesCurrent prices of one card from Cardmarket, the US market and eBay sales, each in its native currency.card_id*, include [graded, population]1 credit, +1 per include
get_cards_batchBatch pricesCurrent prices of up to 100 cards and sealed products (sealed:{id}) in one call.ids* (1–100, int or sealed:{id}), include1 credit per call, +1 per card and include
get_price_historyPrice historyDaily price history of one source for a card or a sealed product, bounded by the plan's history.card_id | sealed_id*, source*, variant, date_from, date_to, market_language, condition3 credits
list_editionsList editionsEditions (sets) of a game, newest first, with their ids; q finds one by its name or set code.game*, q, language, cursor, page_size (50)1 credit per page
search_sealedSearch sealed productsSearch the sealed products of a game (boosters, displays, ETB…) by name, edition, type or language.game*, q, edition_id, product_type, language, cursor, page_size (20)1 credit per page
get_sealed_pricesSealed product pricesCurrent prices of one sealed product, each source in its native currency.sealed_id*1 credit

Analyst · 6 tools

data:read

What the ValoTCG app shows, ready to use.

ToolDescriptionArgumentsCost
identify_cardIdentify a cardIdentify a card from free text (name, number, edition, language in any order, typos tolerated): up to 5 candidates, best first, with the signals that matched.query* (2–120), game, language1 credit
price_summaryPrice summaryThe price the ValoTCG app shows for a card or a sealed product, in EUR, with its source, reliability and 7, 30 and 90-day changes.card_id | sealed_id*, include1 credit, +1 per include
top_moversTop moversLargest price rises or falls of a game or an edition over 7, 30 or 90 days (cards of €10 and more).game*, period (30), direction (up), edition_id, language, limit (10)3 credits
top_pricedMost valuableMost valuable cards or sealed products of a game, by the price the ValoTCG app shows (EUR): every edition and language, or one edition, one language, one sealed product type.game*, kind* (card | sealed), language, edition_id, product_type, limit (10)3 credits
compare_pricesCompare pricesPrice summaries of up to 10 cards and sealed products (sealed:{id}) side by side.ids* (1–10, int or sealed:{id}), include1 credit, +1 per card and include
edition_overviewEdition overviewChase cards, sealed products with prices and price coverage of one edition.edition_id*3 credits

Vision · 1 tool

vision:scan

With a Valo.Vision plan, billed in scans.

ToolDescriptionArgumentsCost
scan_cardScan a card photoRecognise the card in a photo (Valo.Vision): up to 5 Valo.Data cards, best first; chain with price_summary for its price. JPEG, PNG or WebP of 8 MB at most, shortest side at least 480 px. Photos are processed in memory and never stored.image* (base64 or data URL), game*, language1 scan per analysed photo; refused photo or error: 0

The real list comes from tools/list, filtered by the key's scopes. An unknown tool returns a JSON-RPC -32602 error; the body of a call is limited to 12 MB (413 image_too_large beyond).

Example

A real price_summary call

Dracaufeu-ex 199 · 151

Dracaufeu-ex 199 · 151

€276.02

recommended price

ebay_30d

source

structuredContent is the exact JSON of the REST route: recommended price, reliability, 7, 30 and 90-day changes and the quotes per source. The call costs 1 credit, reported in _meta.credits_used.

Answer captured from production on November 7, 2026, truncated for the page.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "price_summary",
    "arguments": {
      "card_id": 28246
    }
  }
}
{
  "type": "card",
  "card": {
    "card_id": 28246,
    "game": "pokemon",
    "name": "Dracaufeu-ex",
    "name_en": "Charizard ex",
    "number": "199",
    "rarity": "Illustration spéciale rare",
    "rarity_code": "special_illustration_rare",
    "language": "fr",
    "edition": {
      "id": 358,
      "name": "151",
      "code": "MEW",
      "release_date": "2023-09-22"
    },
    "image_url": "https://cdn.valotcg.com/pokemon/fr/cards/sv/sv03.5/tcg517045-cm733794-fr-28246-dracaufeu-ex.webp",
    "variants": [
      "default"
    ],
    "cardmarket_product_id": 733794,
    "tcgplayer_product_id": 517045
  },
  "recommended": {
    "amount": 276.02,
    "currency": "EUR",
    "source": "ebay_30d",
    "observed_at": "2026-11-05",
    "window_days": 30,
    "sales_count": 11,
    "confidence": "high"
  },
  "reliability": "ok",
  "changes": [
    {
      "period_days": 7,
      "change_pct": -0.42,
      "source": "us_market"
    },
    {
      "period_days": 30,
      "change_pct": -10.35,
      "source": "ebay"
    },
    {
      "period_days": 90,
      "change_pct": -10.84,
      "source": "ebay"
    }
  ],
  "prices": [
    {
      "source": "cardmarket",
      "metric": "trend",
      "amount": 311.86,
      "currency": "EUR",
      "variant": "default",
      "card_language": "fr",
      "market_language": "global",
      "observed_at": "2026-11-07",
      "computed_at": "2026-11-07T10:49:16.214577Z",
      "status": "available"
    },
    {
      "source": "cardmarket",
      "metric": "low",
      "amount": 150,
      "currency": "EUR",
      "variant": "default",
      "card_language": "fr",
      "market_language": "global",
      "observed_at": "2026-11-07",
      "computed_at": "2026-11-07T10:49:16.214577Z",
      "status": "available"
    },
    {
      "source": "cardmarket",
      "metric": "low",
      "amount": 330,
      "currency": "EUR",
      "variant": "default",
      "card_language": "fr",
      "market_language": "fr",
      "observed_at": "2026-11-03",
      "computed_at": "2026-11-07T10:49:16.214577Z",
      "status": "available",
      "condition": "NM",
      "conditions": [
        {
          "condition": "NM",
          "amount": 330
        }
      ]
    }
  ]
}

What it costs

The credits of your Data plan, nothing else

No pricing of its own: a tool costs exactly what its REST route costs, and the per-minute limits are those of the Valo.Data plan.

Valo.Data

1 to 3 credits

per tool call

Valo.Data credits

The fourteen Data tools debit the credits of the organization's Valo.Data plan, Sandbox included, at the rates of the routes.

Valo.Vision

1 scan

per photo

Valo.Vision scans

scan_card debits one scan of the Valo.Vision plan per analysed photo; it only shows up in tools/list with the vision:scan scope.

Never billed

0 credit

errors included

Never billed

initialize, tools/list and list_games are free. An error, whatever it is, costs nothing: invalid argument, unknown card, exhausted quota, saturated service.

initializenotifications/initializedtools/listlist_games

API by game

One API for every card game

Catalogue, prices and grades of every game under the same key: pick yours.

FAQ

MCP server questions

The short answers. The reference lives in the documentation.

Open the documentation

What is the ValoTCG MCP server?

A remote Model Context Protocol server at https://api.valotcg.com/mcp. It gives an AI client 16 read-only tools: 15 over the Valo.Data catalogue and prices of 14 trading card games, and a photo scan with a Valo.Vision plan. The transport is stateless Streamable HTTP, with the API key in an Authorization header.

Which MCP clients does it work with?

Claude, ChatGPT, Cursor and any client or agent framework that connects to a remote Streamable HTTP server with a bearer header. The server is published on the official MCP Registry as com.valotcg/valo-ia.

How much does the TCG MCP server cost?

It has no pricing of its own: a tool costs the credits of its REST route, 1 for a read, a search or a price summary, 3 for a page of price history, top movers, top priced or an edition overview. initialize and tools/list are free. A free Sandbox key holds 500 credits a month and 100 billed requests a day.

Which card games and price sources does it cover?

14 games, among them Pokémon, Magic: The Gathering, One Piece, Yu-Gi-Oh! and Disney Lorcana. Prices come from Cardmarket in EUR, the US market in USD and eBay sales, each in its native currency. The coverage page lists what each game holds today, source by source.

Can the AI invent a price?

The tools return data, not text to complete: every quote carries its source, its currency and its observation date, and a price that is not available comes back with amount null and a status instead of an estimate. What the model writes next is up to your client; the figures it receives are sourced.

Do I need a Valo.IA plan to use the MCP server?

No. The MCP server runs on a Valo.Data key and its credits, the free Sandbox key included. Valo.IA is a separate product: an assistant and an API of ready-to-show answers.

Plug your AI into card prices

A free Sandbox key gives 500 credits a month to prototype, no card required. Paid plans from €19 a month add the commercial licence.

VAT not applicable, art. 293 B of the French tax code.