sailorpepe/undesirables-mcp-server

*Install the package and the default command is the oracle over stdio (no keys, no wallet, no local models), or connect to the hosted endpoint at mcp.the-undesirables.com. Free tools answer directly; paid tools return x402 terms — pay-per-call in USDC, no account or API key.*
Website · Docs · PyPI · 𝕏
---
🔌 Connect over MCP — one URL, no install
No install, no account, no API key. **25 tools** over streamable HTTP (MCP protocol
2025-06-18; legacy SSE also served). Free tools answer immediately. Paid tools return an
x402 payment_required carrying amount, network, and payTo — an agent with a funded
wallet can settle and retry in the same session. Settlement only occurs on a successful
response; failed calls are never charged.
Holders can also ask **which Undesirables a wallet owns** and how each soul's calls have
scored (souls_in_wallet, soul_calls) — public track record only; personalities stay
holder-gated.
**Claude Desktop / Perplexity** — add it as a custom remote connector (Perplexity:
Settings → Connectors → + Custom Connector → Remote).
**Cursor / Windsurf / VS Code** — clients that take a URL in config:
Tools: search_tcg_products, market_snapshot,
simulate_price, card_forecast, trending_cards, optimize_portfolio,
recommend_workflow, oracle_scorecard.
Search is set-aware — search_tcg_products("Base Set Charizard") separates Base Set,
Base Set 2, and Shadowless rather than returning every Charizard printing. Every result
carries a set field and a product_id you can pass straight to the other tools.
---
Two servers, one package (v2.0.0)
| Command | What it exposes | For |
|---|---|---|
| undesirables-mcp (default) | **The TCG Oracle — 25 tools**: search 456K+ cards (USD prices frozen 2026-09-07 — responses carry usd_panel), market snapshots (suspended while frozen), AI grading & grade-or-not, conformal-calibrated forecasts with a public accuracy scorecard, portfolio optimisation, card-collateral loan terms, fantasy & sports souls, the Syndicate, Technocore rooms. Backed by the public oracle API. | Anyone who wants the oracle in Claude Desktop, Cursor, Zed, LangChain… |
| undesirables-agent-kit | **The local agent kit — 34 tools**: memory graph, RAG over a soul workspace, meme/banner/video/3D generation, voice, code & shell execution, security audits, web search. Runs entirely on your machine. | Undesirables holders running their soul as a local agent |
v1.x shipped both surfaces under one command; v2 separates them so each server has one job. The hosted endpoint is unchanged.
Quick Install
Claude Desktop / Cursor / Zed — add the oracle as a stdio server:
> **Turn any Undesirable NFT into an MCP-compatible AI agent with the 34-tool local agent kit (undesirables-agent-kit).**
---
Table of Contents
- What It Does
- What's New
- The Local Agent Kit
- Technical Architecture (agent kit)
- Agent Framework Integration
- LitVM TCG Oracle
- Ecosystem
- License & Commercial Use
---
What It Does
The TCG Oracle — undesirables-mcp (default), 25 tools, no keys
The same 25 tools the hosted endpoint serves, over stdio. Every tool answers directly: pay-per-call is paused since 2026-10-02, so nothing asks for payment (the x402 rail stays installed and can be switched back on).
| Area | Tools |
|---|---|
| 🔎 **Search & prices** | search_tcg_products (455K+ products, 25+ games, set-aware), market_snapshot, trending_cards |
> **USD panel frozen 2026-09-07.** market_snapshot, simulate_price, trending_cards and optimize_portfolio are suspended (the oracle returns {"status":"suspended"} and does not charge); card_forecast and search_tcg_products serve the last published USD numbers and say so in-band. Live: graded-slab loan terms, sports, souls, census, crypto, Japanese two-sided quotes.
| 📊 **Forecasts & risk** | card_forecast (FREE: conformal 30-day forecast + Safe-Hold / Momentum letter grades), simulate_price (**suspended while the USD panel is frozen** — answers {status: suspended}, no charge; Monte Carlo GBM / Merton paths), optimize_portfolio |
| 🧾 **Public track record** | oracle_scorecard (30-day coverage on 181K+ matured forecasts, committed on-chain before outcomes) |