forgemeshlabs/coinopai-mcp

**Auditable market context with calibrated forecast ranges and outcome verification.**
**Source:** https://github.com/forgemeshlabs/coinopai-mcp
An MCP server that lets AI agents buy Kronos market context with x402 micropayments on Base. Kronos is not a buy/sell oracle: it gives agents calibrated ranges, risk context, decision journals, and audit records they can verify.
> This repo is the MCP client layer; paid intelligence is served from hosted CoinOpAI x402 endpoints.
> Weak calls and wrong calls are shown too. That's the point.
Why Kronos Is Different
Most market APIs stop after returning a direction. Kronos leads with calibrated ranges and risk context, then assigns a decision_id so every decision can be audited against future market behavior.
The moat is the audit loop:
Trust the process less. Verify the record more.
---
Architecture
The agent calls a tool → the MCP server receives an HTTP 402 → automatically signs a USDC micropayment → retries with the payment header → data returned. Configure once, pay automatically from the configured low-balance wallet.
Current package: coinopai-mcp@2.2.2.
Settlement note: the MCP pins @x402/core and @x402/evm to 2.11.0. Successful object responses include x402 settlement metadata under _payment, including the on-chain transaction hash when available.
---
The Auditable Loop ($0.27/cycle)
Every decision is self-verifying. The decision_id links the setup to the outcome. The audit fetches real market prices and produces a verdict. Nothing is hidden.
Current Status
**Live**
- Model context
- Risk assessment
- Decision journaling
- Outcome verification
- Forecast: conformally-calibrated 80% price range (~0.80 empirical coverage)
**Research**
- Directional edge: none demonstrated in backtest (~51% accurate) — the calibrated range is the validated product, not the direction
- Forecast vs execution agreement analysis: collecting evidence
The calibrated forecast range is live and validated (conformal, ~0.80 coverage). Directional values are supporting context, not standalone trade instructions. Use them with the calibrated range, risk state, and audit record.
Directional Context
| Value | Meaning |
|--------|---------|
| Positive | Bullish model context |
| Negative | Bearish model context |
| 0.00-0.01 | Weak magnitude |
| 0.01-0.03 | Moderate magnitude |
| 0.03+ | Strong magnitude |
Directional values are supporting context, not guarantees, human recommendations, or standalone trade instructions. Use them with the calibrated range, risk state, and audit record.
---
Real Output
**Step 1 — Preflight (BTC, $0.05)**
**Step 2 — Decision (BTC, $0.15)**
**Step 3 — Audit (1h later, $0.07)**
Audit verdicts include GOOD_DECISION, BAD_DIRECTION, NOISE, NO_ACTION_TAKEN, and PENDING. Kronos gets some right, gets some wrong, and exposes both through the same record.
Fresh audits can return pending_window until the evaluation window matures.
---
Tools
| Tool | What it does | Cost |
|------|-------------|------|
| check_trade_preflight | Gate check: market allowed, cooldown, regime, model context | $0.05 |
| get_crypto_decision | Probabilistic decision journal + decision_id | $0.15 |
| audit_trade_decision | Verify against real prices: verdict + PnL% | $0.07 |
| get_crypto_signals | Model context for BTC, ETH, SOL, XRP, ADA | $0.05 |
| get_crypto_signal_history | Up to 168h of context history for analysis | $0.05 |
| get_crypto_forecast | Conformally-calibrated 80% price range (~0.80 empirical coverage) for BTC, ETH, SOL, XRP, ADA | $0.05 |
| get_perp_funding | **Futures.** Live perp funding, mark/index, open interest, crowding (Kraken Futures + Hyperliquid) | $0.02 |
| check_futures_risk | **Futures.** Will this side / leverage / entry survive the calibrated range? Liquidation distance + verdict | $0.05 |