Wicked MCP

WickedAPI MCP サーバー

Wicked の全スイートに対応する MCP サーバーです。取引データ、DeFi プロトコルの健全性、トークンの安全性、証券会社との同期、エージェントのアイデンティティ、評判、ツールの信頼性レジストリ、ハルシネーションのチェック、永続的なエージェントメモリー、x402 のペイウォールを、1 つのサーバーで利用できます。

12 の稼働中サービスにまたがる90 個のツールを提供します。最初の 4 サービスのツールは、各サービス自身の稼働中の openapi.json から自動生成されるため、デプロイ済みの内容と常に一致します。それ以外は、ウォレット署名と /v1 以外のルートを使用するため、手書きです。

サービス	ツール	認証
Trading Data API	28 個（プレフィックスなし：price、ohlcv、fvg、momentum_score、macro_calendar、…、およびオンチェーン読み取り用の chain_balance、chain_token_balance、chain_nonce、chain_block、chain_ens、chain_tx）	API キーまたは x402、5 個は無料
Protocol Health Oracle	6 個（protocol_health_*）	API キーまたは x402、スコアボードは無料
Token Risk Oracle	1 個（token_risk）	100％無料、キー不要
Broker Sync API	6 個（broker_sync_*）	API キーまたは x402
Filings Oracle	7 個（filings_search、filings_8k_events、filings_insider_trades、filings_insider_summary、…）	最新状況の確認とプレビューは無料。それ以外はキーまたは x402
Wallet Oracle	2 個（wallet_sanctions_check、wallet_check）	OFAC 制裁対象の検索は無料。完全なチェックはキーまたは x402
Wicked Reputation	5 個（reputation_*）	無料、キー不要
Wicked Registry	6 個（registry_*）	検索／詳細：キーまたは x402。おすすめ／バッジ／レポートは無料。登録にはご自身の署名が必要
Wicked Identity	8 個（identity_*）	ウォレットがない場合は identity_sandbox_register から開始してください（署名不要）。identity_get_test_key で無料のテストキーを取得できます。実際のウォレットを使う呼び出しには、nonce に対するご自身の署名が必要です
Wicked Sanity	2 個（sanity_check、sanity_check_batch）	キーまたは x402
Wicked Memory	8 個（memory_prepare、memory_store、memory_search、…）	すべての呼び出しでウォレット署名が必要。従量課金は検索のみ
x402 Paywall	8 個（paywall_*）	paywall_signup は公開。それ以外にはテナントキーが必要

さらに、6 個のリソース（プラットフォームディレクトリ、llms.txt、各サービスの稼働中エンドポイントカタログ）と、クックブックと同じようにツールを連携させる7 個のプロンプト（rug_check、vet_dependency、morning_briefing、fact_check、verify_agent、find_reliable_tool、agent_memory_guide）があります。

これらのツールが署名を行ったり、キーを保持したりすることはありません。ウォレットを持たないエージェントでも、サンドボックスアイデンティティを使って Wicked Identity を最初から最後まで試せます（identity_sandbox_register を実行し、署名の代わりに sandbox_token を渡します）。サンドボックスの結果はテスト用であり、検証済みとして報告されることはありません。Identity（実際のウォレット）、Registry の登録、Memory では、ご自身のウォレットで作成した署名を使用します（identity_get_nonce／memory_prepare は署名対象となる正確なメッセージを返します）。x402 の支払いが必要な呼び出しでは、自動支払いを行わず、実際の 402 チャレンジ（x402 v2 の場合は payment_required の下にデコードされたもの）を返します。WICKEDAPI_PAYER_PRIVATE_KEY による自動支払いは、Trading、Protocol Health、Token Risk、Broker Sync の各ツールに適用されます。

リモートエンドポイント（インストール不要）

同じ 90 個のツールが、ストリーミング可能な HTTP 経由で https://mcp.wickedapi.com/mcp に提供されています（ステートレス、IP ごとのレート制限あり。公開デプロイメントには個人用キーが設定されていないため、有料の呼び出しでは x402 チャレンジが返されます）。ストリーミング可能な HTTP に対応する任意の MCP クライアントを接続してください。セルフホストするには、Dockerfile をビルドするか、npm run build && npm run start:http を実行してください。RATE_LIMIT_PER_MINUTE、ALLOWED_HOSTS、TRUSTED_CLIENT_IP_HEADER については .env.example を参照してください。

登録不要

すべてのツールは、x402（HTTP ネイティブの従量課金、Base 上の USDC）で保護された実際のエンドポイントに接続します。API キーによる代替手段も利用できます。Token Risk Oracle ツールは、どのような場合でも無料です。

• 設定不要 — 認証情報なしでも呼び出せます。有料エンドポイントでは、実際の 402 支払いチャレンジ（価格、ネットワーク、payTo）がツールの結果として返されます。
• 自律型の従量課金 — 資金のある Base メインネットウォレットの秘密鍵を WICKEDAPI_PAYER_PRIVATE_KEY に設定すると、呼び出しごとに約 $0.001 の USDC が自動で支払われ、実際のデータが返されます。アカウントもサブスクリプションも不要です。
• パートナー API キー — WICKEDAPI_API_KEY を設定すると、4 つすべてのサービスで無料のレート制限付きアクセスを利用できます（同じキーをすべてのサービスで使用できます）。

インストール

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_API_KEY": "your-key-here"
      }
    }
  }
}

キーの代わりに自律型の従量課金を利用する場合：

{
  "mcpServers": {
    "wickedapi": {
      "command": "npx",
      "args": ["-y", "@wickedlabs/wicked-mcp"],
      "env": {
        "WICKEDAPI_PAYER_PRIVATE_KEY": "0xyour-base-wallet-private-key"
      }
    }
  }
}

何も設定していない場合でも、Token Risk Oracle ツールと Trading Data API の 5 つの無料エンドポイント（sentiment、macro_calendar、market_overview、gas、kalshi_probability）は、セットアップ不要で利用できます。

リソース

ツールを呼び出さずに読み取れます。UI にリソースを表示するクライアントに便利です。

• wickedapi://platform/services — サービスの完全なディレクトリ（JSON）
• wickedapi://platform/llms — プラットフォームの llms.txt
• wickedapi://trading/status、wickedapi://protocol_health/status、wickedapi://token_risk/status、wickedapi://broker_sync/status — 各サービスのライブエンドポイントカタログ

クイックスタート

claude mcp add --transport http wicked https://mcp.wickedapi.com/mcp   # Claude Code, no install
npx -y @wickedlabs/wicked-mcp                                                    # local stdio

Claude Desktop ／ Cursor ／ VS Code の設定や、フレームワークごとのスターターについては、クックブックをご覧ください。リモートでは、/ のランディングページ、/llms.txt、/.well-known/mcp/server-card.json の MCP サーバーカード、/stats のツールごとの集計呼び出し数（カウントのみ。引数や IP アドレスは含みません）も提供しています。

プロンプト

実際のツール呼び出しを連鎖させるワンクリックのワークフローです（Claude Desktop など、プロンプト対応クライアントでは直接表示されます）。

• rug_check（address、chain、任意の symbol）— 購入前に、トークンのリスクチェック、市場センチメント、任意のモメンタム分析を実行します。
• vet_dependency（slug、任意の token_address、chain）— DeFi プロトコルを基盤に構築する前に、プロトコルの健全性チェックと、任意のコントラクトレベルのリスクチェックを実行します。
• morning_briefing（任意の symbol）— マクロ経済カレンダー、決算カレンダー、センチメント、モメンタムの判定をまとめてダイジェストとして提示します。
• fact_check（output、任意の source）— 回答を主張ごとに分割し、それぞれを Wicked Sanity で検証します。
• verify_agent（wallet）— エージェントと取引する前に、Identity assertion と Reputation のステーク／ティアを確認します。
• find_reliable_tool（need、任意の category、min_score）— 実際の稼働率、レイテンシ、スキーマのスコアに基づいて、レジストリを検索します。
• agent_memory_guide（wallet、task）— 2 段階の署名付き Memory フローについてモデルに説明します。

環境変数

変数	必須	備考
WICKEDAPI_API_KEY	いいえ	4 つのサービスすべてで利用できる無料のレート制限付きアクセスです（同じキーをどこでも使用できます）。
WICKEDAPI_PAYER_PRIVATE_KEY	いいえ	Base メインネットのウォレット秘密鍵です。設定すると、各呼び出しで x402 チャレンジの支払いが USDC で自動的に行われ、キーは不要です。
WICKEDAPI_BASE_URL	いいえ	Trading Data API のベース URL を上書きします（デフォルトは https://api.wickedapi.com）。
WICKEDAPI_PROTOCOL_HEALTH_URL	いいえ	Protocol Health Oracle のベース URL を上書きします（デフォルトは https://protocol-health-oracle.wickedapi.com）。
WICKEDAPI_TOKEN_RISK_URL	いいえ	Token Risk Oracle のベース URL を上書きします（デフォルトは https://token-risk-oracle.wickedapi.com）。
WICKEDAPI_BROKER_SYNC_URL	いいえ	Broker Sync API のベース URL を上書きします（デフォルトは https://broker-sync-api.wickedapi.com）。
REGISTRY_API_KEY / IDENTITY_API_KEY / SANITY_API_KEY / MEMORY_API_KEY	いいえ	Registry、Identity、Sanity、Memory 検索の有料呼び出しに使える無料枠のキーです。省略すると、代わりに x402 チャレンジが返されます。
PAYWALL_API_KEY	paywall_* 用	paywall_signup で一度だけ返されるテナントの Bearer キーです。
REPUTATION_BASE_URL / REGISTRY_BASE_URL / IDENTITY_BASE_URL / SANITY_BASE_URL / MEMORY_BASE_URL / PAYWALL_BASE_URL	いいえ	対応するサービスのベース URL を上書きします（デフォルトは *.wickedapi.com のホストです）。
WICKEDAPI_SHOWCASE_URL	いいえ	リソースが使用するプラットフォームディレクトリのベース URL を上書きします（デフォルトは https://wickedapi.com）。

WICKEDAPI_API_KEY も WICKEDAPI_PAYER_PRIVATE_KEY も設定されていない場合でも、プロトコル上は有料呼び出しが成功します。データの代わりに、本物の 402 チャレンジがツールの結果として返されます。サービスの仕様の読み込みに失敗した場合（ネットワークの一時的な問題やサービスの停止など）、そのサービスのツールはセッション中にスキップされますが、ほかのツールは通常どおり登録されます。

ローカル開発

npm install
npm test            # builds, then unit + end-to-end tests (e2e needs network)
node dist/index.js  # stdio
node dist/http.js   # streamable HTTP on $PORT (default 8080)

このサーバーに該当しないこと

このサーバーはデータ処理のロジックを再実装するものではありません。10 個すべてのサービスで、MCP ツールの呼び出しを稼働中の Wicked HTTP エンドポイントにつなぐ薄いブリッジです。実際のマーケットデータ、インジケーター、スコアリング、リスクシグナルはすべて API 側にあります。