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 메인넷 (`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