Valo.IA (ValoTCG)

com.valotcgPublished by valotcg.comOfficial publisherv1.0.1Updated Nov 4, 2026

Trading card prices and sheets for Pokémon and 13 other TCGs: Cardmarket, US market, eBay, PSA

VerifiedStreamable HTTPWeb executableFinance

Overview

Valo.IA (ValoTCG)'s hosted MCP server (api.valotcg.com), published by valotcg.com; API key required; Streamable HTTP; 16 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Publisher
valotcg.com
Endpoint
api.valotcg.com
Last checked

Installation

In SourceWeft

  1. Open Valo.IA (ValoTCG) in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.valotcg%2Fvalo-ia/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "valo-ia-valotcg": {
      "type": "http",
      "url": "https://api.valotcg.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Valo.IA — MCP server for trading card prices

[mcptry] [MCP Registry] [Valo.IA (ValoTCG) MCP connector – tool definition quality and endpoint health on Glama]

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

sh
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

json
{  "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.

ToolWhat it does
list_gamesThe 14 games listed above, their card languages and per-source coverage. Free.
list_editionsSets and expansions of a game, searchable by name or set code.
search_cardsSearch cards by name (FR/EN), number, edition, language or rarity.
get_cardOne card sheet: name, number, rarity, image, Cardmarket and US market ids.
get_card_pricesCurrent prices of a card per source, each dated; optional graded medians and PSA/CCC populations.
get_cards_batchPrices for up to 100 cards or sealed products in one call.
get_price_historyDaily history of one source for a card, up to 365 days, one point per observed day.
search_sealedSearch sealed products (boosters, displays, ETBs, boxes).
get_sealed_pricesCurrent prices of a sealed product per source.
identify_cardFind a card from free text such as "dracaufeu 199 151 fr".
price_summaryRecommended price, reliability and recent changes of a card or sealed product.
compare_pricesPrice summaries of up to 10 cards and sealed products side by side.
top_moversLargest price rises or falls of a game or an edition over 7, 30 or 90 days.
top_pricedMost valuable cards or sealed products of a game, an edition or a language.
edition_overviewChase cards, sealed products and price coverage of an edition.
scan_cardRecognise a card from a photo and return its Valo.Data ids (keys with the Vision scope only).

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

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.

Source: README.md at commit 608d69f

Tools

16

list_games

List games

Games of the catalogue with their slugs, card languages and price coverage per source. 0 credit.

Takes no parameters.

search_cards

Search cards

Search the cards of a game by name or number, edition, language or rarity. 1 credit per page.

Parametersqgamerequiredcursorraritylanguagepage_sizeedition_id

get_card

Card sheet

Full sheet of one card: edition, number, rarity, images, marketplace ids (Growth and up). 1 credit.

Parameterscard_idrequired

get_card_prices

Card prices

Current prices of one card from Cardmarket, the US market and eBay sales, each in its native currency. 1 credit, +1 per include.

Parameterscard_idrequiredinclude

get_cards_batch

Batch prices

Current prices of up to 100 cards and sealed products (`sealed:{id}`) in one call. 1 credit per call, +1 per card and include.

Parametersidsrequiredinclude

get_price_history

Price history

Daily price history of one source for a card or a sealed product, bounded by the plan's history. 3 credits.

Parameterssourcerequiredcard_iddate_tovariantconditiondate_fromsealed_idmarket_language

list_editions

List editions

Editions (sets) of a game, newest first, with their ids; `q` finds one by its name or set code. 1 credit per page.

Parametersqgamerequiredcursorlanguagepage_size

search_sealed

Search sealed products

Search the sealed products of a game (boosters, displays, ETB…) by name, edition, type or language. 1 credit per page.

Parametersqgamerequiredcursorlanguagepage_sizeedition_idproduct_type

get_sealed_prices

Sealed product prices

Current prices of one sealed product, each source in its native currency. 1 credit.

Parameterssealed_idrequired

identify_card

Identify 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. 1 credit.

Parametersgamequeryrequiredlanguage

price_summary

Price 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. 1 credit, +1 per include.

Parameterscard_idincludesealed_id

top_movers

Top movers

Largest price rises or falls of a game or an edition over 7, 30 or 90 days (cards of 10 EUR and more). 3 credits.

Parametersgamerequiredlimitperiodlanguagereliabledirectionedition_id

top_priced

Most 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. 3 credits.

Parametersgamerequiredkindrequiredlimitlanguageedition_idproduct_type

compare_prices

Compare prices

Price summaries of up to 10 cards and sealed products (`sealed:{id}`) side by side. 1 credit, +1 per card and include.

Parametersidsrequiredinclude

edition_overview

Edition overview

Chase cards, sealed products with prices and price coverage of one edition. 3 credits.

Parametersedition_idrequired

scan_card

Scan 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. 1 scan per analysed photo; a refused photo or an error costs nothing. Photos are processed in memory and never stored.

Parametersgamerequiredimagerequiredlanguage

Version history

2
  1. v1.0.1LatestNov 4, 2026
  2. v1.0.0Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts