@coinrithm/mcp-trading 0.7.15 → 0.7.17

package/dist/tools.js

@@ -1,9 +1,4 @@
-// Registers the CoinRithm trading tools on an MCP server instance.
-//
-// Every tool wraps exactly one /api/agent/* call. Tool results return the raw
-// JSON body as text so the model sees the real server response (incl. error
-// shapes like { error, blockReasons }). HTTP-level failures are surfaced as
-// isError results rather than thrown so the model can react.
+import { pmPaperAgentOpenSchema, pmPaperCloseSchema } from "./pmPaperV2.js";
 import { z } from "zod";
 import { bearerFromHeader } from "./client.js";
 import { PAPER_EXECUTION_VERSION } from "./executionPolicy.js";
@@ -725,6 +720,32 @@ function mapSuccessfulBody(result, transform) {
     return result.ok ? { ...result, data: transform(result.data) } : result;
 }
 export function registerTools(server, client) {
+    // Separate opt-in inventory: never enrich existing market context or prompts.
+    if (process.env.COINRITHM_SPOT_REFERENCE_TOOLS_ENABLED === "true") {
+        server.registerTool("get_spot_reference", {
+            title: "Get optional spot reference",
+            description: "Read a separate Binance spot last-ticker reference and stored REST " +
+                "consensus fallback for one coinId (read scope). Reference only: " +
+                "stream price and rolling 24h quote volume are USDT; fallback price " +
+                "is USD, with no currency conversion. A 200 response can contain " +
+                "an unavailable stream or stale/unavailable fallback: inspect each " +
+                "status, reason and expiresAt. preferredSource does not establish " +
+                "freshness or execution eligibility. eventAt is emission, " +
+                "statisticsCloseAt is the ticker window close, receivedAt is " +
+                "acquisition and localPriceChangedAt is a local observation; " +
+                "lastTradeAt is unknown. This is not an executable quote, order-book " +
+                "depth or fill guarantee and does not replace get_market_context.",
+            inputSchema: {
+                coinId: z
+                    .string()
+                    .regex(/^[a-zA-Z0-9_-]{1,64}$/)
+                    .describe("CoinRithm coinId from resolve_symbol; not an exchange pair."),
+                agentTrace: AGENT_TRACE_SCHEMA,
+            },
+            outputSchema: API_RESULT_OUTPUT_SCHEMA,
+            annotations: readOnlyAnnotations("Get optional spot reference"),
+        }, async ({ coinId, agentTrace }, extra) => present(await client.getSpotReference(coinId, requestKey(extra), agentTrace)));
+    }
     // ---------------- identity ----------------
     server.registerTool("whoami", {
         title: "Who am I (CoinRithm)",
@@ -1571,6 +1592,63 @@ export function registerTools(server, client) {
         provenance,
         agentTrace,
     }, requestKey(extra))));
+    if (process.env.COINRITHM_PM_PAPER_V2_TOOLS_ENABLED === "true") {
+        server.registerTool("discover_pm_paper_v2_markets", {
+            title: "Discover PM paper v2 candidates",
+            description: "For server-configured PM paper v2 house keys only (other keys get 403 house_opt_in_required). Returns Kalshi/Polymarket outcomes with exact stored native identity (nativeMarket.key) and scheduled native end, filtered to the house's configured horizon; meta.boundedSelection reports how many were excluded and why. Candidate evidence only: open_pm_paper_v2 reacquires native identity, maturity, book and fees, and may still refuse. nativeEndAt is a scheduled end, not a settlement-time guarantee. " +
+                PAPER_NOTE_SHORT,
+            inputSchema: {
+                q: z
+                    .string()
+                    .max(100)
+                    .optional()
+                    .describe("Optional search text (title, outcome, topic)."),
+                limit: z
+                    .number()
+                    .int()
+                    .min(1)
+                    .max(50)
+                    .optional()
+                    .describe("Max events before filtering (1-50, default 20)."),
+                agentTrace: AGENT_TRACE_SCHEMA,
+            },
+            outputSchema: API_RESULT_OUTPUT_SCHEMA,
+            annotations: readOnlyAnnotations("Discover PM paper v2 candidates"),
+        }, async ({ q, limit, agentTrace }, extra) => present(await client.discoverPmPaperV2({ q, limit }, requestKey(extra), agentTrace)));
+        server.registerTool("open_pm_paper_v2", {
+            title: "Open opted-in PM paper position",
+            description: "For server-configured PM paper v2 house keys only. Opens against freshly acquired native Kalshi/Polymarket depth. maxCashBudget is an explicit exact decimal TOTAL cash budget including fees, not legacy stakeMusd. forecastProbability is required: the chance the side you buy pays out (percent above 1 and below 100, or a fraction above 0 and below 1; exactly 1 is refused as ambiguous); the API refuses an open whose forecast does not exceed the fee-inclusive cost per share. Server admission defaults off. Reuse the identical pm-entry key and body after uncertain delivery. Existing legacy tools keep their behavior. " +
+                PAPER_NOTE_SHORT,
+            inputSchema: pmPaperAgentOpenSchema.shape,
+            outputSchema: API_RESULT_OUTPUT_SCHEMA,
+            annotations: mutatingAnnotations("Open opted-in PM paper position", {
+                idempotent: true,
+            }),
+        }, async (body, extra) => present(await client.openPmPaperV2(pmPaperAgentOpenSchema.parse(body), requestKey(extra))));
+        server.registerTool("close_pm_paper_v2", {
+            title: "Request full PM paper exit",
+            description: "Request a durable FULL exit for an owned PM paper v2 position. A 202 accepted response is pending, NOT an executed sale or final PnL. Native depth and settlement can leave an exit pending or requiring attention. Reuse the identical pm-exit key/body to reconcile; only executed:true confirms completion. Entry pauses do not stop existing exits. " +
+                PAPER_NOTE_SHORT,
+            inputSchema: pmPaperCloseSchema.shape,
+            outputSchema: API_RESULT_OUTPUT_SCHEMA,
+            annotations: mutatingAnnotations("Request full PM paper exit", {
+                destructive: true,
+                idempotent: true,
+            }),
+        }, async (body, extra) => present(await client.closePmPaperV2(pmPaperCloseSchema.parse(body), requestKey(extra))));
+        server.registerTool("get_pm_paper_v2_positions", {
+            title: "Read PM paper v2 positions and exit receipts",
+            description: "Read the caller's bounded PM paper v2 positions, persisted exit intents and terminal accounting receipts. Pending/leased/retry/manual_attention do not establish execution or final PnL. " +
+                PAPER_NOTE_SHORT,
+            inputSchema: {
+                status: z.literal("open").optional(),
+                beforeId: z.number().int().positive().max(2147483647).optional(),
+                limit: z.number().int().min(1).max(50).optional(),
+            },
+            outputSchema: API_RESULT_OUTPUT_SCHEMA,
+            annotations: readOnlyAnnotations("Read PM paper v2 positions"),
+        }, async (query, extra) => present(await client.pmPaperV2Positions(requestKey(extra), query)));
+    }
     server.registerTool("report_pm_opportunity", {
         title: "Report a non-opened PM opportunity",
         description: "Save a durable SELF-REPORT of a prediction-market evaluation for a " +

package/package.json

@@ -1,97 +1,100 @@
-{
-  "name": "@coinrithm/mcp-trading",
-  "version": "0.7.15",
-  "mcpName": "io.github.CoinRithm/mcp-trading",
-  "description": "CoinRithm paper-trading toolkit: an MCP server (coinrithm-mcp) AND a self-host agent runner (coinrithm-agent) for spot, futures, and prediction markets with a user-minted API key.",
-  "type": "module",
-  "author": "CoinRithm",
-  "homepage": "https://coinrithm.com/agentic-trading",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/CoinRithm/coinrithm-agent-trading.git",
-    "directory": "packages/mcp-trading"
-  },
-  "bugs": {
-    "url": "https://github.com/CoinRithm/coinrithm-agent-trading/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "bin": {
-    "coinrithm-mcp": "dist/index.js",
-    "coinrithm-agent": "dist/agent/index.js"
-  },
-  "main": "dist/index.js",
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\"",
-    "start": "node dist/index.js",
-    "start:http": "node dist/http.js",
-    "smoke:agent": "npm run build && node scripts/agent-smoke.mjs",
-    "prepare": "npm run build"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "ai-agent",
-    "agent-trading",
-    "trading",
-    "paper-trading",
-    "crypto",
-    "futures",
-    "prediction-markets",
-    "polymarket",
-    "kalshi",
-    "claude",
-    "chatgpt",
-    "gemini",
-    "cursor",
-    "open-knowledge-format",
-    "okf",
-    "model-agnostic",
-    "leaderboard",
-    "coinrithm"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "express": "^4.21.0",
-    "yaml": "^2.5.0",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.13.0",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.14.0",
-    "@vitest/coverage-v8": "4.1.11",
-    "eslint": "^9.13.0",
-    "prettier": "^3.3.3",
-    "typescript": "^5.5.0",
-    "typescript-eslint": "^8.11.0",
-    "vitest": "4.1.11"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./engine": {
-      "types": "./dist/agent/engine.d.ts",
-      "import": "./dist/agent/engine.js"
-    },
-    "./package.json": "./package.json",
-    "./dist/*": "./dist/*"
-  }
-}
+{
+  "name": "@coinrithm/mcp-trading",
+  "version": "0.7.17",
+  "mcpName": "io.github.CoinRithm/mcp-trading",
+  "description": "CoinRithm MCP server (coinrithm-mcp) and self-host agent runner (coinrithm-agent): keyless prediction-market data across 12 venues, plus paper trading of crypto spot, futures, and prediction markets with a user-minted API key.",
+  "type": "module",
+  "author": "CoinRithm",
+  "homepage": "https://coinrithm.com/agentic-trading",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CoinRithm/coinrithm-agent-trading.git",
+    "directory": "packages/mcp-trading"
+  },
+  "bugs": {
+    "url": "https://github.com/CoinRithm/coinrithm-agent-trading/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "coinrithm-mcp": "dist/index.js",
+    "coinrithm-agent": "dist/agent/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http.js",
+    "smoke:agent": "npm run build && node scripts/agent-smoke.mjs",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "agent-trading",
+    "trading",
+    "paper-trading",
+    "crypto",
+    "futures",
+    "prediction-markets",
+    "prediction-market-data",
+    "market-data",
+    "polymarket",
+    "kalshi",
+    "claude",
+    "chatgpt",
+    "gemini",
+    "cursor",
+    "open-knowledge-format",
+    "okf",
+    "model-agnostic",
+    "leaderboard",
+    "coinrithm"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "express": "^4.21.0",
+    "json5": "2.2.3",
+    "yaml": "^2.5.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.13.0",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "eslint": "^9.13.0",
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.11.0",
+    "vitest": "4.1.11"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./engine": {
+      "types": "./dist/agent/engine.d.ts",
+      "import": "./dist/agent/engine.js"
+    },
+    "./package.json": "./package.json",
+    "./dist/*": "./dist/*"
+  }
+}