coinopai-mcp 1.2.10 → 2.0.1

package/README.md

@@ -59,6 +59,10 @@ Trust the process less. Verify the record more.
 
 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@1.2.10`.
+
+Settlement note: the MCP pins `@x402/core` and `@x402/evm` to `2.11.0` and signs EIP-3009 authorizations with a chain-aware timestamp. This avoids the Base RPC/facilitator clock-skew failure mode where a payment can be rejected as "authorization is not yet valid" or "valid before expired". Successful object responses include x402 settlement metadata under `_payment`, including the on-chain transaction hash when available.
+
 ---
 
 ## The Auditable Loop ($0.27/cycle)
@@ -147,6 +151,8 @@ Directional values are supporting context, not guarantees, human recommendations
 
 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
@@ -213,6 +219,10 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
 
 Not currently listed on Smithery. Use the `npx` install flow shown above until a verified public listing is live.
 
+### Developer smoke-test note
+
+When testing the published package with an MCP stdio harness, do not launch `npx coinopai-mcp@...` from inside the `coinopai-mcp` source checkout. npm can prefer the local package context and fail before the temporary bin is available. Test from another directory, or install into a temp project and launch `./node_modules/.bin/coinopai-mcp`.
+
 ### Registry status
 
 Prepared MCP Registry identity: `io.github.forgemeshlabs/coinopai-mcp`. Refresh the public directory submission after publishing this package so old `clawdbotworker` entries stop being canonical.
@@ -289,6 +299,8 @@ Route to an available symbol or wait 15 minutes for the next cycle.
 | Network | Base mainnet (`eip155:8453`) |
 | Token | USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`) |
 | Facilitator | Coinbase |
+| Client SDK pins | `@x402/core@2.11.0`, `@x402/evm@2.11.0` |
+| Receipt metadata | Successful object responses include `_payment` |
 
 ---
 

package/index.js

@@ -41,6 +41,12 @@ const BASE_RPC_URL = process.env.BASE_RPC_URL || "https://mainnet.base.org";
 const TOOLS = [
   {
     name: "search_agent_automations",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Search 819 agent automation prompts by keyword. Returns matching automations with title, description, complexity and services. Costs $0.01 USDC.",
     inputSchema: {
       type: "object",
@@ -53,6 +59,12 @@ const TOOLS = [
   },
   {
     name: "get_agent_automation",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Get the full agent automation prompt and workflow steps by slug. Costs $0.01 USDC.",
     inputSchema: {
       type: "object",
@@ -64,11 +76,23 @@ const TOOLS = [
   },
   {
     name: "list_automation_categories",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "List all 35 automation categories with counts. Costs $0.005 USDC.",
     inputSchema: { type: "object", properties: {} }
   },
   {
     name: "get_crypto_signals",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Latest Kronos model context for BTC, ETH, SOL, XRP, ADA. Directional values are supporting context, not standalone trade instructions; use them with the calibrated range, risk state, and audit record. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
@@ -79,11 +103,23 @@ const TOOLS = [
   },
   {
     name: "get_crypto_risk",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     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",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Recent Kronos context history for BTC/ETH/SOL/XRP/ADA. Use it to inspect model context and freshness before or after a decision. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
@@ -95,6 +131,12 @@ const TOOLS = [
   },
   {
     name: "get_crypto_decision",
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Create a market-intelligence journal entry from Kronos context. Returns directional_bias, confidence context, compliance metadata, regime, anomaly/calibration context, and a decision_id. Call audit_trade_decision with that ID after the evaluation window to see what happened. Costs $0.15 USDC.",
     inputSchema: {
       type: "object",
@@ -107,6 +149,12 @@ const TOOLS = [
   },
   {
     name: "check_trade_preflight",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Step 1 of the auditable decision loop. Checks market state, cooldown, data freshness, and model context before calling get_crypto_decision. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
@@ -119,6 +167,12 @@ const TOOLS = [
   },
   {
     name: "audit_trade_decision",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     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",
@@ -132,6 +186,12 @@ const TOOLS = [
   },
   {
     name: "get_crypto_forecast",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     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. Directional bias is supporting context; the calibrated range is the validated product. Costs $0.05 USDC.",
     inputSchema: {
       type: "object",
@@ -143,6 +203,12 @@ const TOOLS = [
   },
   {
     name: "review_signal_anomaly",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true,
+    },
     description: "Score a market signal feature set for unusual conditions before downstream analysis. Returns anomaly_score, anomaly_level, review_label, drivers, component scores, and market-intelligence disclaimers. Not financial advice and not a market activity instruction. Costs $0.07 USDC.",
     inputSchema: {
       type: "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coinopai-mcp",
-  "version": "1.2.10",
+  "version": "2.0.1",
   "mcpName": "io.github.forgemeshlabs/coinopai-mcp",
   "description": "Auditable market intelligence MCP with x402 payments, calibrated forecast ranges, anomaly review, risk context, and outcome audits",
   "main": "index.js",
@@ -16,7 +16,7 @@
     "start": "node index.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "keywords": [
     "mcp",
@@ -47,7 +47,7 @@
     "url": "https://github.com/forgemeshlabs/coinopai-mcp/issues"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.10.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@x402/core": "2.11.0",
     "@x402/evm": "2.11.0",
     "viem": "^2.0.0"