@coinrithm/mcp-trading 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -5,6 +5,34 @@ ships two binaries — `coinrithm-mcp` (the MCP server) and `coinrithm-agent` (t
 self-host agent runner) — versioned together. The CoinRithm **API contract** is
 versioned separately (see `openapi.yaml` `info.version`, currently `1.5.0`).
 
+## 0.7.1
+
+Docs + registry-metadata release; no tool behavior changes.
+
+- **README refresh**: the keyless `pm_data_*` data surface is now front and
+  center — 8 venues (Polymarket, Kalshi, Smarkets, Limitless, Manifold,
+  Metaculus, Futuur, Rothera; an earlier line wrongly listed PredictIt), the
+  anonymous hosted-endpoint path, and the `referenceProbability` /
+  `volumeHistory` fields the data tools return.
+- **`server.json`**: hosted endpoint's `Authorization` header marked optional
+  (the `pm_data_*` tools work anonymously — verified live) and the server
+  description now leads with the keyless data surface.
+- Ships the post-0.7.0 commits: `pm_data_event` advertises `volumeHistory`,
+  `pm_data_events` advertises `referenceProbability` on list items, and the
+  hosted MCP root (`GET /`) serves a self-describing JSON landing (with a
+  405 + hint on `GET /mcp`).
+
+## 0.7.0
+
+(Retroactive entry — released 2026-07-05 without a changelog note.)
+
+- **Four keyless `pm_data_*` tools** — CoinRithm's free public cross-venue
+  prediction-market dataset over MCP, no API key required and yours is never
+  attached: `pm_data_overview` (market-wide stats), `pm_data_events`
+  (cross-venue event list), `pm_data_event` (detail incl.
+  `crossSourceMatches` + resolution evidence), `pm_data_whales`
+  (large-trade tape).
+
 ## 0.5.0
 
 Agent-runner quality + reliability release. `coinrithm-agent` got materially

package/README.md

@@ -7,6 +7,15 @@ spot, futures, and prediction markets on
 no risk — a proving ground to show an agent works *before* anything is on the
 line, with a public **Agent Arena** leaderboard ranked by realized paper PnL.
 
+**Plus a free prediction-market data surface — no key at all.** The same server
+ships four keyless `pm_data_*` tools serving CoinRithm's public cross-venue
+dataset: live odds across 8 venues (Polymarket, Kalshi, Smarkets, Limitless,
+Manifold, Metaculus, Futuur, Rothera), cross-venue matches with a
+liquidity-aware reference probability, a whale-trade tape, and market-wide
+volume stats ($60B+ all-time tracked). Point any MCP client at the hosted
+endpoint `https://mcp.coinrithm.com/mcp` and call them anonymously — the API
+key is only needed for the trading tools.
+
 Agents are **OKF bundles** — an open, model-agnostic folder of markdown + YAML
 (strategy, persona, hard caps) that any runtime can read. Two ways to run the
 **same** bundle:
@@ -70,7 +79,9 @@ DB-driven runtime.
 
 The hosted HTTP server holds **no** key: each request brings its own
 `crk_live_…` in the Authorization header, and the server forwards exactly that
-key upstream. See [`DEPLOY.md`](./DEPLOY.md).
+key upstream. The Authorization header is **optional** on the hosted endpoint —
+the four keyless `pm_data_*` market-data tools work anonymously; every other
+tool requires it. See [`DEPLOY.md`](./DEPLOY.md).
 
 ## Configure (stdio)
 
@@ -131,12 +142,14 @@ key upstream. See [`DEPLOY.md`](./DEPLOY.md).
 | `pm_data_whales` | none (public) | `GET /api/prediction-markets/whales` |
 
 The four `pm_data_*` tools wrap CoinRithm's free public cross-venue dataset
-(all seven venues: Polymarket, Kalshi, Metaculus, PredictIt, Limitless,
-Manifold, Smarkets). They require no API key, never attach yours, and are
-research surfaces: `pm_data_event` includes `crossSourceMatches` (the same
-real-world question priced on other venues) and resolution evidence. Figures
-are self-computed aggregates on a disclosed per-venue basis — cite CoinRithm
-when quoting them.
+(all eight venues: Polymarket, Kalshi, Smarkets, Limitless, Manifold,
+Metaculus, Futuur, Rothera). They require no API key, never attach yours, and
+are research surfaces: `pm_data_events` list rows carry `referenceProbability`
+(a liquidity-aware cross-venue consensus on matched questions); `pm_data_event`
+includes `crossSourceMatches` (the same real-world question priced on other
+venues), `referenceProbability`, `volumeHistory`, and resolution evidence.
+Figures are self-computed aggregates on a disclosed per-venue basis — cite
+CoinRithm when quoting them.
 
 ¹ Server-flag gated; live now. Returns `403 … not enabled` only if CoinRithm later disables it.
 

package/dist/http.js

@@ -49,6 +49,32 @@ async function main() {
     app.get("/healthz", (_req, res) => {
         res.json({ ok: true, service: "coinrithm-mcp", transport: "streamable-http" });
     });
+    // Self-describing landing for humans and validate-before-recommend agents.
+    // GET / and GET /mcp used to 404, which reads as a dead service to anyone
+    // probing the published URL (GEO audit 2026-07-07). The MCP endpoint itself
+    // is POST-only streamable HTTP — say so instead of 404ing.
+    app.get("/", (_req, res) => {
+        res.json({
+            service: "CoinRithm MCP",
+            version: SERVER_VERSION,
+            description: "Model Context Protocol server for CoinRithm: keyless public prediction-market data tools (pm_data_*) plus paper-trading tools (spot, futures, prediction markets) with a crk_live_ API key. Paper only — never real money.",
+            endpoint: { url: "https://mcp.coinrithm.com/mcp", method: "POST", transport: "streamable-http" },
+            connect: "Point any MCP client at the endpoint above. Data tools need no key; trading tools take Authorization: Bearer crk_live_… (mint one at coinrithm.com → Settings → API Keys).",
+            localAlternative: "npx -y @coinrithm/mcp-trading",
+            docs: {
+                quickstart: "https://www.coinrithm.com/en/agentic-trading",
+                openapi: "https://www.coinrithm.com/openapi.yaml",
+                repo: "https://github.com/CoinRithm/coinrithm-agent-trading",
+                dataApi: "https://www.coinrithm.com/en/prediction-markets/api",
+            },
+        });
+    });
+    app.get("/mcp", (_req, res) => {
+        res.status(405).json({
+            error: "method_not_allowed",
+            message: "This is a POST-only streamable-HTTP MCP endpoint. Connect with an MCP client, or GET / for service info.",
+        });
+    });
     app.post("/mcp", async (req, res) => {
         // Per-request auth: read THIS caller's key from the Authorization header,
         // or from Smithery's non-reserved forwarding header.

package/dist/tools.js

@@ -880,9 +880,12 @@ export function registerTools(server, client) {
             "venues (Polymarket, Kalshi, Metaculus, PredictIt, Limitless, " +
             "Manifold, Smarkets) — broader than discover_pm_markets, which is " +
             "scoped to the paper-tradeable venues. Returns titles, probabilities, " +
-            "volume/liquidity, status, and source per event. Research/data only: " +
-            "to trade, use discover_pm_markets + pm_quote instead. No API key " +
-            "required.",
+            "volume/liquidity, status, and source per event, plus " +
+            "referenceProbability when present (CoinRithm's canonical cross-venue " +
+            "number for open events matched across venues — probability, " +
+            "venueCount, spreadPoints, and outcomeName for multi-outcome " +
+            "leaders). Research/data only: to trade, use discover_pm_markets + " +
+            "pm_quote instead. No API key required.",
         inputSchema: {
             q: z.string().optional().describe("Optional search text."),
             source: z
@@ -934,7 +937,9 @@ export function registerTools(server, client) {
             "number: the liquidity-weighted median Yes probability across matched " +
             "real-money venues, with venueCount and spreadPoints — quote all " +
             "three together, venues disagree and the spread says by how much), " +
-            "recent whale trades on the event, related events, and related news. " +
+            "recent whale trades on the event, related events, related news, and " +
+            "volumeHistory when present (daily volume points captured since " +
+            "2026-07-02 — read the event's volume trend directly from it). " +
             "This is the cross-venue research view; for tradability use pm_quote. " +
             "No API key required.",
         inputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinrithm/mcp-trading",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "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",