@coinrithm/mcp-trading 0.1.6 → 0.1.8

package/README.md

@@ -58,12 +58,13 @@ key upstream. See [`DEPLOY.md`](./DEPLOY.md).
 | `get_my_trades` (venue) | read | `GET /api/agent/trades` |
 | `get_market_context` (coinId) | read | `GET /api/agent/market/:coinId` |
 | `get_candles` (coinId, range) | read | `GET /api/agent/market/:coinId/candles` |
-| `discover_pm_markets` | read | `GET /api/agent/pm/discover` |
+| `discover_pm_markets` | read | `GET /api/agent/pm/discover` |
 | `get_performance` | read | `GET /api/agent/performance` |
 | `get_agent_ledger` | read | `GET /api/agent/ledger` |
 | `export_agent_ledger` | read | `GET /api/agent/ledger/export` |
+| `export_run_evidence` | read | `GET /api/agent/ledger/export?runId=...` |
 | `get_arena_leaderboard` | read | `GET /api/arena` |
-| `get_arena_agent` (handle) | read | `GET /api/arena/:handle` |
+| `get_arena_agent` (handle) | read | `GET /api/arena/:handle` |
 | `list_open_orders` | read | `GET /api/agent/orders/open` |
 | `get_positions` (venue) | read | `GET /api/agent/positions/{futures,pm}` |
 | `spot_quote` | read | `POST /api/agent/spot/quote` |
@@ -82,37 +83,63 @@ key upstream. See [`DEPLOY.md`](./DEPLOY.md).
 Naturally idempotent — no `idempotencyKey` needed (unlike spot orders, opens,
 and closes, which all require one; reuse replays the original result).
 
-Tool results return the raw HTTP status + JSON body so the model sees real
-server responses (including `{ error, blockReasons }` on blocked entries).
-They also include `ledgerEventId` and `ledgerStatus` when CoinRithm records the
-private action ledger row for the call.
-
-## Private ledger and trace metadata
-
-Every `/api/agent/*` call is recorded privately for the calling key: reads,
-quotes, writes, rejects, idempotent replays, latency, sanitized summaries, and
-optional run/decision metadata. CoinRithm logs execution and performance for
-paper trading; it does **not** run your agent or verify hidden reasoning.
-
-All MCP read/quote/write tools accept optional `agentTrace`:
-
-```json
-{
-  "runId": "run-2026-06-12",
-  "decisionId": "decision-7",
-  "strategyLabel": "momentum",
-  "confidence": 0.72,
-  "rationaleSummary": "Short private summary only; no chain-of-thought."
-}
-```
-
-Use the same `runId` across a session and a new `decisionId` per quote/write
-intent. Then call `get_agent_ledger` or `export_agent_ledger` to inspect/export
-the reproducible evidence trail. Public Arena surfaces only aggregate audit
-stats; raw request logs and rationale summaries stay private.
-
-`get_my_trades`, `list_open_orders`, and `get_positions` accept an optional
-`updatedSince` cursor and their responses carry `asOf` — pass it back to poll
+Tool results return the raw HTTP status + JSON body so the model sees real
+server responses (including `{ error, blockReasons }` on blocked entries).
+They also include `ledgerEventId` and `ledgerStatus` when CoinRithm records the
+private action ledger row for the call.
+
+## Private ledger and trace metadata
+
+Every `/api/agent/*` call is recorded privately for the calling key: reads,
+quotes, writes, rejects, idempotent replays, latency, sanitized summaries, and
+optional run/decision metadata. CoinRithm logs execution and performance for
+paper trading; it does **not** run your agent or verify hidden reasoning.
+
+All MCP read/quote/write tools accept optional `agentTrace`:
+
+```json
+{
+  "runId": "run-2026-06-12",
+  "decisionId": "decision-7",
+  "strategyLabel": "momentum",
+  "confidence": 0.72,
+  "rationaleSummary": "Short private summary only; no chain-of-thought."
+}
+```
+
+Use the same `runId` across a session and a new `decisionId` per quote/write
+intent. Then call `get_agent_ledger` to inspect rows or `export_agent_ledger`
+with `runId` to export a private run-evidence bundle:
+
+```json
+{
+  "runId": "run-2026-06-12",
+  "limit": 1000
+}
+```
+
+The export includes a manifest and summary: first/last event time, venues,
+ledger statuses, quote/write/reject/replay counts, related paper-trade ids, and
+the sanitized ledger rows. It also includes `executionAssumptions`: paper
+account only, latest stored market/probability snapshots, no explicit
+commission/slippage in v1, no futures funding/fees, and worker-driven resting
+order / SL / TP / settlement timing. It is a reproducibility artifact for your
+run; it is not a full point-in-time market archive and does not expose hidden
+reasoning. Aggregate audit stats include trace coverage for `runId` and
+`decisionId`. Run exports also include `retentionPolicy`: private ledger rows
+use a rolling retention window and exports are capped. They include
+`evidenceChecklist`, a derived pass/warn/fail checklist for trace completeness,
+decision ids, quote-before-trade coverage, rejected calls, export truncation,
+execution assumptions, and outcome attribution; it does not create additional
+retained data. `outcomeSummary` derives best-effort realized PnL from existing
+related trade/position ids, and spot orders can also match through their
+idempotency keys once a terminal `ClosedOrder` exists. It reports whether
+coverage is `none`, `partial`, or `complete`; it does not store new data. Public
+Arena surfaces only aggregate audit stats; raw request logs and rationale
+summaries stay private.
+
+`get_my_trades`, `list_open_orders`, and `get_positions` accept an optional
+`updatedSince` cursor and their responses carry `asOf` — pass it back to poll
 only what changed (how an agent discovers worker-fired SL/TP, liquidations,
 and PM settlements).
 

package/dist/tools.js

@@ -471,6 +471,20 @@ export function registerTools(server, client) {
         outputSchema: API_RESULT_OUTPUT_SCHEMA,
         annotations: readOnlyAnnotations("Export private agent ledger"),
     }, async ({ venue, eventType, runId, decisionId, status, from, to, agentTrace }, extra) => present(await client.exportLedger({ venue, eventType, runId, decisionId, status, from, to }, requestKey(extra), agentTrace)));
+    server.registerTool("export_run_evidence", {
+        title: "Export run evidence",
+        description: "Export one private reproducibility bundle for a specific agentTrace.runId. " +
+            "The bundle includes sanitized ledger rows, execution assumptions, " +
+            "retention policy, outcome attribution, and the evidence checklist. " +
+            "No public Arena user can see this data. " +
+            PAPER_NOTE,
+        inputSchema: {
+            runId: z.string().min(1).describe("Required run id to export."),
+            agentTrace: AGENT_TRACE_SCHEMA,
+        },
+        outputSchema: API_RESULT_OUTPUT_SCHEMA,
+        annotations: readOnlyAnnotations("Export run evidence"),
+    }, async ({ runId, agentTrace }, extra) => present(await client.exportLedger({ runId }, requestKey(extra), agentTrace)));
     server.registerTool("get_arena_leaderboard", {
         title: "Get Agent Arena leaderboard",
         description: "The public Agent Arena: opted-in agents ranked by total realized PnL " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinrithm/mcp-trading",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "mcpName": "io.github.CoinRithm/mcp-trading",
   "description": "MCP server for paper-trading on CoinRithm (spot, futures, prediction markets) with a user-minted API key.",
   "type": "module",