coinopai-mcp 1.2.5 → 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

@@ -25,10 +25,12 @@ const USDC_ABI = parseAbi([
 ]);
 // Paths with registered Pyrimid product IDs — other paths fall back to standard x402
 const PYRIMID_PRODUCTS = {
-  "/api/kronos/signals":   { productId: 1n, priceUsdc: 50000n },
+  "/api/kronos/signals":   { productId: 1n, priceUsdc:  50000n },
   "/api/kronos/decision":  { productId: 2n, priceUsdc: 150000n },
-  "/api/kronos/preflight": { productId: 4n, priceUsdc: 50000n },
-  "/api/kronos/audit":     { productId: 5n, priceUsdc: 70000n },
+  "/api/kronos/preflight": { productId: 4n, priceUsdc:  50000n },
+  "/api/kronos/audit":     { productId: 5n, priceUsdc:  70000n },
+  "/api/kronos/risk":      { productId: 6n, priceUsdc:  20000n },
+  "/api/kronos/history":   { productId: 7n, priceUsdc:  50000n },
 };
 const IMAGEGEN_URL = "https://imagegen.coinopai.com";
 const PYRIMID_PRODUCTS_IMAGEGEN = {
@@ -66,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: {
@@ -76,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: {
@@ -92,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: {
@@ -104,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: {
@@ -116,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: {
@@ -126,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." }
+      }
+    }
   }
 ];
 
@@ -221,15 +234,13 @@ async function callPaid(ctx, path, affiliateId, opts = {}) {
 
 async function main() {
   let ctx;
-  try {
-    ctx = buildHttpClient();
-  } catch (e) {
-    process.stderr.write("[coinopai-mcp] " + e.message + "\n");
-    process.exit(1);
+  function getPaymentContext() {
+    if (!ctx) ctx = buildHttpClient();
+    return ctx;
   }
 
   const server = new Server(
-    { name: "coinopai-mcp", version: "1.2.5" },
+    { name: "coinopai-mcp", version: "1.2.7" },
     { capabilities: { tools: {} } }
   );
 
@@ -240,36 +251,40 @@ async function main() {
     try {
       // Affiliate ID: tool arg takes precedence, then env fallback, then none
       const affiliateId = args.affiliate_id || process.env.PYRIMID_AFFILIATE_ID || null;
+      const paymentContext = getPaymentContext();
       let data;
       switch (name) {
         // Low-value utility endpoints — no affiliate routing
         case "search_agent_automations":
-          data = await callPaid(ctx, `/api/search?q=${encodeURIComponent(args.query || "")}&limit=${args.limit || 20}`, null);
+          data = await callPaid(paymentContext, `/api/search?q=${encodeURIComponent(args.query || "")}&limit=${args.limit || 20}`, null);
           break;
         case "get_agent_automation":
-          data = await callPaid(ctx, `/api/automation/${encodeURIComponent(args.slug)}`, null);
+          data = await callPaid(paymentContext, `/api/automation/${encodeURIComponent(args.slug)}`, null);
           break;
         case "list_automation_categories":
-          data = await callPaid(ctx, "/api/categories", null);
+          data = await callPaid(paymentContext, "/api/categories", null);
           break;
         case "get_crypto_risk":
-          data = await callPaid(ctx, "/api/kronos/risk", null);
+          data = await callPaid(paymentContext, "/api/kronos/risk", affiliateId);
           break;
         // High-value endpoints — affiliate routing enabled
         case "get_crypto_signals":
-          data = await callPaid(ctx, "/api/kronos/signals", affiliateId);
+          data = await callPaid(paymentContext, "/api/kronos/signals", affiliateId);
           break;
         case "get_crypto_signal_history":
-          data = await callPaid(ctx, `/api/kronos/history?hours=${args.hours || 24}`, affiliateId);
+          data = await callPaid(paymentContext, `/api/kronos/history?hours=${args.hours || 24}`, affiliateId);
           break;
         case "get_crypto_decision":
-          data = await callPaid(ctx, `/api/kronos/decision?symbol=${encodeURIComponent(args.symbol || "BTC")}`, affiliateId);
+          data = await callPaid(paymentContext, `/api/kronos/decision?symbol=${encodeURIComponent(args.symbol || "BTC")}`, affiliateId);
           break;
         case "check_trade_preflight":
-          data = await callPaid(ctx, `/api/kronos/preflight?symbol=${encodeURIComponent(args.symbol || "BTC")}`, affiliateId);
+          data = await callPaid(paymentContext, `/api/kronos/preflight?symbol=${encodeURIComponent(args.symbol || "BTC")}`, affiliateId);
           break;
         case "audit_trade_decision":
-          data = await callPaid(ctx, `/api/kronos/audit?decision_id=${encodeURIComponent(args.decision_id)}&window=${encodeURIComponent(args.window || "4h")}`, affiliateId);
+          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);
@@ -282,6 +297,9 @@ async function main() {
 
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  process.stdin.resume();
+  process.stdin.on("end", () => process.exit(0));
+  setInterval(() => {}, 1 << 30);
 }
 
 main();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "coinopai-mcp",
-  "version": "1.2.5",
+  "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,17 +1,17 @@
 {
   "$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"
   },
-  "version": "1.2.5",
+  "version": "1.2.6",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "coinopai-mcp",
-      "version": "1.2.5",
+      "version": "1.2.6",
       "transport": {
         "type": "stdio"
       },