coinopai-mcp 1.2.6 → 1.2.7

package/README.md

@@ -7,16 +7,28 @@
 [![payments](https://img.shields.io/badge/payments-x402%20USDC-0052FF)](https://x402.org)
 [![network](https://img.shields.io/badge/network-Base-0052FF)](https://base.org)
 
-**Paid decision infrastructure for autonomous agents.**
+**Directional market intelligence with built-in outcome verification.**
 
 **Source:** https://github.com/forgemeshlabs/coinopai-mcp
 
-An MCP server that charges AI agents per verified intelligence request — using [x402](https://x402.org) micropayments on Base. Every decision gets a `decision_id`. Every `decision_id` can be audited against real prices.
+An MCP server that lets AI agents buy Kronos market intelligence with [x402](https://x402.org) micropayments on Base. Kronos does not just generate signals: every decision gets a `decision_id`, and every `decision_id` can be audited against later market prices.
 
 > This repo is the MCP client layer; paid intelligence is served from hosted CoinOpAI x402 endpoints.
 
 > Wrong predictions are shown too. That's the point.
 
+## Why Kronos Is Different
+
+Most signal APIs stop after making a prediction. Kronos assigns a `decision_id` and lets every decision be audited against future market behavior.
+
+The moat is the verification loop:
+
+```
+preflight -> decision -> audit
+```
+
+Trust the process less. Verify the record more.
+
 ---
 
 ## Architecture
@@ -63,6 +75,32 @@ check_trade_preflight  ──→  get_crypto_decision  ──→  [wait 1h]  ─
 
 Every decision is self-verifying. The `decision_id` links the prediction to the outcome. The audit fetches real market prices and produces a verdict. Nothing is hidden.
 
+## Current Status
+
+**Live**
+- Signals
+- Risk assessment
+- Decision guidance
+- Outcome verification
+
+**Research**
+- Forecast intelligence: validation in progress
+- Forecast vs execution agreement analysis: collecting evidence
+
+Forecast outputs are not exposed publicly. Validation comes first.
+
+## Signal Scale
+
+| Signal | Meaning |
+|--------|---------|
+| Positive | Bullish directional read |
+| Negative | Bearish directional read |
+| 0.00-0.01 | Weak magnitude |
+| 0.01-0.03 | Moderate magnitude |
+| 0.03+ | Strong magnitude |
+
+Signals are probabilistic model outputs, not guarantees or human recommendations.
+
 ---
 
 ## Real Output
@@ -120,9 +158,9 @@ It gets some right. It gets some wrong. The loop makes both visible.
 | `check_trade_preflight` | Gate check: market allowed, cooldown, regime, signal strength | $0.05 | ✓ |
 | `get_crypto_decision` | CONSIDER\_LONG/SHORT/NO\_ACTION + `decision_id` | $0.15 | ✓ |
 | `audit_trade_decision` | Verify against real prices: verdict + PnL% | $0.07 | ✓ |
-| `get_crypto_signals` | Live directional signals for BTC, ETH, SOL, XRP, ADA | $0.05 | ✓ |
-| `get_crypto_signal_history` | Up to 168h of signal history | $0.05 | ✓ |
-| `get_crypto_risk` | Market risk state + regime detection | $0.02 | — |
+| `get_crypto_signals` | Directional market intelligence for BTC, ETH, SOL, XRP, ADA | $0.05 | ✓ |
+| `get_crypto_signal_history` | Up to 168h of signal history for analysis | $0.05 | ✓ |
+| `get_crypto_risk` | Market risk state and cooldown context | $0.02 | — |
 | `search_agent_automations` | Search 819 agent automation prompts | $0.01 | — |
 | `get_agent_automation` | Full prompt + workflow steps by slug | $0.01 | — |
 | `list_automation_categories` | All 35 automation categories with counts | $0.005 | — |

package/index.js

@@ -68,7 +68,7 @@ const TOOLS = [
   },
   {
     name: "get_crypto_signals",
-    description: "Latest hourly directional signals for BTC, ETH, SOL, XRP, ADA from the Kronos model. Positive = bullish, negative = bearish. Costs $0.05 USDC.",
+    description: "Latest Kronos directional market intelligence for BTC, ETH, SOL, XRP, ADA. Positive = bullish, negative = bearish; magnitude under 0.01 is weak, 0.01-0.03 moderate, 0.03+ strong. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
       properties: {
@@ -78,12 +78,12 @@ const TOOLS = [
   },
   {
     name: "get_crypto_risk",
-    description: "Current crypto market risk state (NORMAL/ELEVATED/HIGH), regime detection, equity tracking, signal streaks. Costs $0.02 USDC.",
+    description: "Current market risk state and cooldown context for Kronos decisions. Useful as supporting context, not a standalone trading command. Costs $0.02 USDC.",
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "get_crypto_signal_history",
-    description: "Historical 15-minute crypto signals from Kronos — up to 168 hours of BTC/ETH/SOL/XRP/ADA data. Costs $0.05 USDC.",
+    description: "Recent Kronos signal history for BTC/ETH/SOL/XRP/ADA. Use it to inspect directional context before or after a decision. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
       properties: {
@@ -94,7 +94,7 @@ const TOOLS = [
   },
   {
     name: "get_crypto_decision",
-    description: "Get a probabilistic trade decision from Kronos — then verify it. Returns CONSIDER_LONG/SHORT/NO_ACTION with confidence, regime, and a decision_id. Call audit_trade_decision with that ID after 1h to see if the decision was right. Full loop: preflight ($0.05) → decision ($0.15) → audit ($0.07) = $0.27 per verified cycle. Costs $0.15 USDC.",
+    description: "Get probabilistic decision guidance from Kronos, then verify it. Returns CONSIDER_LONG/SHORT/NO_ACTION with confidence, regime, and a decision_id. Call audit_trade_decision with that ID after the evaluation window to see whether the direction held. Costs $0.15 USDC.",
     inputSchema: {
       type: "object",
       properties: {
@@ -106,7 +106,7 @@ const TOOLS = [
   },
   {
     name: "check_trade_preflight",
-    description: "Step 1 of the trade loop — checks if conditions allow a trade. Returns allowed:true/false, market state, cooldown, signal strength, warnings. If allowed, proceed to get_crypto_decision. Costs $0.05 USDC.",
+    description: "Step 1 of the verified decision loop. Checks market state, cooldown, data freshness, and signal strength before calling get_crypto_decision. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
       properties: {
@@ -118,7 +118,7 @@ const TOOLS = [
   },
   {
     name: "audit_trade_decision",
-    description: "The accountability step — verify any decision against real prices. Pass the decision_id from get_crypto_decision and a window (1h/4h/24h). Returns: did the direction hold? What was the PnL%? Verdict: GOOD_DECISION, BAD_DIRECTION, or NOISE. Every decision should be audited. Costs $0.07 USDC.",
+    description: "The accountability step. Verify a Kronos decision_id against later market prices. Returns whether direction held, PnL%, and a verdict: GOOD_DECISION, BAD_DIRECTION, NOISE, or NO_ACTION_TAKEN. Costs $0.07 USDC.",
     inputSchema: {
       type: "object",
       properties: {
@@ -128,6 +128,17 @@ const TOOLS = [
       },
       required: ["decision_id"]
     }
+  },
+  {
+    name: "get_crypto_forecast",
+    description: "Conformally-calibrated price forecast: an honest 80% prediction interval (range_80, ~0.80 empirical coverage) plus point return and upside probability for BTC/ETH/SOL/XRP/ADA. The directional point has no demonstrated backtest edge (~51% accurate) — the calibrated range is the validated product. Costs $0.05 USDC.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        symbol: { type: "string", description: "Symbol: BTC, ETH, SOL, XRP, ADA (default: BTC)" },
+        affiliate_id: { type: "string", description: "Optional Pyrimid affiliate ID (af_xxxxx). Affiliate earns a commission from within the listed price — no extra cost to you." }
+      }
+    }
   }
 ];
 
@@ -229,7 +240,7 @@ async function main() {
   }
 
   const server = new Server(
-    { name: "coinopai-mcp", version: "1.2.6" },
+    { name: "coinopai-mcp", version: "1.2.7" },
     { capabilities: { tools: {} } }
   );
 
@@ -272,6 +283,9 @@ async function main() {
         case "audit_trade_decision":
           data = await callPaid(paymentContext, `/api/kronos/audit?decision_id=${encodeURIComponent(args.decision_id)}&window=${encodeURIComponent(args.window || "4h")}`, affiliateId);
           break;
+        case "get_crypto_forecast":
+          data = await callPaid(paymentContext, `/api/kronos/forecast?symbol=${encodeURIComponent(args.symbol || "BTC")}`, affiliateId);
+          break;
         default:
           throw new Error("Unknown tool: " + name);
       }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "coinopai-mcp",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "mcpName": "io.github.forgemeshlabs/coinopai-mcp",
-  "description": "MCP server for CoinOpAI — agent automation prompts and crypto signals via x402 micropayments on Base",
+  "description": "Directional crypto market intelligence MCP with x402 payments, decision guidance, and built-in outcome verification",
   "main": "index.js",
   "bin": {
     "coinopai-mcp": "index.js"

package/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.forgemeshlabs/coinopai-mcp",
-  "description": "Kronos crypto signals + trade decisions + 819 automation prompts. x402 micropayments, USDC/Base.",
+  "description": "Directional crypto market intelligence with decision guidance, outcome verification, and x402 micropayments on Base.",
   "repository": {
     "url": "https://github.com/forgemeshlabs/coinopai-mcp",
     "source": "github"