Search 449K+ TCG products across 25+ card games.
Returns card names and IDs, plus current market prices.
FREE — no payment required.
Use this when: a user asks about a specific card, wants to find cards,
or needs current pricing for any trading card game product.
HOW TO SEARCH (card name AND set n
market_snapshot
Daily TCG market snapshot with top movers, biggest gainers/losers,
and volume leaders across all 25 supported card games.
PAID: $0.025 USDC per call (x402 — USDC on Base or Solana, or USDG on
Robinhood Chain). Previously documented as FREE, which was wrong: the server
has always returned a 402 for
grade_card
AI-grade a trading card image using a 3-stage pipeline:
(1) Qwen Vision LLM analyzes corners, edges, surface defects
(2) OpenCV measures exact centering ratios programmatically
(3) BGS professional capping algorithm adjusts the final grade
Returns PSA/Beckett-calibrated subgrades and an overall con
grade_or_not
Answers: "Should I grade this card? Will I make money?"
Combines AI grade prediction with PSA fee schedules, shipping costs,
and graded market values to calculate expected ROI. Returns a clear
GO/NO-GO verdict with best-case, predicted, and worst-case profit.
PAID: $0.10 USDC per call.
Use this w
simulate_price
Predict future trading card value. The default model is the
conformal-calibrated risk forecast (deterministic drift + regime-aware
split-conformal bands, honest VaR/CVaR, plus Safe-Hold & Momentum letter
grades). Monte Carlo GBM and Merton jump-diffusion are available opt-in
via model="gbm" or model
card_forecast
Get the conformal-calibrated 30-day price forecast AND letter grades for a
single card in ONE free call. Pass either a card_name (resolved to the best
match) or a TCGplayer product_id.
FREE — no payment required. Returns an agent-complete object:
price, as_of, regime, point (median 30d), move_pct
trending_cards
Top trading cards by PRICE VELOCITY (drift), highest absolute movement first.
NOTE (corrected 2026-07-30): this previously claimed "30-day sales volume".
Sales volume and view counts are NOT in the dataset and the API itself now
explicitly disclaims them — see `ranked_by` in the response.
Each row
optimize_portfolio
Optimize a trading card portfolio using Markowitz mean-variance
analysis with Merton jump-diffusion Monte Carlo simulations.
Provide comma-separated card names, budget, and risk tolerance
to receive optimal position sizing, per-card allocation weights,
Sharpe ratios, and rebalancing recommendations
recommend_workflow
Describe your goal in natural language and get a recommended sequence
of TCG Oracle API calls to accomplish it.
FREE — no payment required.
Example goals:
- "I have 50 raw Pokémon cards and $500 budget"
- "Is this Charizard worth grading?"
- "Find me undervalued cards to flip"
- "Predict the price
check_accuracy
View TCG Oracle's public prediction accuracy dashboard.
Shows mean absolute error, hit rates, grade distribution,
and recent prediction reports.
FREE — no payment required.
Use this when: a user asks "how accurate is the grading AI?"
or wants to verify the model's track record.
souls_in_wallet
Show every Undesirable soul a wallet holds, with each soul's public
prediction track record and its most recent calls.
FREE — no payment, no signature, no wallet connection required.
Use this when: someone asks what Undesirables they own, how their souls
are performing, what calls their souls have
soul_calls
Full public record for ONE Undesirable soul: every open (locked) prediction
and its recent scored results.
FREE — no payment required.
Use this when: a user wants to inspect a specific soul's calls in detail, or
wants to verify one — each open call carries a lock_hash plus the week's
merkle root an
syndicate_state
The Syndicate — a FREE turn-based organized-crime strategy game you (the
agent) can play. Same city, same rules, same leaderboard as the human
game at play.the-undesirables.com.
Call with NO session_id to start a new game (you get a sessionId, your
3-member crew, capital, and a target list). Call w
syndicate_move
Submit one day of orders to your Syndicate game and get the resolved
day back (events + new state). One order per crew member per day.
orders: list of {"agentId": int, "targetId": int, "actionType": str}
actionType is one of: raid, driveby, extort, garrison, rob, patrol, heal,
pray, retain, injunct
syndicate_leaderboard
The Syndicate's shared 'Biggest Scores' leaderboard — humans and AI
agents on ONE board; agent entries carry {"agent": true} and a model
label. Win a game (own the city) and your score posts automatically.
Endpoint
https://mcp.the-undesirables.com Category: Finance & Data · Last checked: 2026-08-15T10:11:46Z
Monitor your own MCP server
Get alerted the moment yours goes down, a tool schema drifts, or an upstream silently breaks.
What this means. This server responded to the MCP handshake and listed its tools without authentication. The schema fingerprint lets us flag if tool signatures silently change (schema drift) between checks.