trading-cardsgamingprice-analysisimage-generationsecurity
MCP server for TCG product search, card grading, price analysis, media generation, memory, web search, and security auditing.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag β we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON βΎ
Client Config & Setup
Choose your client or environment
Target File:
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Overview
Use cases
Search trading card products by name and set
Estimate card grades and decide whether to grade
Forecast prices and analyze market risk
Generate images, music, and speech locally
Audit code with static security analysis
Key features
Set-aware TCG product search
Vision AI card grading with PSA and Beckett predictions
Conformal price forecasts with optional Monte Carlo models
Local image, music, video, and text-to-speech generation
Persistent RAG memory graphs
SAST code security auditing
Capabilities & Tool Schemas
Inspect callable tools, capabilities, and parameters exposed to AI agents by Undesirables MCP Server.
Extracted Tool Capabilities
Set-aware TCG product search
Vision AI card grading with PSA and Beckett predictions
Conformal price forecasts with optional Monte Carlo models
Local image, music, video, and text-to-speech generation
Persistent RAG memory graphs
SAST code security auditing
Documentation Overview
The TCG Oracle as an MCP server: 22 focused tools, the same ones the hosted endpoint serves β plus a separate 34-tool local agent kit
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.
π Connect over MCP β one URL, no install
No install, no account, no API key. 22 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, grade_card, grade_or_not,
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 β 22 tools: search 455K+ cards, market snapshots, 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), 22 tools, no keys
The same 22 tools the hosted endpoint serves, over stdio. Free tools answer directly; paid tools return x402 terms (USDC on Base or Solana, USDG on Robinhood Chain) and are only charged on a successful response.
| Area | Tools |
|---|---|
| π Search & prices | search_tcg_products (455K+ products, 25+ games, set-aware), market_snapshot, trending_cards |
| π Forecasts & risk | card_forecast (FREE: conformal 30-day forecast + Safe-Hold / Momentum letter grades), simulate_price (Monte Carlo GBM / Merton paths), optimize_portfolio |
| π΄ Grading | grade_card (3-stage vision pipeline, PSA/Beckett-calibrated), grade_or_not (GO / NO-GO with expected ROI) |
| π§Ύ Public track record | oracle_scorecard (30-day coverage on 181K+ matured forecasts, committed on-chain before outcomes) |
| π¦ Card collateral | loan_terms_preview (the Loan-Terms Oracle's six-step max-LTV derivation) |
| π» Souls & leagues | souls_in_wallet, soul_calls, fantasy_league (4,444 AI personalities drafting weekly lineups), sports_board |
| πΉοΈ The Syndicate | syndicate_state, syndicate_move, syndicate_leaderboard β a turn-based strategy game agents can play |
| π¬ technocore.chat (read-only) | technocore_rooms, technocore_room, technocore_info, technocore_note |
| π§ Routing | recommend_workflow β describe a goal, get the call sequence |
The local agent kit β undesirables-agent-kit, 34 tools, runs on your machine
Turns an Undesirable NFT soul workspace into a local agent: persistent memory graph and RAG over the soul files, meme / banner / image / video / 3D generation, Kokoro TTS, ACE Step music, DuckDuckGo search, SAST code auditing, Ollama prompting, sandboxed code and shell execution, and eBay market depth. It needs Ollama and a soul workspace β see The Local Agent Kit below. The oracle needs none of that.
What's New in v2.1.0 / v2.0.x
2.1.0 β check_accuracy removed. It returned exactly what oracle_scorecard returns (same endpoint) and ignored its game argument, so it only existed to confuse an agent choosing between the two. Callers: switch to oracle_scorecard. The oracle is 22 tools.
2.0.1 β tool descriptions rewritten so overlapping pairs state distinct jobs (card_forecast = free fixed 30-day read, simulate_price = paid custom horizon + full distribution; market_snapshot = the day's market report, trending_cards = ranked pick list; the four technocore_* readers numbered 1-4). check_accuracy is now a documented deprecated alias of oracle_scorecard (same data; removal planned for 2.1).
- The oracle is the default server.
undesirables-mcp(andundesirables-mcp-server) now start the 22-tool TCG Oracle over stdio β the same tools ashttps://mcp.the-undesirables.com, with no keys, wallet, or local models. - The agent kit has its own command. The 34-tool local kit moved to
undesirables-agent-kit. Nothing was removed; each server now has one job. - Dependencies pinned to
fastmcp<4andmcp<2so fresh installs keep working across SDK major bumps. - Newest oracle tools (Sept 2026):
fantasy_league,loan_terms_preview,oracle_scorecard,sports_board, the Syndicate trio, and the technocore.chat readers. - Carried over from v1.1.8: the FREE
card_forecast(card_name | product_id)β conformal 30-day forecast plus Safe-Hold & Momentum grades in one call.
π§° The Local Agent Kit (undesirables-agent-kit)
Everything in this section is for the agent kit only. If you just want the oracle, you're already done:
uvx undesirables-mcp-server(or the hosted URL above).
π Prerequisites
- Python 3.10 or higher.
- Ollama β download it and run it. The llama icon must be in your menu bar / taskbar, or local inference fails immediately.
- A soul workspace folder downloaded from the-undesirables.com (for example
soul_folder/0420).
π οΈ Install
Or, to hack on it:
π Boot
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks β not a rating.
GitHub stars
3
Stargazers on the source repository.
Last commit
1d ago
Most recent push to the default branch.
Directory activity
1 views
Config copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet β be the first to share how this listing worked for you.
Frequently Asked Questions about Undesirables MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/sailorpepe-undesirables-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/sailorpepe-undesirables-mcp-server"><img src="https://allmcps.com/api/badge/sailorpepe-undesirables-mcp-server?style=directory" alt="Undesirables MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryFinance & Fintech
PricingFreemium
10/11 checks healthy over the last 32d
53Quality signal: Good Β· 53/100How this signal is calculated βΎ
Server availabilityNot measured
Not scored for repo-hosted servers β we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools25/30
Adoption & activity5/15
Community engagement0/10
A guidance signal from public completeness & health data β not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 26d ago via OSV.dev Β· undesirables-mcp-server (PyPI)
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge β proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it β no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.