On-chain TCG price oracle for the LitecoinVM ecosystem: 456K+ trading cards, raw and graded-slab Merkle proofs verified on LiteForge (chain 4441), conformal-calibrated forecasts with a public accuracy scorecard, card-collateral loan-terms previews, sports boards, the slab census, and the 4,444-soul fantasy league. 13 tools, all free, no keys.
Scored across 16 tools
While each tool has a distinct core function, there is significant overlap between get_forecast and simulate_price (both provide price forecasts, with get_forecast as the recommended default). Also, the dataset is confusingly split between frozen USD-dependent tools (get_price, search_cards, simulate_price, get_forecast, get_market_snapshot) and live alternatives (get_graded_asks, get_jp_summary, get_sports_board). This split could cause agents to select outdated or suspended tools if not careful.
Most tools follow a consistent verb_noun or noun_noun pattern (get_price, get_forecast, search_cards, simulate_price, oracle_status). However, oracle_status breaks the get_ prefix pattern, and get_jp_summary uses an abbreviation that is slightly less descriptive, but overall the naming is very predictable and readable.
16 tools is slightly on the heavier side but still within a reasonable range for a comprehensive TCG oracle covering market data, proofs, forecasts, loans, fantasy, and sports. Each tool appears to earn its place by covering a distinct aspect of the oracle's services, though some consolidation could reduce redundancy (e.g., merging forecast and simulation).
The tool surface is quite comprehensive, covering price retrieval, search, forecasts, simulations, loan terms, census, proofs, sports, fantasy, and status. However, there is no tool for directly creating or updating data (which may be appropriate for an oracle), and the suspended get_market_snapshot leaves a gap in market overview that is only partially filled by other tools. Also, raw-card loan quotes are no longer issued, indicating a deliberate reduction in coverage.
Observed graded-slab census totals: how many PSA/BGS/CGC/TAG slabs the oracle tracks circulating on the open market (cert-verified; a census of what is listed and pressing on price — NOT a pop report). Census leaves are committed on-chain daily.
Inputs: no named parameters. Returns: result
The Undesirables fantasy league on LitecoinVM: 4,444 AI personalities draft weekly fantasy lineups over the oracle's calibrated sports forecasts. Every lineup is merkle-committed to the PredictionRegistry on LiteForge (stream fantasy_souls) BEFORE games score. No token_id: league feed with standings and the week's commit txs. With token_id: that soul's lineup, personality traits, and drafting strategy.
Inputs: token_id. Returns: result
FROZEN INPUTS since 2026-09-07: the USD price series stopped, so this is computed from the last published prices; responses carry usd_panel {frozen: true, as_of}. Say "last published", never "today". Get the calibrated conformal risk forecast for a trading card.
This is the recommended, honest default forecast — distribution-free, deterministic, and never-under-protective. Unlike a Monte Carlo simulation it makes NO distributional assumption: the bands are calibrated on real cross-card price history, so the stated risk is honest out-of-sample (a "5% VaR" means a ~5% loss happens about 5% of the time). Each card also gets two plain-English letter grades.
Inputs: card_name (required). Returns: result
Graded-slab ASKING prices for one card — PSA/BGS/CGC medians by grade with listing counts, low/high, as-of per grade and the explicit price_basis (eBay asks, not sold prices). FREE, daily, merkle-committed on GradedPriceOracle. The LIVE value layer while the USD raw-card panel is frozen, and the basis of the graded-slab loan terms.
Inputs: product_id (required). Returns: result
Merkle proof for a GRADED-slab price on the GradedPriceOracle contract (LiteForge, Chain 4441). The graded price tree is committed on-chain daily — this proof lets any agent verify a slab price trustlessly, the same way get_merkle_proof verifies raw-card prices. Grades like 'PSA 10', 'PSA 9', 'BGS 9.5'.
Inputs: product_id (required), grade. Returns: result
The JAPANESE card market today as numbers — no card names or prices: cards priced this morning (365K+ across 24 games, ~167K with BOTH an ask and a dealer buyback bid), the bid as a share of ask per price band (a bulk floor under ~¥300, a real quote above), per-game depth, how much of the board moved since yesterday and a week ago, and the day's Merkle root with both chain txs. FREE. The Japanese panel is LIVE while the USD panel is frozen. Per-card is https://oracle.the-undesirables.com/jp/card/{game}/{set_code}/{card_id} (one card per request; there is deliberately no listing route).
Inputs: no named parameters. Returns: result
FREE worked derivation of GRADED-SLAB lending terms (v2, 2026-09-12): live slab value (realized sales > delisting-inferred sales > ask median x 0.85) -> historical 99% tail of the underlying card -> liquidation buffer -> census liquidity cap -> max LTV, six steps shown. grade e.g. "PSA 10"; omitted = the slab's deepest-census grade. term_days: 7, 14 or 30. Only free-board slabs (top 250 by census depth) return the derivation; others 404 with a pointer to the full quote at /api/v1/loan-terms (free since 2026-10-02, when pay-per-call was paused; ~1,100 rated slabs). Raw-card quotes are no longer issued (USD level frozen 2026-09-07). Informational only — not financial advice.
Inputs: product_id (required), grade, term_days. Returns: result
The graded slabs the Loan-Terms Oracle will quote, best collateral first: grade, live ask median, census depth, liquidity tier, rank and a free_board flag (the top 250 by census depth carry a free derivation via get_loan_terms_preview). FREE. v2: graded slabs only — raw-card quotes stopped when the USD level froze 2026-09-07.
Returns a PAGE, not the whole book: the full universe is ~1,400 slabs and
serialises to ~865 KB, which would swamp an agent's context in one call.
total_matching and returned say what you are holding.
limit rows to return (default 50, max 500) tier 'deep' | 'moderate' | 'thin' | 'illiquid' free_board_only True to keep only slabs with a free worked derivation min_value_usd drop slabs whose ask median is below this (0 = no floor)
Inputs: tier, limit, min_value_usd, free_board_only. Returns: result
SUSPENDED 2026-09-12: the USD price panel behind /api/v1/market froze on 2026-09-07. The oracle answers {"status": "suspended"} with the reason and live alternatives (no charge). Prefer get_sports_board, get_loan_terms_preview (graded slabs, live) or get_census_summary. Get a market overview — top trading cards sorted by value.
Returns the highest-value cards for a specific game with current market prices and low (buy-it-now) prices.
Games: Pokemon, Magic, Yu-Gi-Oh, One Piece, Disney Lorcana, Flesh and Blood, Dragon Ball Super, Digimon, Star Wars, Union Arena, MetaZoo, Cardfight Vanguard, My Hero Academia.
Inputs: game, limit. Returns: result
Get a Merkle proof for on-chain price verification on LitecoinVM.
WHY THIS MATTERS FOR AI AGENTS: Regular API prices require trusting the server. Merkle proofs let you VERIFY the price on-chain without trusting anyone. The proof is a cryptographic guarantee that this exact price was committed to the LitecoinVM blockchain by the oracle operator.
The TCG Price Oracle commits 284K actively-priced products to a single Merkle root on LiteForge daily. This tool returns the proof array that can be submitted to the MerklePriceOracle smart contract to trustlessly verify any card's price.
NOTE: Only actively-priced products (market_price > 0) are included in the Merkle tree. Zero-price catalog entries cannot be proven.
Inputs: product_id (required). Returns: result
The oracle's public accuracy record — verify before trusting. Rolling 30-day coverage on matured forecasts (recent: 90% bands covered 93%+ across 181K+ graded predictions), the souls' scored track record, and the blind slab study. Every scored prediction was committed to LiteForge
Base before its outcome existed, so the table cannot be curated.
Inputs: no named parameters. Returns: result
FROZEN INPUTS since 2026-09-07: the USD price series stopped, so this is computed from the last published prices; responses carry usd_panel {frozen: true, as_of}. Say "last published", never "today". Get the latest market price and historical price data for a trading card.
Provide either a card name (fuzzy search) or a TCGPlayer product ID. Returns current market price, low (buy-it-now) price, and daily price history for the requested time window.
The price history is what powers the Monte Carlo simulation — it's the same data used to calibrate drift and volatility parameters.
Inputs: days, card_name, product_id. Returns: result
Daily sports movers — hot, high-volume players per live league with calibrated 7-day forecast context. The underlying stat panels are merkle-committed daily to SportsStatsRegistryV2 on LiteForge + Base. Off-season leagues report dormant instead of serving frozen numbers.
Inputs: limit, league. Returns: result
Get live status of the TCG Price Oracle on LitecoinVM.
Reads DIRECTLY from the LiteForge blockchain (Chain ID 4441) via the Caldera RPC endpoint — this is NOT cached data, it's a live on-chain read at the moment you call it.
Returns: • MerklePriceOracle: current root, total products, freshness, update count • TCGPriceOracleV2: total TWAP updates, last update timestamp • Network: connection status, chain ID, RPC URL, explorer link • Database: card count, price rows, latest data date (from API)
No arguments required.
Inputs: no named parameters. Returns: result
FROZEN INPUTS since 2026-09-07: the USD price series stopped, so this is computed from the last published prices; responses carry usd_panel {frozen: true, as_of}. Say "last published", never "today". Search 446K+ trading card products by name using full-text search.
The catalog contains 446K products total — 284K are actively priced with current market data. ~157K are catalog-only entries (tokens, promos, bundles) with no price history. Disney Lorcana, Flesh & Blood, Dragon Ball Super, Digimon, Star Wars, Union Arena, MetaZoo, Cardfight Vanguard, and My Hero Academia.
Returns product IDs (needed for get_price and get_merkle_proof), card names, games, and current market prices.
Inputs: query (required), game, limit. Returns: result
FROZEN INPUTS since 2026-09-07: the USD price series stopped, so this is computed from the last published prices; responses carry usd_panel {frozen: true, as_of}. Say "last published", never "today". Run a Monte Carlo price simulation for a trading card (opt-in).
For the honest DEFAULT forecast — conformal VaR + Safe-Hold/Momentum grades — use get_forecast. This tool is the stochastic Monte Carlo alternative (Merton/GBM).
HOW THE MATH WORKS: This is NOT fake data. The simulation calibrates parameters from REAL market prices stored in the oracle database (26.9M+ price observations):
Look up the card → get product_id via FTS5 search
Pull up to 365 days of daily price history
Resample to weekly buckets for stable drift estimates
Compute annualized drift (μ) and volatility (σ)
Detect price jumps via 2σ threshold on time-scaled returns
Run 10,000+ vectorized numpy simulation paths
Return percentile forecast bands + risk metrics
If insufficient price history exists (<5 data points), conservative TCG market priors are used (3% drift, 40% vol) and clearly labeled as "default_tcg_priors" in the response.
Inputs: card_name (required), days, model, simulations. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Add one secure layer between your agents and this server.