ForgeMesh CoinOpAI

Inteligencia de mercado auditable con rangos de pronóstico calibrados y revisión de anomalías.

Documentación

coinopai-mcp

Contexto de mercado auditable con rangos de pronóstico calibrados y verificación de resultados.

Fuente: https://github.com/forgemeshlabs/coinopai-mcp

Un servidor MCP que permite a los agentes de IA comprar contexto de mercado de Kronos con micropagos x402 en Base. Kronos no es un oráculo de compra/venta: brinda a los agentes rangos calibrados, contexto de riesgo, diarios de decisiones y registros de auditoría verificables.

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

Las llamadas débiles y las llamadas incorrectas también se muestran. Ese es el punto.

Por Qué Kronos Es Diferente

La mayoría de las APIs de mercado se detienen después de devolver una dirección. Kronos lidera con rangos calibrados y contexto de riesgo, luego asigna un decision_id para que cada decisión pueda auditarse contra el comportamiento futuro del mercado.

El foso es el bucle de auditoría:

preflight -> decision -> audit

Confía menos en el proceso. Verifica más el registro.

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 USDC → reintenta con el encabezado de pago → se devuelven los datos. Configura una vez, paga automáticamente desde la billetera de saldo bajo configurada.

Paquete actual: coinopai-mcp@1.2.10.

Nota de liquidación: el MCP fija @x402/core y @x402/evm a 2.11.0 y firma autorizaciones EIP-3009 con una marca de tiempo consciente de la cadena. Esto evita el modo de fallo de desviación de reloj RPC/facilitador de Base donde un pago puede rechazarse como "la autorización aún no es válida" o "válida antes de expirar". Las respuestas de objeto exitosas incluyen metadatos de liquidación x402 bajo _payment, incluido el hash de transacción en cadena cuando está disponible.

El Bucle Auditable ($0.27/ciclo)

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

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

Estado Actual

En vivo

Contexto del modelo
Evaluación de riesgo
Registro de decisiones
Verificación de resultados
Pronóstico: rango de precios del 80% calibrado conformalmente (~0.80 cobertura empírica)

Investigación

Ventaja direccional: ninguna demostrada en backtest (~51% de precisión) — el rango calibrado es el producto validado, no la dirección
Análisis de concordancia entre pronóstico y ejecución: recopilando evidencia

El rango de pronóstico calibrado está en vivo y validado (conformal, ~0.80 cobertura). Los valores direccionales son contexto de apoyo, no instrucciones comerciales independientes. Úsalos con el rango calibrado, el estado de riesgo y el registro de auditoría.

Contexto Direccional

Valor	Significado
Positivo	Contexto de modelo alcista
Negativo	Contexto de modelo bajista
0.00-0.01	Magnitud débil
0.01-0.03	Magnitud moderada
0.03+	Magnitud fuerte

Los valores direccionales son contexto de apoyo, no garantías, recomendaciones humanas o instrucciones comerciales independientes. Úsalos con el rango calibrado, el estado de riesgo y el registro de auditoría.

Salida Real

Paso 1 — Preflight (BTC, $0.05)

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

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

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

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

Los veredictos de auditoría incluyen GOOD_DECISION, BAD_DIRECTION, NOISE, NO_ACTION_TAKEN y PENDING. Kronos acierta algunas, falla otras y expone ambas a través del mismo registro.

Las auditorías recientes pueden devolver pending_window hasta que la ventana de evaluación madure.

Herramientas

Herramienta	Qué hace	Costo	Afiliado
`check_trade_preflight`	Verificación de puerta: mercado permitido, enfriamiento, régimen, contexto del modelo	$0.05	✓
`get_crypto_decision`	Diario de decisiones probabilístico + `decision_id`	$0.15	✓
`audit_trade_decision`	Verificar contra precios reales: veredicto + %PnL	$0.07	✓
`get_crypto_signals`	Contexto del modelo para BTC, ETH, SOL, XRP, ADA	$0.05	✓
`get_crypto_signal_history`	Hasta 168h de historial de contexto para análisis	$0.05	✓
`get_crypto_forecast`	Rango de precios del 80% calibrado conformalmente (~0.80 cobertura empírica) para BTC, ETH, SOL, XRP, ADA	$0.05	✓
`review_signal_anomaly`	Puntúa características de señales para condiciones inusuales; devuelve etiquetas de revisión, impulsores y puntuaciones de componentes	$0.07	—
`get_crypto_risk`	Estado de riesgo de mercado y contexto de enfriamiento	$0.02	—
`search_agent_automations`	Buscar 819 indicaciones de automatización de agentes	$0.01	—
`get_agent_automation`	Indicación completa + pasos de flujo de trabajo por slug	$0.01	—
`list_automation_categories`	Las 35 categorías de automatización con recuentos	$0.005	—

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

Instalación

Claude Code

Agrega a ~/.claude/settings.json:

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

Reinicia Claude Code. Las herramientas aparecen automáticamente.

Claude Desktop

Agrega a tu 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

Actualmente no está listado en Smithery. Usa el flujo de instalación npx mostrado arriba hasta que haya una lista pública verificada en vivo.

Nota de prueba de humo para desarrolladores

Al probar el paquete publicado con un arnés stdio MCP, no lances npx coinopai-mcp@... desde dentro del checkout del código fuente coinopai-mcp. npm puede preferir el contexto del paquete local y fallar antes de que el bin temporal esté disponible. Prueba desde otro directorio, o instala en un proyecto temporal y lanza ./node_modules/.bin/coinopai-mcp.

Estado del registro

Identidad del Registro MCP preparada: io.github.forgemeshlabs/coinopai-mcp. Actualiza el envío del directorio público después de publicar este paquete para que las entradas antiguas de clawdbotworker dejen de ser canónicas.

Obtén una Billetera

Instala Coinbase Wallet o cualquier billetera EVM
Cambia a la red Base
Compra o puentea USDC ($1 = ~3 ciclos verificados completos)
Usa una billetera Base dedicada de saldo bajo para pagos de agentes y proporciona su clave privada localmente mediante variable de entorno.

Tu clave de billetera permanece local. Nunca sale de tu 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 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 + "%")

Cada respuesta de decisión incluye un campo next_step — tu 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
}

Enruta a un símbolo disponible o espera 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
SDK cliente fija	`@x402/core@2.11.0`, `@x402/evm@2.11.0`
Metadatos de recibo	Las respuestas de objeto exitosas incluyen `_payment`

Atribución de Afiliados (vía Pyrimid)

Las herramientas de alto valor aceptan un parámetro opcional affiliate_id. Cuando se proporciona, el pago se enruta a través de la red de afiliados Pyrimid — el afiliado gana una comisión dividida dentro del precio listado. Sin costo adicional para el llamador.

Cómo funciona la división

Direct call (no affiliate_id):
  Caller pays $0.15  →  CoinOpAI receives $0.15

Affiliate call (affiliate_id present):
  Caller pays $0.15  →  CoinOpAI: 79.2% ($0.1188)
                      →  Affiliate: 19.8% ($0.0297)
                      →  Protocol:   1.0% ($0.0015)

El comprador siempre paga el precio listado. La división sale de la porción del vendedor.

Uso

Pasa affiliate_id en cualquier llamada de herramienta compatible:

// As an agent or user
await mcp.call("get_crypto_decision", {
  symbol: "BTC",
  affiliate_id: "af_youraffiliateID"
})

¿Construyendo un wrapper? Configúralo una vez vía env

Si estás construyendo un framework de agentes, wrapper MCP o automatización que integre herramientas CoinOpAI, configura tu ID de afiliado como variable de entorno. Cada llamada a través de tu wrapper gana una comisión automáticamente.

{
  "mcpServers": {
    "coinopai": {
      "command": "npx",
      "args": ["-y", "coinopai-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<agent-wallet-key>",
        "PYRIMID_AFFILIATE_ID": "af_<your-affiliate-id>"
      }
    }
  }
}

El argumento affiliate_id a nivel de herramienta tiene prioridad sobre la variable de entorno. Los llamadores siempre pueden anular.

Sin affiliate_id

Flujo x402 normal — CoinOpAI recibe el 100% del precio listado. Nada cambia para el llamador.

Descargo de Responsabilidad

Las salidas de decisiones son contexto probabilístico y entradas de diario solo para flujos de trabajo automatizados experimentales. No es asesoramiento financiero. El sesgo direccional por sí solo no ha sido validado como estrategia comercial independiente. Los resultados variarán. Nunca arriesgues capital que no puedas permitirte perder.

Parte del Ecosistema ForgeMesh

Infraestructura para ecosistemas de agentes monetizados.

Paquete	Qué	Instalación
affiliate-router-mcp	Enrutamiento de monetización neutral al proveedor	`npm i affiliate-router-mcp`
coinopai-mcp	Inteligencia cripto pagada (este paquete)	`npm i coinopai-mcp`
forgemesh-imagegen	Generación de imágenes pagada MCP	`npm i forgemesh-imagegen`

Cada paquete funciona de forma independiente. Sin dependencia compartida requerida.

Licencia

MIT — ver LICENSE