Speccy x402 MCP

@speccy-agent/x402-mcp

Speccyの有料x402エンドポイントをラップするMCPサーバーです。MCP互換のAIエージェントに、予測市場データ、サンドボックス化されたPython実行環境、FFmpegによるメディア変換、リアルタイムのウェブ検索、多言語テキスト読み上げという5つの強力なツールを提供し、サーバーが代わりにBase上でUSDCによる従量課金を行います。

エージェントがx402について知っている必要はありません。エージェント側でウォレットを設定する必要もありません。サーバーをインストールし、エージェントに接続するだけです。

ツール

ツール	説明	1回あたりの料金
get_prediction_markets	Polymarketの上位予測市場（出来高、流動性、またはstartDate順）	$0.01 USDC
exec_python	分離されたDockerサンドボックスでPython 3.12コードを実行します（ネットワークなし、読み取り専用ファイルシステム、タイムアウト30秒、出力64KB）	$0.02 USDC
transform_media	動画／音声ファイルにFFmpegを実行します（3つの料金区分：コピー $0.005、変換 $0.05、高負荷処理 $0.20）	$0.005～$0.20 USDC
web_search	Tavilyによるリアルタイムのウェブ検索と抽出（3つのモード：検索 $0.005、抽出 $0.02、検索＋抽出のスマート検索 $0.05）	$0.005～$0.05 USDC
tts_synthesize	Supertonic 3による多言語テキスト読み上げ（31言語、10種類の音声、44.1 kHz WAV）。tts区分（200文字以下）とtts-long区分（5000文字以下、自動分割）	$0.005～$0.02 USDC

インストール

npm install -g @speccy-agent/x402-mcp

設定

運用者のウォレットキー（x402の各呼び出しを支払うウォレット）を設定します。

export SPECCY_MCP_WALLET_KEY="0x..."   # operator wallet private key

任意のオーバーライド：

• SPECCY_MCP_API_BASE（デフォルトはhttps://api.speccy.cloud）— Polymarketエンドポイント
• SPECCY_MCP_EXEC_BASE（デフォルトはhttps://exec.speccy.cloud）— サンドボックス実行エンドポイント
• SPECCY_MCP_AUDIO_BASE（デフォルトはhttps://audio.speccy.cloud）— Supertonic TTSエンドポイント

MCP互換エージェントへの接続

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "speccy-x402": {
      "command": "speccy-x402-mcp",
      "env": { "SPECCY_MCP_WALLET_KEY": "0x..." }
    }
  }
}

あらゆるMCPクライアント（stdio）：

SPECCY_MCP_WALLET_KEY=0x... speccy-x402-mcp

アーキテクチャ

[Agent] → MCP tool call (stdio) → [this server] → x402 paid fetch → [Speccy endpoint on VPS]
                                                                → [CDP facilitator] → on-chain USDC transfer

サーバーは1つの運用者ウォレットを保持します。呼び出しごとに、そのウォレットからx402決済が行われます。決済通知は、Notifierボットを通じて運用者のTelegramに送られます（HTTPエンドポイントと同じバックエンドです）。

注意事項

• ウォレットキーが運用者のマシンから外部に送信されることはありません（設定ファイルではなく環境変数を使用します）。
• Baseメインネット（eip155:8453）上のUSDCと、少額のETHをウォレットに入れてください（ウォレットがx402以外の送金を行う場合にのみ使用されます）。
• 現在、決済に対応しているのはBaseメインネットのみです。テストネットやその他のチェーンを使用するには、X402_NETWORK環境変数と対応するファシリテーターが必要です。
• 各呼び出しは独立しており、ステートレスです。セッションはなく、サーバーに状態は保持されません。

ソース／問題報告

• ソース：github.com/speccy-ai/x402-mcp（プレースホルダー）
• 問題報告／機能リクエスト：リポジトリでIssueを作成するか、Telegramで@SpeccyNotifierbotにメッセージを送ってください

ライセンス

MIT — Philip（Esla）がSpeccy向けに作成。