Valo.IA (ValoTCG)
Trading card prices for 14 TCGs (Pokémon, One Piece, Lorcana, Yu-Gi-Oh!, Magic and more): Cardmarket, US market and eBay sold prices, graded sales, PSA populations, sealed products and 365-day history. 16 read-only tools, free Sandbox key.
Размещённый MCP-сервер
npx add-mcp 'https://api.valotcg.com/mcp'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
TCG MCP server: card prices for Claude, ChatGPT and your agents
A remote MCP server for trading card games: 17 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
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
-
Get a free key
Create a Sandbox key in the portal: 500 credits a month, no card. -
Add the server
One command in Claude Code, one JSON block in Cursor, a few lines in your agent. -
Ask in plain words
Your AI picks the tools itself: identify the card, then read its price. -
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
Seventeen tools, three families
Catalogue and prices · 10 tools
The Valo.Data routes, read-only.
list_gamesList games Freesearch_cardsSearch cards 1 creditget_cardCard sheet 1 creditget_card_pricesCard prices 1 creditget_cards_batchBatch prices 1 creditget_price_historyPrice history 3 creditsget_graded_historyGraded price history 3 creditslist_editionsList editions 1 creditsearch_sealedSearch sealed products 1 creditget_sealed_pricesSealed product prices 1 credit
Analyst · 6 tools
What the ValoTCG app shows, ready to use.
identify_cardIdentify a card 1 creditprice_summaryPrice summary 1 credittop_moversTop movers 3 creditstop_pricedMost valuable 3 creditscompare_pricesCompare prices 1 creditedition_overviewEdition overview 3 credits
Vision · 1 tool
With a Valo.Vision plan, billed in scans.
scan_cardScan a card photo 1 scan
Arguments and cost of each toolThe full reference, tool by tool.
Catalogue and prices · 10 tools
data:read
The Valo.Data routes, read-only.
| Tool | Description | Arguments | Cost |
|---|---|---|---|
| list_gamesList games | Games of the catalogue with their slugs, card languages and price coverage per source. | — | 0 credit |
| search_cardsSearch cards | Search 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 sheet | Full sheet of one card: edition, number, rarity, images, marketplace ids (Growth and up). | card_id* | 1 credit |
| get_card_pricesCard prices | Current 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 prices | Current prices of up to 100 cards and sealed products (sealed:{id}) in one call. | ids* (1–100, int or sealed:{id}), include | 1 credit per call, +1 per card and include |
| get_price_historyPrice history | Daily 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, condition | 3 credits |
| get_graded_historyGraded price history | Daily sold prices of one card for one grader, grade and CCC label, eBay and GCC split, bounded by the plan's history. From Starter. | card_id*, grader*, grade* (8–10, half grades), label (gold | black), variant, date_from, date_to | 3 credits |
| list_editionsList editions | Editions (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 products | Search 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 prices | Current 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.
| Tool | Description | Arguments | Cost |
|---|---|---|---|
| identify_cardIdentify a card | Identify 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, language | 1 credit |
| price_summaryPrice summary | The 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*, include | 1 credit, +1 per include |
| top_moversTop movers | Largest 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 valuable | Most 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 prices | Price summaries of up to 10 cards and sealed products (sealed:{id}) side by side. | ids* (1–10, int or sealed:{id}), include | 1 credit, +1 per card and include |
| edition_overviewEdition overview | Chase 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.
| Tool | Description | Arguments | Cost |
|---|---|---|---|
| scan_cardScan a card photo | Recognise 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*, language | 1 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
€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.
tools/call price_summary
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "price_summary",
"arguments": {
"card_id": 28246
}
}
}
200 OK_meta.credits_used: 1X-Request-Id: req_mcp_price_summary
type
"card"
reliability
"ok"
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"
image_url
"https://cdn.valotcg.com/pokemon/fr/cards/sv/…"
cardmarket_product_id
733794
tcgplayer_product_id
517045
amount
276.02
currency
"EUR"
source
"ebay_30d"
observed_at
"2026-11-05"
window_days
30
sales_count
11
confidence
"high"
{
"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.
Pokémon API
One Piece Card Game API
Lorcana API
Yu-Gi-Oh! API
Magic: The Gathering API
Dragon Ball Super: Masters API
Dragon Ball Super: Fusion World API
Union Arena API
Riftbound: League of Legends TCG API
Cyberpunk Trading Card Game API
Naruto Mythos TCG API
Flesh and Blood TCG API
Gundam Card Game API
Star Wars: Unlimited API
FAQ
MCP server questions
The short answers. The reference lives in 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 17 read-only tools: 16 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.