coinopai-mcp

npm version npm downloads License: MIT Node.js payments network

自律型エージェントのための有料意思決定インフラ。

x402マイクロペイメント（Baseネットワーク）を使用して、検証済みのインテリジェンスリクエストごとにAIエージェントに課金するMCPサーバーです。すべての意思決定には decision_id が付与されます。すべての decision_id は実際の価格に基づいて監査可能です。

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

間違った予測も表示されます。それがこのシステムの目的です。

アーキテクチャ

┌──────────────────────────────────┐
│   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マイクロペイメントに署名して、支払いヘッダー付きで再試行し、データが返されます。一度設定すれば、設定した少額残高のウォレットから自動的に支払われます。

検証済みループ ($0.27/サイクル)

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

   Is now allowed?           CONSIDER_LONG/SHORT              GOOD_DECISION
   Cooldown check?           NO_ACTION                        BAD_DIRECTION
   Regime ok?                + decision_id                    NOISE
   Signal strength?          + next_step hint                 + pnl_pct

すべての意思決定は自己検証型です。decision_id が予測と結果をリンクさせます。監査によって実際の市場価格が取得され、判定が下されます。隠し事はありません。

実際の出力

ステップ 1 — プリフライト (BTC, $0.05)

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

ステップ 2 — 意思決定 (BTC, $0.15)

{
  "symbol": "BTC/USD",
  "suggested_action": "CONSIDER_LONG",
  "confidence": 0.72,
  "regime": "TREND",
  "decision_id": "a3f8c1d2-9472-4dfe-b459-5df17b282614",
  "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"
}

実際の実行結果:

シンボル	意思決定	確信度	1時間後の結果	判定
XRP	SHORT	1.0	-0.54%	✅ GOOD_DECISION
ETH	LONG	0.68	-0.32%	❌ BAD_DIRECTION
BTC	LONG	0.40	+0.01%	— NOISE

正解もあれば、不正解もあります。このループにより、その両方が可視化されます。

ツール

ツール	機能	コスト
`check_trade_preflight`	ゲートチェック: 市場の許可、クールダウン、レジーム、シグナル強度	$0.05
`get_crypto_decision`	CONSIDER_LONG/SHORT/NO_ACTION + `decision_id`	$0.15
`audit_trade_decision`	実際の価格に基づく検証: 判定 + PnL%	$0.07
`get_crypto_signals`	BTC, ETH, SOL, XRP, ADAのライブ方向性シグナル	$0.05
`get_crypto_risk`	市場リスク状態 + レジーム検知	$0.02
`get_crypto_signal_history`	最大168時間分のシグナル履歴	$0.05
`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を再起動します。9つのツールが自動的に表示されます。

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 経由でインストールします。支払い専用の少額残高ウォレットを設定してください。メインウォレットは使用しないでください。

ウォレットの準備

Coinbase Wallet または任意のEVMウォレットをインストール
Base ネットワークに切り替え
USDCを購入またはブリッジ ($1 = 約3回の完全検証サイクル分)
エージェント支払い用に少額残高のBase専用ウォレットを使用し、環境変数を通じてローカルで秘密鍵を提供します。

ウォレットの鍵はローカルに保持されます。マシンから外部へ送信されることはありません。各支払いは署名付きのマイクロペイメントであり、包括的な承認ではありません。

エージェントコードの例

// 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 ($0.15)
const dec = await mcp.call("get_crypto_decision", { symbol: "BTC" })
if (dec.suggested_action === "NO_ACTION") return

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

// Step 3 — act on the decision here...

// Step 4 — 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 mainnet (`eip155:8453`)
トークン	USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
ファシリテーター	Coinbase

免責事項

意思決定の出力は、実験的な自動ワークフローのための確率的なシグナルに過ぎません。投資助言ではありません。サンプルサイズの小さい初期段階のシステムです。結果は変動します。失っても問題のない資金以外は決してリスクにさらさないでください。

ライセンス

MIT — LICENSE を参照

coinopai-mcp

coinopai-mcp

アーキテクチャ

検証済みループ ($0.27/サイクル)

実際の出力

ツール

インストール

Claude Code

Claude Desktop

Smithery

ウォレットの準備

エージェントコードの例

支払いスタック

免責事項

ライセンス

Resources

Latest Blog Posts

MCP directory API