coinopai-mcp

coinopai-mcp

監査可能な市場コンテキストを、較正済みの予測レンジと結果検証とともに提供します。

ソース： https://github.com/forgemeshlabs/coinopai-mcp

AI エージェントが Base 上で x402 のマイクロペイメントを使い、Kronos の市場コンテキストを購入できる MCP サーバーです。Kronos は売買を指示するオラクルではありません。較正済みのレンジ、リスクコンテキスト、意思決定ジャーナル、そして検証可能な監査記録をエージェントに提供します。

このリポジトリは MCP クライアント層です。有料のインテリジェンスは、ホストされた CoinOpAI x402 エンドポイントから提供されます。

不十分な判断も、誤った判断も表示されます。それが重要なのです。

Kronos が異なる理由

多くの市場 API は方向性を返したところで終わります。Kronos は較正済みのレンジとリスクコンテキストを先に提示し、decision_id を割り当てることで、将来の市場動向に照らしてすべての判断を監査できるようにします。

強みは監査ループにあります：

preflight -> decision -> audit

プロセスを鵜呑みにするのではなく、記録を検証しましょう。

---

アーキテクチャ

┌──────────────────────────────────┐
│   Claude Code / AI Agent         │
└──────────────┬───────────────────┘
               │  MCP (stdio)
               ▼
┌──────────────────────────────────┐
│        coinopai-mcp              │
│    npx coinopai-mcp              │
└──────────────┬───────────────────┘
               │  HTTP + 402 payment header
               ▼
┌──────────────────────────────────┐
│      x402.coinopai.com           │
│   Kronos intelligence API        │
└──────────────┬───────────────────┘
               │
               ▼
┌──────────────────────────────────┐
│   Coinbase x402 Facilitator      │
│   USDC settled on Base mainnet   │
└──────────────────────────────────┘

エージェントがツールを呼び出す → MCP サーバーが HTTP 402 を受信する → USDC のマイクロペイメントに自動署名する → 支払いヘッダーを付けて再試行する → データが返される。一度設定すれば、設定済みの少額残高ウォレットから自動的に支払われます。

現在のパッケージ：[email protected]。

決済に関する注記：MCP は @x402/core と @x402/evm を 2.11.0 に固定しています。成功したオブジェクトレスポンスには _payment の下に x402 決済メタデータが含まれ、利用可能な場合はオンチェーン取引ハッシュも含まれます。

---

監査可能なループ（1サイクルあたり $0.27）

check_trade_preflight  ──→  get_crypto_decision  ──→  [wait 1h]  ──→  audit_trade_decision
       $0.05                      $0.15                                      $0.07

   Market state?             Directional context              Outcome record
   Cooldown context?         Confidence context               Direction held?
   Regime context?           + decision_id                    Verdict
   Data freshness?           + audit hint                     + pnl_pct

すべての判断は自己検証可能です。decision_id が判断時の状況と結果を結び付けます。監査では実際の市場価格を取得し、判定を生成します。隠されているものはありません。

現在のステータス

稼働中

• モデルコンテキスト
• リスク評価
• 意思決定ジャーナリング
• 結果検証
• 予測：共形較正済みの80％価格レンジ（実測カバー率は約0.80）

研究中

• 方向性の優位性：バックテストで実証されていません（正解率は約51％）。検証済みのプロダクトは較正済みレンジであり、方向性ではありません
• 予測と執行の一致度分析：証拠を収集中

較正済みの予測レンジは稼働中で、検証済みです（共形較正、カバー率は約0.80）。方向性の値は補助的なコンテキストであり、それ単独で取引を指示するものではありません。較正済みレンジ、リスク状態、監査記録と併せてご利用ください。

方向性のコンテキスト

値	意味
正	強気のモデルコンテキスト
負	弱気のモデルコンテキスト
0.00-0.01	大きさは弱い
0.01-0.03	大きさは中程度
0.03+	大きさは強い

方向性の値は補助的なコンテキストであり、保証、人間による推奨、またはそれ単独で取引を指示するものではありません。較正済みレンジ、リスク状態、監査記録と併せてご利用ください。

---

実際の出力

ステップ 1 — 事前確認（BTC、$0.05）

{
  "allowed": true,
  "symbol": "BTC/USD",
  "market_state": "NORMAL",
  "signal_strength": "weak_or_mixed",
  "regime": "TREND",
  "cooldown_remaining_seconds": 0
}

ステップ 2 — 判断（BTC、$0.15）

{
  "symbol": "BTC/USD",
  "directional_bias": "upward",
  "confidence": 0.514,
  "compliance_mode": "market_intelligence_only",
  "regime": "TREND",
  "decision_id": "a3f8c1d2-9472-4dfe-b459-5df17b282614",
  "directional_edge": "none_demonstrated",
  "why_not_high": [
    "Directional confidence is capped by observed historical accuracy, not boosted by signal magnitude."
  ],
  "next_step": "Call audit_trade_decision with this decision_id after 1h using window=1h"
}

ステップ 3 — 監査（1時間後、$0.07）

{
  "decision_id": "a3f8c1d2-9472-4dfe-b459-5df17b282614",
  "direction_held": true,
  "pnl_pct": 0.82,
  "verdict": "GOOD_DECISION"
}

監査判定には GOOD_DECISION、BAD_DIRECTION、NOISE、NO_ACTION_TAKEN、PENDING が含まれます。Kronos は正しい判断も誤った判断もします。その両方を同じ記録で明らかにします。

評価期間が満了するまでは、新しい監査の結果が pending_window になることがあります。

---

ツール

ツール	機能	コスト
check_trade_preflight	ゲートチェック：市場が許可されているか、クールダウン、レジーム、モデルコンテキストを確認します	$0.05
get_crypto_decision	確率的な意思決定ジャーナルと decision_id を返します	$0.15
audit_trade_decision	実際の価格に照らして検証し、判定と損益率を返します	$0.07
get_crypto_signals	BTC、ETH、SOL、XRP、ADA のモデルコンテキストを返します	$0.05
get_crypto_signal_history	分析用に最大168時間分のコンテキスト履歴を返します	$0.05
get_crypto_forecast	BTC、ETH、SOL、XRP、ADA のコンフォーマル較正済み80％価格レンジ（経験的カバレッジ約0.80）を返します	$0.05
get_perp_funding	先物。 リアルタイムの無期限先物の資金調達率、マーク価格／インデックス価格、未決済建玉、ポジションの偏りを返します（Kraken Futures + Hyperliquid）	$0.02
check_futures_risk	先物。 この方向／レバレッジ／エントリーは較正済みレンジ内で持ちこたえられるかを確認します。清算までの距離と判定を返します	$0.05
get_futures_decision	先物。 較正済みレンジに基づくストップとターゲット、レバレッジ上限、清算、ポジションサイズ、資金調達コストを含む LONG / SHORT / FLAT を返します	$0.15
review_signal_anomaly	シグナルの特徴量を採点して異常な状況を検出し、レビューラベル、要因、コンポーネントスコアを返します	$0.07
get_crypto_risk	市場リスク状態とクールダウンのコンテキストを返します	$0.02
search_agent_automations	エージェント自動化プロンプト819件を検索します	$0.01
get_agent_automation	スラッグで指定した自動化の完全なプロンプトとワークフロー手順を返します	$0.01
list_automation_categories	全35種類の自動化カテゴリと件数を一覧表示します	$0.005

APIキー不要。サブスクリプション不要。USDCで呼び出しごとに支払います。

---

インストール

Claude Code

~/.claude/settings.json に追加します。

{
  "mcpServers": {
    "coinopai": {
      "command": "npx",
      "args": ["-y", "coinopai-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
      }
    }
  }
}

Claude Code を再起動します。ツールが自動的に表示されます。

Claude Desktop

Claude Desktop の設定ファイル（claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "coinopai": {
      "command": "npx",
      "args": ["-y", "coinopai-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<your-base-wallet-private-key>"
      }
    }
  }
}

Smithery

現在、Smithery には掲載されていません。検証済みの公開リスティングが公開されるまでは、上記の npx インストール手順を使用してください。

開発者向けスモークテストの注意

公開パッケージを MCP stdio ハーネスでテストする場合、coinopai-mcp のソースチェックアウト内から npx coinopai-mcp@... を起動しないでください。npm がローカルのパッケージコンテキストを優先し、一時的な実行ファイルが利用可能になる前に失敗することがあります。別のディレクトリからテストするか、一時プロジェクトにインストールして ./node_modules/.bin/coinopai-mcp を起動してください。

レジストリの状況

準備済みの MCP Registry ID：io.github.forgemeshlabs/coinopai-mcp。このパッケージの公開後、公開ディレクトリへの提出を更新し、古い clawdbotworker エントリが正規のものとして扱われなくなるようにしてください。

---

ウォレットを用意する

1. Coinbase Wallet または任意の EVM ウォレットをインストールします
2. ネットワークを Base に切り替えます
3. USDC を購入するかブリッジします（$1 で完全に検証済みのサイクルを約3回実行できます）
4. エージェントの支払いには、残高を少額に抑えた専用の Base ウォレットを使用し、秘密鍵を環境変数でローカルに設定します。

支払いの安全対策。 サーバーが署名するのは、Base メインネット上の CoinOpAI の受取人ウォレット宛てで、USDC による1回あたり $0.15 以下、かつセッションあたり $10 以下の支払いのみです。署名する前に、受取人、ネットワーク、資産、金額がこれらの条件と異なる場合は拒否します。環境変数 X402_MAX_PRICE_USD と X402_SESSION_BUDGET_USD では、これらの上限を引き下げることのみ可能です。サーバーは https://x402.coinopai.com のみと通信します（リダイレクトなし、タイムアウト60秒、レスポンス上限2 MB）。残高を少額に抑えた専用ウォレットを使用してください。

ウォレットのキーはローカルに保管されます。マシンの外に出ることはありません。各支払いは署名済みのマイクロペイメントであり、包括的な承認ではありません。

---

エージェントのコード例

// Step 1 — gate check ($0.05)
const pre = await mcp.call("check_trade_preflight", { symbol: "BTC" })
if (!pre.allowed) return  // cooldown, bad regime, or stale data

// Step 2 — get decision journal ($0.15)
const dec = await mcp.call("get_crypto_decision", { symbol: "BTC" })

// Store the decision_id — you'll need it to close the loop
const { decision_id, directional_bias, confidence } = dec

// Optional — review a feature set for anomaly context ($0.07)
const anomaly = await mcp.call("review_signal_anomaly", {
  symbol: "BTC",
  window: "24h",
  features: {
    price_change: 0.018,
    volume_change: 0.42,
    volatility: 0.031,
    signal_confidence: 72,
    risk_score: 31
  }
})
// review_label: "normal_review" | "review" | "elevated_review" | "critical_review"

// Step 3 — audit 1 hour later ($0.07)
const audit = await mcp.call("audit_trade_decision", {
  decision_id,
  window: "1h"
})
// verdict: "GOOD_DECISION" | "BAD_DIRECTION" | "NOISE"
console.log(audit.verdict, audit.pnl_pct + "%")

すべての意思決定レスポンスには next_step フィールドが含まれるため、エージェントはいつ、どのように監査すべきかを常に把握できます。

シンボルを利用できませんか？ 現在の Kronos サイクルにシンボルが含まれていない場合：

{
  "status": "UNAVAILABLE_THIS_CYCLE",
  "available_symbols": ["BTC/USD", "ETH/USD", "XRP/USD"],
  "retry_hint_seconds": 900
}

利用可能なシンボルに切り替えるか、次のサイクルまで15分待ってください。

---

決済スタック

コンポーネント	値
プロトコル	x402
スキーム	ExactEvmScheme（EIP-3009 transferWithAuthorization）
ネットワーク	Base メインネット（eip155:8453）
トークン	USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
ファシリテーター	Coinbase
クライアント SDK の固定バージョン	@x402/[email protected]、@x402/[email protected]
領収書のメタデータ	成功したオブジェクトレスポンスには _payment が含まれます

---

スポンサーカード（Lulu Ads）

無料枠のツールレスポンスには、Lulu Ads の明示されたスポンサーカードが1件含まれる場合があります。これは JSON の結果に含まれる、ラベル付きの通常のデータフィールドです。モデルが指示として読み取れるテキストではありません。

{
  "results": [...],
  "sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }
}

• 対象ツール： search_agent_automations、list_automation_categories、get_agent_automation、check_trade_preflight のみです。また、レスポンスで x402 決済が確定していない場合に限ります（_payment の領収書がない場合）。有料レスポンスにカードが含まれることはありません。
• 現在の状態： 現在、無料のツールは1つだけです。ウォレットも決済も必要としない /menu の通常の取得である list_tools がそれにあたり、現時点でカードが表示されるのはこのツールだけです。許可リストにある他の4つのツールは引き続き有料のため、カードは付加されません。この切り替えはサーバー側で行われます。運営者がこれらのエンドポイントのいずれかを無料（402 ではなく通常の 200）にすると、クライアントを変更せずにカードが表示されるようになります。
• 有料ツールには含まれません： get_crypto_signals、get_crypto_risk、get_crypto_signal_history、get_crypto_decision、audit_trade_decision、get_crypto_forecast、review_signal_anomaly、get_futures_decision、get_perp_funding、check_futures_risk が広告 SDK にアクセスすることはありません。
• 削除する場合： delete result.sponsored。
• カードの取得元： ForgeMesh 独自のパブリッシャーカードは、サーバー側で GET https://x402.coinopai.com/menu に付加されます。そのため、list_tools はそのまま受け渡すだけです。このパッケージには広告認証情報が含まれておらず、独自に広告ネットワークへアクセスすることもありません。
• 運営者の環境変数（フォークのみ）： LULU_ADS_PUBLISHER_ID と LULU_ADS_API_KEY を設定すると、フォークで独自のパブリッシャーカードをクライアント側で付加できます（両方とも必須です。いずれかが未設定の場合、パッケージは広告ネットワークに一切アクセスせず、レスポンスも変更されません）。LULU_ADS_ENABLED=false は緊急停止スイッチです。
• フェイルオープン： SDK エラーまたはタイムアウト（ハード上限2秒）が発生した場合、元のレスポンスを変更せずに返します。アクセスする外部ホストは ads.getlulu.dev のみです。

---

免責事項

意思決定の出力は、実験的な自動ワークフロー専用の、確率的なコンテキストおよびジャーナルエントリーです。金融上の助言ではありません。方向性のバイアスだけを独立した取引戦略として利用することの妥当性は検証されていません。結果は状況によって異なります。失っても構わない資金以外は、決してリスクにさらさないでください。

---

ForgeMesh エコシステムの一部

収益化されたエージェントエコシステムのためのインフラストラクチャです。

パッケージ	内容	インストール
affiliate-router-mcp	ベンダーに依存しない収益化ルーティング	npm i affiliate-router-mcp
coinopai-mcp	有料の暗号資産インテリジェンス（本パッケージ）	npm i coinopai-mcp
forgemesh-imagegen	有料の画像生成 MCP	npm i forgemesh-imagegen

各パッケージは単独で動作します。共通の依存関係は必要ありません。

---

ライセンス

MIT — LICENSE を参照