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（MCP プロトコル 2025-06-18。レガシー SSE も提供）経由で 25 個のツールを利用できます。無料ツールはすぐに回答します。有料ツールは、金額、ネットワーク、payTo を含む x402 の payment_required を返します — 資金を入れたウォレットを持つエージェントは、同じセッション内で決済して再試行できます。決済は応答が成功した場合にのみ行われます。失敗した呼び出しに料金が請求されることはありません。

保有者は、ウォレットがどの Undesirables を所有しているか、また各ソウルの呼び出しがどのようなスコアを獲得したか（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") は、あらゆる Charizard の印刷版を返すのではなく、Base Set、Base Set 2、Shadowless を区別します。すべての検索結果に set フィールドが含まれ、ほかのツールにそのまま渡せる product_id も付与されます。

---

2 つのサーバー、1 つのパッケージ（v2.0.0）

コマンド	提供内容	対象
undesirables-mcp（デフォルト）	TCG オラクル — 25 個のツール：456K 以上のカードを検索（USD 価格は 2026-09-07 時点で固定 — 応答に usd_panel を含む）、マーケットスナップショット（価格固定中は一時停止）、AI によるグレーディングとグレード判定、公開精度スコアカード付きのコンフォーマル校正済み予測、ポートフォリオ最適化、カードを担保にしたローン条件、ファンタジー＆スポーツのソウル、Syndicate、Technocore のルーム。公開オラクル API をバックエンドとして利用します。	Claude Desktop、Cursor、Zed、LangChain などでオラクルを使いたい方
undesirables-agent-kit	ローカルエージェントキット — 34 個のツール：メモリーグラフ、ソウルのワークスペースを対象とする RAG、ミーム／バナー／動画／3D 生成、音声、コードとシェルの実行、セキュリティ監査、ウェブ検索。すべてお使いのマシン上で実行されます。	Undesirables の保有者で、ソウルをローカルエージェントとして実行する方

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 個のツールを備えたローカルエージェントキット（undesirables-agent-kit）を使って、あらゆる Undesirable NFT を MCP 対応の AI エージェントに変えましょう。

---

目次

• できること
• 新機能
• ローカルエージェントキット
• 技術アーキテクチャ（agent kit）
• エージェントフレームワークとの統合
• LitVM TCG Oracle
• エコシステム
• ライセンスと商用利用

---

できること

TCG Oracle — undesirables-mcp（デフォルト）、25 個のツール、キー不要

ホスト型エンドポイントが提供するものと同じ 25 個のツールを、stdio 経由で利用できます。各ツールは直接回答します。従量課金は 2026-10-02 以降停止しているため、支払いを求めるものはありません（x402 の仕組みはインストールされたままで、再び有効にできます）。

領域	ツール
🔎 検索と価格	search_tcg_products（45 万件以上の商品、25 種類以上のゲーム、セットを考慮）、market_snapshot、trending_cards

USD パネルは 2026-09-07 に凍結されました。 market_snapshot、simulate_price、trending_cards、optimize_portfolio は停止中です（オラクルは {"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（成熟した 18 万 1 千件以上の予測における 30 日間のカバレッジ。結果が判明する前にオンチェーンへ記録） | | 🏦 カード担保 | loan_terms_preview（Loan-Terms Oracle による、最大 LTV の 6 段階の導出） | | 👻 ソウルとリーグ | 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 — エージェントがプレイできるターン制ストラテジーゲーム | | 💬 technocore.chat（読み取り専用） | technocore_rooms、technocore_room、technocore_info、technocore_note | | 🧭 ルーティング | recommend_workflow — 目標を説明すると、呼び出し順序が提示されます |

ローカルエージェントキット — undesirables-agent-kit、34 個のツールを搭載し、マシン上で実行

Undesirable NFT のソウルワークスペースをローカルエージェントに変換します。ソウルファイルを対象とした永続的なメモリーグラフと RAG、ミーム／バナー／画像／動画／3D の生成、Kokoro TTS、ACE Step による音楽生成、DuckDuckGo 検索、SAST コード監査、Ollama へのプロンプト送信、サンドボックス化されたコードとシェルの実行、eBay の市場深度を利用できます。Ollama とソウルワークスペースが必要です。詳しくは下のローカルエージェントキットをご覧ください。オラクルにはどちらも必要ありません。

---

v2.1.0 / v2.0.x の新機能

2.1.0 — check_accuracy を削除しました。oracle_scorecard とまったく同じ結果を返し（同じエンドポイント）、game 引数も無視していたため、エージェントがどちらを選ぶか迷う原因にしかなっていませんでした。呼び出し元は oracle_scorecard に切り替えてください。オラクルは 27 個のツールを提供します。

2.0.1 — 重複するツールのペアで用途が明確に異なることが伝わるよう、ツールの説明を書き直しました（card_forecast = 無料の固定 30 日予測、simulate_price = 有料のカスタム期間＋完全な分布、market_snapshot = その日の市場レポート、trending_cards = ランキング形式の候補リスト、4 つの technocore_* リーダーには 1～4 の番号を付与）。check_accuracy は oracle_scorecard の非推奨エイリアスとして文書化されました（同じデータを返し、2.1 で削除予定です）。

• オラクルがデフォルトのサーバーです。 undesirables-mcp（および undesirables-mcp-server）を起動すると、stdio 経由で 27 個のツールを備えた TCG Oracle が起動します。これは https://mcp.the-undesirables.com と同じツールを提供し、キー、ウォレット、ローカルモデルは不要です。
• エージェントキットには専用のコマンドがあります。 34 個のツールを備えたローカルキットは undesirables-agent-kit に移行しました。削除された機能はありません。各サーバーの役割が明確になりました。
• 依存関係を固定しました。 新規インストールが SDK のメジャーアップデート後も動作するよう、fastmcp<4 と mcp<2 に固定しました。
• 最新のオラクルツール（2026 年 9 月）：fantasy_league、loan_terms_preview、oracle_scorecard、sports_board、Syndicate の 3 つのツール、technocore.chat リーダー。
• v1.1.8 から引き継いだ機能：無料の card_forecast(card_name | product_id) — 共形 30 日予測と Safe-Hold および Momentum の評価を 1 回の呼び出しで提供します。

---

🧰 ローカルエージェントキット（undesirables-agent-kit）

このセクションの内容はすべてエージェントキット専用です。オラクルだけを使いたい場合は、これで準備完了です。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 を再起動すると、ツールアイコンに Undesirables のツールが 34 個表示されます。Cursor、Zed、Windsurf でも同じ command／args の形式を使用します。

🎨 ローカル画像生成（任意）

このキットでは、16 GB の FLUX.1-schnell モデルを使用して、完全オフラインでミームやイラストを生成します。この手順をスキップするか、RAM が 12 GB 未満のマシンで実行すると、自動的に無料の Pollinations.ai クラウドにフォールバックします。

• Apple Silicon では、Black Forest Labs のアクセス制限付きリポジトリで使うために Hugging Face トークンが必要な mflux を使用します。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 を通じて操作してください。

---

技術アーキテクチャ（エージェントキット）

このセクションでは undesirables-agent-kit について説明します。（oracle は、ホスト型エンドポイントが提供する同じ 25 個のツールを stdio 経由で提供する薄いラッパーです。以下の内容は oracle には適用されません。）

エージェントキットは、Model Context Protocol 標準を介して、ローカルの NFT ソウルを公開します。

リソース（AI がアクセスできる読み取り専用のコンテキスト）：

• soul://personality — Big Five スコア、アーキタイプ、戦略、致命的な弱点
• soul://system-prompt — エージェントを定義するシステムプロンプト全文
• soul://memory — 永続メモリ（取引履歴、観察内容）
• soul://predictions — 評価結果付きの予測台帳

エージェントキットのツール（AI が呼び出せる 34 個の関数 — undesirables-agent-kit）：

• grade_tcg_card — 3 段階の PSA/Beckett グレーディング：Qwen Vision LLM + OpenCV によるセンタリング判定 + BGS による上限設定
• card_forecast — 無料の 1 回の呼び出しで、コンフォーマル予測による 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          │
└─────────────────────────────────────────────┘

エージェントフレームワークとの統合

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 評価（モンテカルロはオプトイン）
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／エージェントとの統合 — 非商用利用のために、AI エージェントを当社のツールに接続できます。
• コミュニティからの貢献 — セキュリティ監査、バグ修正、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枚には販売価格と販売店の買取価格の両方が付いています。鑑定済みカードの比較価格、スポーツカードの一覧、証明レイヤーには影響ありません。

基盤となる価格データに対する権利は主張せず、プロバイダーのデータセットを再配布することもありません。