coinopai-mcp

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

Infraestructura de decisiones de pago para agentes autónomos.

Un servidor MCP que cobra a los agentes de IA por cada solicitud de inteligencia verificada, utilizando micropagos x402 en Base. Cada decisión obtiene un decision_id. Cada decision_id puede ser auditado frente a precios reales.

Este repositorio es la capa de cliente MCP; la inteligencia de pago se sirve desde endpoints x402 de CoinOpAI alojados.

También se muestran las predicciones incorrectas. Ese es el objetivo.

Arquitectura

┌──────────────────────────────────┐
│   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   │
└──────────────────────────────────┘

El agente llama a una herramienta → el servidor MCP recibe un HTTP 402 → firma automáticamente un micropago en USDC → reintenta con el encabezado de pago → se devuelven los datos. Configúrelo una vez, pague automáticamente desde la billetera de bajo saldo configurada.

El bucle verificado ($0.27/ciclo)

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

Cada decisión es autoverificable. El decision_id vincula la predicción con el resultado. La auditoría obtiene los precios reales del mercado y produce un veredicto. Nada está oculto.

Salida real

Paso 1 — Preflight (BTC, $0.05)

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

Paso 2 — Decisión (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"
}

Paso 3 — Auditoría (1h después, $0.07)

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

Resultados en vivo de ejecuciones reales:

Símbolo	Decisión	Confianza	Resultado 1h	Veredicto
XRP	SHORT	1.0	-0.54%	✅ GOOD_DECISION
ETH	LONG	0.68	-0.32%	❌ BAD_DIRECTION
BTC	LONG	0.40	+0.01%	— NOISE

Acierta algunas. Falla otras. El bucle hace que ambas sean visibles.

Herramientas

Herramienta	Qué hace	Coste
`check_trade_preflight`	Verificación de puerta: mercado permitido, enfriamiento, régimen, fuerza de señal	$0.05
`get_crypto_decision`	CONSIDER_LONG/SHORT/NO_ACTION + `decision_id`	$0.15
`audit_trade_decision`	Verificar frente a precios reales: veredicto + PnL%	$0.07
`get_crypto_signals`	Señales direccionales en vivo para BTC, ETH, SOL, XRP, ADA	$0.05
`get_crypto_risk`	Estado de riesgo de mercado + detección de régimen	$0.02
`get_crypto_signal_history`	Hasta 168h de historial de señales	$0.05
`search_agent_automations`	Buscar 819 prompts de automatización de agentes	$0.01
`get_agent_automation`	Prompt completo + pasos de flujo de trabajo por slug	$0.01
`list_automation_categories`	Las 35 categorías de automatización con conteos	$0.005

Sin claves API. Sin suscripciones. Pague por llamada en USDC.

Instalación

Claude Code

Añadir a ~/.claude/settings.json:

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

Reinicie Claude Code. Las 9 herramientas aparecerán automáticamente.

Claude Desktop

Añadir a su configuración de 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

Instalar a través de Smithery. Configure una billetera de pago dedicada de bajo saldo. No utilice su billetera principal.

Obtener una billetera

Instale Coinbase Wallet o cualquier billetera EVM
Cambie a la red Base
Compre o transfiera USDC ($1 = ~3 ciclos completos verificados)
Utilice una billetera Base dedicada de bajo saldo para los pagos del agente y proporcione su clave privada localmente a través de una variable de entorno.

La clave de su billetera permanece local. Nunca sale de su máquina. Cada pago es un micropago firmado, no una aprobación general.

Ejemplo de código de agente

// 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 + "%")

Cada respuesta de decisión incluye un campo next_step: su agente siempre sabe cuándo y cómo auditar.

¿Símbolo no disponible? Si un símbolo no está en el ciclo actual de Kronos:

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

Redirija a un símbolo disponible o espere 15 minutos para el siguiente ciclo.

Pila de pagos

Componente	Valor
Protocolo	x402
Esquema	ExactEvmScheme (EIP-3009 `transferWithAuthorization`)
Red	Base mainnet (`eip155:8453`)
Token	USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
Facilitador	Coinbase

Descargo de responsabilidad

Los resultados de las decisiones son señales probabilísticas solo para flujos de trabajo automatizados experimentales. No es asesoramiento financiero. Sistema temprano con un tamaño de muestra pequeño. Los resultados variarán. Nunca arriesgue capital que no pueda permitirse perder.

Licencia

MIT — ver LICENSE

coinopai-mcp

coinopai-mcp

Arquitectura

El bucle verificado ($0.27/ciclo)

Salida real

Herramientas

Instalación

Claude Code

Claude Desktop

Smithery

Obtener una billetera

Ejemplo de código de agente

Pila de pagos

Descargo de responsabilidad

Licencia

Resources

Latest Blog Posts

MCP directory API