Undesirables Mcp Server

---

🔌 通过 MCP 连接——一个 URL，无需安装

https://mcp.the-undesirables.com

Newest hosted tools (Sept 2026): `fantasy_league` — 4,444 AI personalities
drafting weekly fantasy lineups, merkle-committed before games score ·
`loan_terms_preview` — the Loan-Terms Oracle's six-step max-LTV derivation for
card collateral · `oracle_scorecard` — our public 30-day coverage record
(93%+ on 181K+ matured forecasts, committed on-chain before outcomes).

无需安装、账户或 API 密钥。通过可流式传输的 HTTP 提供 25 个工具（MCP 协议 2025-06-18；也提供旧版 SSE）。免费工具会立即作答。付费工具会返回包含金额、网络和 payTo 的 x402 payment_required；拥有充足资金的钱包的 Agent 可以完成结算，并在同一 会话中重试。只有成功响应才会结算；失败的调用绝不会收费。

持有者还可以查询某个钱包拥有的 Undesirables，以及每个 soul 的调用评分 （souls_in_wallet、soul_calls）——仅公开历史记录；个性仍仅限持有者访问。

Claude Desktop / Perplexity——将其添加为自定义远程连接器（Perplexity： Settings → Connectors → + Custom Connector → Remote）。

Cursor / Windsurf / VS Code——配置中支持填写 URL 的客户端：

{
  "mcpServers": {
    "tcg-oracle": { "url": "https://mcp.the-undesirables.com" }
  }
}

工具：search_tcg_products、market_snapshot、 simulate_price、card_forecast、trending_cards、optimize_portfolio、 recommend_workflow、oracle_scorecard。

搜索会区分系列——search_tcg_products("Base Set Charizard") 会将 Base Set、 Base Set 2 和 Shadowless 区分开来，而不是返回所有喷火龙卡牌版本。每个结果 都包含 set 字段和 product_id，可直接传给其他工具。

---

两个服务，一个软件包（v2.0.0）

命令	提供的功能	适用对象
undesirables-mcp（默认）	TCG Oracle——25 个工具：搜索 45.6 万余张卡牌（USD 价格冻结于 2026-09-07——响应包含 usd_panel）、市场快照（冻结期间暂停）、AI 评级与评级建议、带有公开准确率评分卡的保形校准预测、投资组合优化、卡牌抵押贷款条款、奇幻与体育 souls、辛迪加、Technocore 房间。由公开预言机 API 提供支持。	想在 Claude Desktop、Cursor、Zed、LangChain 等应用中使用预言机的任何人
undesirables-agent-kit	本地 Agent 套件——34 个工具：记忆图谱、针对 soul 工作区的 RAG、表情包／横幅／视频／3D 生成、语音、代码和 shell 执行、安全审计、网页搜索。完全在本机运行。	使用 Undesirables 持有者的本地 Agent 运行其 soul

v1.x 通过一个命令提供这两种功能；v2 将其拆分，使每个服务各司其职。托管端点保持不变。

快速安装

pip install undesirables-mcp-server

undesirables-mcp          # the TCG Oracle over stdio (25 tools, no keys) — default
undesirables-agent-kit    # the local 34-tool agent kit

Claude Desktop / Cursor / Zed——将预言机添加为 stdio 服务：

{ "mcpServers": { "undesirables-oracle": { "command": "uvx", "args": ["undesirables-mcp-server"] } } }

使用 34 工具本地 Agent 套件（undesirables-agent-kit），将任意 Undesirable NFT 转变为兼容 MCP 的 AI Agent。

---

目录

• 功能介绍
• 最新动态
• 本地 Agent 套件
• 技术架构（Agent 套件）
• Agent 框架集成
• LitVM TCG Oracle
• 生态系统
• 许可证与商业使用

---

功能介绍

TCG Oracle — undesirables-mcp（默认），25 个工具，无需密钥

与托管端点提供的 25 个工具相同，通过 stdio 使用。每个工具都会直接响应：自 2026-10-02 起，按次付费已暂停，因此不会要求付款（x402 支付通道仍已安装，可随时重新启用）。

领域	工具
🔎 搜索与价格	search_tcg_products（超过 455K 款产品、25 款以上游戏，支持按系列筛选）、market_snapshot、trending_cards

USD 面板于 2026-09-07 冻结。 market_snapshot、simulate_price、trending_cards 和 optimize_portfolio 已暂停（Oracle 返回 {"status":"suspended"}，且不会收费）；card_forecast 和 search_tcg_products 提供最近一次发布的 USD 数值，并会在响应中说明。仍可使用：评级卡片贷款条款、体育、灵魂、普查数据、加密货币、日本双向报价。

| 📊 预测与风险 | card_forecast（免费：符合度 30 天预测 + Safe-Hold / Momentum 字母评级）、simulate_price（USD 面板冻结期间暂停——返回 {status: suspended}，不收费；蒙特卡洛 GBM / Merton 路径）、optimize_portfolio | | 🧾 公开业绩记录 | oracle_scorecard（30 天覆盖率，基于超过 181K 条已到期预测，并在结果公布前上链记录） | | 🏦 卡片抵押品 | loan_terms_preview（贷款条款 Oracle 的六步最高 LTV 推导） | | 👻 灵魂与联赛 | souls_in_wallet、soul_calls、fantasy_league（4,444 个 AI 个性每周组建阵容）、sports_board、jp_summary（以汇总数据呈现的日本经销商面板）、graded_asks、loan_universe、census_summary、sports_players（全部免费） | | 🕹️ The Syndicate | syndicate_state、syndicate_move、syndicate_leaderboard — Agent 可以参与的回合制策略游戏 | | 💬 technocore.chat（只读） | technocore_rooms、technocore_room、technocore_info、technocore_note | | 🧭 路由 | recommend_workflow — 描述目标，获取调用顺序 |

本地 Agent 工具包 — undesirables-agent-kit，34 个工具，在你的机器上运行

将 Undesirable NFT 灵魂工作区转换为本地 Agent：提供持久化记忆图谱和针对灵魂文件的 RAG，以及 meme、横幅、图像、视频和 3D 生成、Kokoro TTS、ACE Step 音乐、DuckDuckGo 搜索、SAST 代码审计、Ollama 提示词处理、沙箱化代码和 shell 执行，以及 eBay 市场深度数据。它需要 Ollama 和灵魂工作区——请参阅下方的本地 Agent 工具包。Oracle 不需要这些。

---

v2.1.0 / v2.0.x 更新内容

2.1.0 — 已移除 check_accuracy。它返回的内容与 oracle_scorecard 完全相同（使用同一端点），还会忽略其 game 参数，因此它的存在只会让 Agent 在二者之间选择时感到困惑。调用方：请改用 oracle_scorecard。Oracle 现有 27 个工具。

2.0.1 — 重写了工具说明，让功能重叠的工具对明确各自的用途（card_forecast = 免费的固定 30 天读取；simulate_price = 付费的自定义时间范围 + 完整分布；market_snapshot = 当日市场报告；trending_cards = 排名精选列表；四个 technocore_* 读取工具已编号为 1 至 4）。现在，check_accuracy 是有文档说明的 oracle_scorecard 弃用别名（数据相同；计划在 2.1 版中移除）。

• Oracle 是默认服务。 undesirables-mcp（以及 undesirables-mcp-server）现在会通过 stdio 启动 27 个 TCG Oracle 工具——与 https://mcp.the-undesirables.com 上的工具相同，无需密钥、钱包或本地模型。
• 工具包有自己的命令。 34 个工具的本地工具包已迁移到 undesirables-agent-kit。没有移除任何功能；现在每个服务各司其职。
• 固定依赖版本为 fastmcp<4 和 mcp<2，确保全新安装在 SDK 主版本升级后仍能正常运行。
• 最新的 Oracle 工具（2026 年 9 月）：fantasy_league、loan_terms_preview、oracle_scorecard、sports_board、Syndicate 三件套，以及 technocore.chat 读取工具。
• 从 v1.1.8 延续而来：免费工具 card_forecast(card_name | product_id)——一次调用即可提供 conformal 30 天预测以及 Safe-Hold 和 Momentum 评级。

---

🧰 本地 Agent 工具包（undesirables-agent-kit）

本节内容仅适用于 Agent 工具包。如果你只需要 Oracle，那就已经完成了：uvx undesirables-mcp-server（或上方的托管 URL）。

🛑 前置条件

1. Python 3.10 或更高版本。
2. Ollama ——下载并运行它。菜单栏 / 任务栏中必须显示 llama 图标，否则本地推理会立即失败。
3. 从 the-undesirables.com 下载的灵魂工作区文件夹（例如 soul_folder/XXXX）。

🛠️ 安装

pip install undesirables-mcp-server

或者，要参与开发：

git clone https://github.com/sailorpepe/undesirables-mcp-server.git
cd undesirables-mcp-server
python3 -m venv venv && source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt

🚀 启动

# point --workspace at your EXACT soul folder
undesirables-agent-kit --workspace "/Users/you/Desktop/soul_folder/XXXX"

（从克隆的代码库启动：python server.py --workspace ".../soul_folder/XXXX"。）该服务没有聊天窗口——它会通过 JSON-RPC 与你接下来连接的客户端通信。不要在该终端中输入内容。

🔌 连接 Claude Desktop

Settings → Developer → Edit Config，然后：

{
  "mcpServers": {
    "undesirables-agent-kit": {
      "command": "undesirables-agent-kit",
      "args": ["--workspace", "/Users/you/Desktop/soul_folder/XXXX"]
    }
  }
}

重启 Claude Desktop；工具图标应显示 34 个 Undesirables 工具。Cursor、Zed 和 Windsurf 使用相同的 command / args 格式。

🎨 本地图像生成（可选）

该工具包使用 16 GB 的 FLUX.1-schnell 模型，完全离线生成梗图和插画。跳过此步骤（或在 RAM 不足 12 GB 的机器上运行），系统会自动回退到免费的 Pollinations.ai 云服务。

• Apple Silicon 使用 mflux，需要 Hugging Face 令牌才能访问 Black Forest Labs 的受限仓库：在 black-forest-labs/FLUX.1-schnell 接受条款，在 Hugging Face Tokens 创建 Read 令牌，然后运行 python -c "import huggingface_hub; huggingface_hub.login()" 并粘贴令牌。
• Nvidia CUDA / AMD DirectML 会自动检测，并使用无需授权的 shuttleai/FLUX.1-schnell 权重——无需账号；首次执行 generate a meme 时会下载这些权重。

⚠️ 故障排除

• Ollama connection refused — Ollama 尚未运行。启动应用并检查是否显示 llama 图标。
• ModuleNotFoundError: fastmcp — 你当前不在虚拟环境中（仅克隆安装）。请先运行 source venv/bin/activate。
• Invalid JSON: expected value at line 1 — 你在服务终端中输入了内容。请不要操作终端，通过 Claude Desktop / Cursor 进行交互。

---

技术架构（Agent 工具包）

本节介绍 undesirables-agent-kit。（oracle 是一个精简的 stdio 包装器，封装了托管端点提供的同一组 25 个工具；以下内容均不适用于它。）

该 Agent 工具包通过 Model Context Protocol 标准开放本地 NFT 灵魂。

资源（AI 可访问的只读上下文）：

• soul://personality — 大五人格分数、原型、策略、致命弱点
• soul://system-prompt — 定义 Agent 的完整系统提示词
• soul://memory — 持久化记忆（交易历史、观察记录）
• soul://predictions — 带有评级的预测账本

Agent 工具包工具（AI 可调用的 34 个函数 — undesirables-agent-kit）：

• grade_tcg_card — 3 阶段 PSA/Beckett 评级：Qwen Vision LLM + OpenCV 居中检测 + BGS 评级上限
• card_forecast — 免费的一键共形 30 天预测 + Safe-Hold/Momentum 字母评级 + 通俗易懂的解读（传入卡牌名称或 TCGplayer product_id）
• monte_carlo_simulation — 价格预测：默认采用经过共形校准的风险分析（诚实的 VaR/CVaR + Safe-Hold/Momentum 评级）；也可选择启用 Monte Carlo GBM/Merton
• search_ebay_market — eBay 实时市场深度、价格分布、套利检测
• purchase_undesirables_license_key — M2M 购买桥接（EVM 交易负载）
• verify_soul_initialization — 链上灵魂验证
• generate_voice — Kokoro TTS 语音合成
• generate_3d_object — Shap E 文本转 3D 网格（.glb）
• generate_image — 本地 FLUX 图像生成
• web_search — DuckDuckGo 即时问答
• run_security_audit — SAST 代码扫描
• query_ollama — 向本地 Ollama 发送提示词
• analyze_market — 以角色身份执行市场分析
• create_content — 以角色身份撰写推文、串文、简介
• meme_machine — 生成梗图创意和营销内容
• 以及 20 多个涵盖视频、音频、记忆和沙盒执行的工具

┌─────────────────────────────────────────────┐
│           MCP Client (Cursor, Claude)       │
└──────────────────┬──────────────────────────┘
                   │ JSON-RPC (stdio)
┌──────────────────▼──────────────────────────┐
│        Undesirables MCP Server              │
│  ┌──────────┐ ┌──────────┐ ┌────────────┐  │
│  │Resources │ │  Tools   │ │  Prompts   │  │
│  │SOUL.md   │ │Skills    │ │Templates   │  │
│  │MEMORY.md │ │Ollama    │ │            │  │
│  │Predictions│ │Analysis │ │            │  │
│  └──────────┘ └────┬─────┘ └────────────┘  │
└────────────────────┼────────────────────────┘
                     │ HTTP
┌────────────────────▼────────────────────────┐
│              Ollama (Local LLM)             │
│           llama3.1:8b / qwen / etc          │
└─────────────────────────────────────────────┘

Agent 框架集成

LangChain / LangGraph

from langchain_mcp_adapters.client import MultiServerMCPClient

async with MultiServerMCPClient({
    "undesirables": {
        "command": "uvx",
        "args": ["undesirables-mcp-server"]
    }
}) as client:
    tools = client.get_tools()
    # the 25 oracle tools, now available to any LangChain agent
    # (for the agent kit use command="undesirables-agent-kit", args=["--workspace", ".../soul_folder/XXXX"])

CrewAI

from crewai import Agent
from crewai_tools import MCPServerAdapter

mcp = MCPServerAdapter(
    command="uvx", args=["undesirables-mcp-server"])

agent = Agent(
    role="NFT Card Grader",
    tools=mcp.tools,
    goal="Grade trading cards and run calibrated price forecasts"
)

OpenAI Agents SDK

from agents import Agent
from agents.mcp import MCPServerStdio

mcp_server = MCPServerStdio(
    command="uvx", args=["undesirables-mcp-server"])

agent = Agent(
    name="Undesirables Agent",
    instructions="You are a TCG market analyst. Use the oracle tools for prices, forecasts, and grading.",
    mcp_servers=[mcp_server]
)

ElizaOS（已合并至官方单体仓库）

npm install plugin-undesirables

该插件现已成为 ElizaOS 官方单体仓库的一部分（PR #7869，于 2026 年 5 月 21 日合并）。

添加到你的 character.json 中：

{
  "settings": {
    "UNDESIRABLES_WORKSPACE": "/path/to/soul_folder/XXXX"
  },
  "plugins": ["plugin-undesirables"]
}

---

LitVM TCG Oracle — MCP 服务

我们还为 LitecoinVM 生态系统发布了专用的链上预言机 MCP 服务：

pip install litvm-tcg-oracle

功能	详情
456K+ 张交易卡	25+ 款游戏，290K 张有活跃定价
13.5M+ 条价格观测数据	持续提供 60+ 天的数据
链上 Merkle 证明	在 LiteForge（Chain 4441）上进行无需信任的验证
风险预测	经共形校准的 VaR/CVaR + Safe-Hold/Momentum 评级（可选择启用 Monte Carlo）
16 个 MCP 工具	search_cards、get_price、get_merkle_proof、get_graded_proof、oracle_status、get_forecast、simulate_price、get_market_snapshot、get_jp_summary、get_graded_asks、get_loan_universe、get_loan_terms_preview、get_sports_board、get_fantasy_league、get_census_summary、get_oracle_scorecard

→ GitHub：litvm-tcg-oracle-mcp
→ PyPI：litvm-tcg-oracle
→ 实时预言机：the-undesirables.com/litvm

---

The Undesirables 生态系统

• 网站：the-undesirables.com
• LitVM 预言机：the-undesirables.com/litvm
• 铸造：scatter.art/the-undesirables
• 文档：the-undesirables.com/docs
• PyPI（MCP）：undesirables-mcp-server（v2.0.0）
• PyPI（LitVM）：litvm-tcg-oracle（v1.0.7）
• npm：plugin-undesirables（ElizaOS 插件，v2.7.0）
• 预言机 API：oracle.the-undesirables.com（31 个端点，x402 小额支付）
• awesome-mcp-servers：已收录 ✅（94K+ ⭐，两个服务均已收录）
• Glama：已验证 ✅ — 工具质量 A
• ElizaOS 插件：官方单体代码库
• x402 支付服务：undesirables-x402-server
• 价格数据：来源于 TCGplayer。我们不主张对底层价格拥有任何权利； 建模和链上证明则由我们提供。
• X：@undesirables_ai

---

⚖️ 法律免责声明

**仅供娱乐：**市场预言机、交易模拟器以及所有 AI 生成的预测，仅用于教育和娱乐目的。AI 模型本身会产生幻觉。请勿使用此服务执行真实金融交易或作出商业采购决策。The Undesirables LLC 对已部署的开源 AI 工具实行零责任框架。

---

📝 许可证与商业用途

本项目采用 Business Source License 1.1 (BUSL-1.1) 许可。

我们公开开发并支持开发者生态系统，同时也保护 The Undesirables LLC 的基础设施和知识产权。

✅ 你可以做什么（免费）

• 个人与教育用途 — 下载、修改并在本地运行，用于学习、研究或个人项目。
• 非竞争性应用 — 将我们的软件包集成到你的应用中，前提是你的应用不以提供 TCG 市场情报、价格聚合、AI 卡牌评级或链上价格预言机服务为主要功能。
• MCP / Agent 集成 — 将你的 AI Agent 连接到我们的工具，用于非商业用途。
• 社区贡献 — 我们始终欢迎安全审计、错误修复和 PR。

🚫 您不能做的事（使用限制）

• 竞争服务 — 您不得使用此代码运营与之竞争的 TCG 市场情报、价格聚合、AI 卡牌评级或链上价格预言机服务。
• 商业转售 — 未获得商业许可证，您不得将我们的 API、数据管道或 AI 模型封装成付费服务。
• 托管式 SaaS — 未获得书面许可，您不得将此软件作为服务托管并提供给第三方。

🔓 转为开源

在 2030 年 6 月 1 日（或每个版本首次公开发布 4 年后），此代码将自动转为 MIT License — 永久完全开源。

🤝 商业授权

正在构建商业产品？需要保证 API 访问权限或白标集成？请联系我们：

📧 [email protected] · 🐦 @undesirables_ai

© 2026 The Undesirables LLC

---

数据新鲜度

USD 市场价格源自 TCGPlayer。该上游数据源目前不可用，因此 USD 价格停留在最后一次有效日期。 每个价格响应都带有自己的 latest_date，且预言机根节点会在 panels 下发布实时面板状态 — 请读取该状态，而不要自行推断。

日文版面板每天早晨刷新：24 款游戏、约 364K 张卡牌，其中约 167K 张同时具有要价和经销商回购价。评级成交价、体育卡看板和证明层不受影响。

我们不主张拥有任何底层价格数据的权利，也不会再分发任何提供商的数据集。