@0xinsider/mcp 2.10.0 → 2.11.4

package/dist/tools/get-whale-trades.js

@@ -3,19 +3,7 @@ import { fail, listResult } from "./result.js";
 function registerTradeList(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16304), kept live; it calls the deprecated ${tool.path} path. ` : ""}Get recent large trades from graded prediction market traders. Each trade includes a 0-1 review score, trader grade, and market context. Cursor-paginated, newest first.
-
-Args:
-  - limit (number, 1-100, default 20): Max results per page
-  - cursor (string, optional): Pagination cursor from previous response
-  - min_size (number, default 5000): Minimum trade size in USD
-  - category (string, optional): Filter by market category (case-insensitive)
-  - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F)
-  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60; false preserves the current result set
-  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
-  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
-
-Returns: List of large trades with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`,
+        description: tool.description,
         inputSchema: {
             limit: z.number().int().min(1).max(100).default(20)
                 .describe("Max results (1-100, default 20)"),
@@ -27,11 +15,11 @@ Returns: List of large trades with trader info, market context, size, side, pric
                 .describe("Filter by market category (case-insensitive)"),
             min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
                 .describe("Minimum trader grade"),
-            suspicious_only: z.boolean().optional()
-                .describe("Keep only persisted suspicion_score >= 60"),
+            suspicious_only: z.boolean().default(false)
+                .describe("Keep only rows with persisted suspicion_score >= 60"),
             min_market_volume_share: z.number().min(0).max(1).optional()
                 .describe("Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"),
-            sort: z.enum(["recent", "market_volume_share"]).optional()
+            sort: z.enum(["recent", "market_volume_share"]).default("recent")
                 .describe("Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over the last 30 days. A cursor is bound to the order it was minted in"),
         },
         annotations: {
@@ -62,8 +50,39 @@ Returns: List of large trades with trader info, market context, size, side, pric
         }
     });
 }
+const LARGE_TRADES_DESCRIPTION = `Get recent large trades from graded prediction market traders. Each trade includes a 0-1 review score, persisted suspicion facts, trader grade, and market context. Cursor-paginated, newest first.
+
+Args:
+  - limit (number, 1-100, default 20): Max results per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - min_size (number, default 5000): Minimum trade size in USD
+  - category (string, optional): Filter by market category (case-insensitive)
+  - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F)
+  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60; false preserves the current result set
+  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
+  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
+
+Returns: List of large trades with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`;
+const WHALE_TRADES_DESCRIPTION = `Deprecated alias of get_large_trades (#16304), kept live; it calls the deprecated /api/v1/whale-trades path. Get recent large trades from graded prediction market traders. Each trade includes a 0-1 review score, persisted suspicion facts, trader grade, and market context. Cursor-paginated, newest first.
+
+Args:
+  - limit (number, 1-100, default 20): Max results per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - min_size (number, default 5000): Minimum trade size in USD
+  - category (string, optional): Filter by market category (case-insensitive)
+  - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F)
+  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60; false preserves the current result set
+  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
+  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
+
+Returns: List of whale trades with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`;
 export function registerGetLargeTrades(server, client) {
-    registerTradeList(server, client, { name: "get_large_trades", title: "List large trades", path: "/api/v1/large-trades" });
+    registerTradeList(server, client, {
+        name: "get_large_trades",
+        title: "List large trades",
+        path: "/api/v1/large-trades",
+        description: LARGE_TRADES_DESCRIPTION,
+    });
 }
 /** Deprecated spelling of get_large_trades (#16304). */
 export function registerGetWhaleTrades(server, client) {
@@ -71,7 +90,7 @@ export function registerGetWhaleTrades(server, client) {
         name: "get_whale_trades",
         title: "List Whale Trades",
         path: "/api/v1/whale-trades",
-        deprecatedOf: "get_large_trades",
+        description: WHALE_TRADES_DESCRIPTION,
     });
 }
 //# sourceMappingURL=get-whale-trades.js.map

package/dist/tools/get-whale-trades.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-whale-trades.js","sourceRoot":"","sources":["../../src/tools/get-whale-trades.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-whale-trades.js","sourceRoot":"","sources":["../../src/tools/get-whale-trades.ts"],"names":[],"mappings":"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"}

package/dist/tools/pick-of-the-day.js

@@ -16,7 +16,7 @@ const readAnnotations = {
 export function registerGetPickOfTheDay(server, client) {
     server.registerTool("get_pick_of_the_day", {
         title: "Get Pick of the Day",
-        description: `Get today's published Pick of the Day: the sports markets where graded (S/A/B) sharp money is positioned, frozen at publish time. Pro-tier. Read \`picks\` in \`pick_rank\` order (normally 3-6 items, never more than six). Each pick carries the matchup, the backed side (pick_outcome_label), the frozen pre-game price and the return on the flat $1,000 stake (\`stake_usd\`, \`return_usd\`; \`return_per_100\` keeps the literal $100 basis), the sharp-money holders on that side, the top grade, CLV capture status, and the thesis. \`scheduled_picks\` lists today's selected-but-unreleased slots with only pick_rank, release_at, and kickoff; no market identity exists before release.
+        description: `Get today's published Pick of the Day: the sports markets where graded (S/A/B) sharp money is positioned, frozen at publish time. Pro-tier. Read \`picks\` in \`pick_rank\` order (normally 3-10 items, never more than ten). Each pick carries the matchup, the backed side (pick_outcome_label), the frozen pre-game price and the return on the flat $1,000 stake (\`stake_usd\`, \`return_usd\`; \`return_per_100\` keeps the literal $100 basis), the sharp-money holders on that side, the top grade, CLV capture status, and the thesis. \`scheduled_picks\` lists today's selected-but-unreleased slots with only pick_rank, release_at, and kickoff; no market identity exists before release.
 
 Before any pick is released the tool returns an error carrying reason pick_not_released and a retry_at instant: schedule the next read from retry_at (or the earliest scheduled_picks.release_at) instead of polling. A current-day pick whose holder proof is not readable yet is listed in \`proof_pending_picks\` (pick_rank, release_at, kickoff, retry_at) while \`picks\` carries the proof-readable picks; the tool returns read_model_warming with a retry only when no published pick has readable proof.
 

package/dist/tools/read-parity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-parity.d.ts","sourceRoot":"","sources":["../../src/tools/read-parity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"read-parity.d.ts","sourceRoot":"","sources":["../../src/tools/read-parity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAezC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BlF;AAqDD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBxF;AAED,gEAAgE;AAChE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBxF;AAgCD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAYhF;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAYhF;AA8BD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAarF;AAED,6DAA6D;AAC7D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAatF;AAMD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4CrF;AAID,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4CrF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BpF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAoC1F;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsBtF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDtF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB/E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB7E;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBzF;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAkC1F;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB3F;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B1F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB9E;AAGD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB/E;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4BhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4B5E;AA2CD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAO7F;AAED,sEAAsE;AACtE,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAO5F;AAyCD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAOlF;AAED,0DAA0D;AAC1D,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAOvF"}

package/dist/tools/read-parity.js

@@ -38,38 +38,33 @@ Returns: Ordered batch trader results with per-item success or error details. Ea
 function registerTradeHistory(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16304), kept live; it calls the deprecated ${tool.path} path. ` : ""}Replay historical large trades from the local record. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort.
-
-Args:
-  - limit (number, 1-100, default 20)
-  - cursor (string, optional): Pagination cursor with wth_ prefix
-  - min_size (number, optional): Minimum trade size in USD
-  - condition_id (string, optional): Exact raw provider condition_id
-  - trader (string, optional): Wallet, alias, or username
-  - category (string, optional)
-  - min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time
-  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60
-  - platform (string, optional): polymarket or all
-  - from/to (string, optional): RFC3339 traded_at bounds
-  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
-  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
-
-Returns: Historical large trades with replay metadata, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`,
+        description: tool.description,
         inputSchema: {
-            limit: z.number().int().min(1).max(100).default(20),
-            cursor: z.string().optional(),
-            min_size: z.number().min(0).optional(),
-            condition_id: z.string().optional(),
-            trader: z.string().optional(),
-            category: z.string().optional(),
-            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional(),
-            suspicious_only: z.boolean().optional(),
-            platform: z.enum(["polymarket", "all"]).optional(),
-            from: z.string().datetime().optional(),
-            to: z.string().datetime().optional(),
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe("Max results (1-100, default 20)"),
+            cursor: z.string().optional()
+                .describe("Pagination cursor from previous response"),
+            min_size: z.number().min(0).default(5000)
+                .describe("Minimum trade size in USD"),
+            condition_id: z.string().optional()
+                .describe("Exact raw provider condition_id"),
+            trader: z.string().optional()
+                .describe("Trader wallet, alias, or username"),
+            category: z.string().optional()
+                .describe("Filter by market category"),
+            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+                .describe("Minimum trader grade"),
+            suspicious_only: z.boolean().default(false)
+                .describe("Keep only rows with persisted suspicion_score >= 60"),
+            platform: z.enum(["polymarket", "all"]).optional()
+                .describe("Filter by provider platform"),
+            from: z.string().datetime().optional()
+                .describe("Inclusive traded_at lower bound"),
+            to: z.string().datetime().optional()
+                .describe("Exclusive traded_at upper bound"),
             min_market_volume_share: z.number().min(0).max(1).optional()
                 .describe("Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"),
-            sort: z.enum(["recent", "market_volume_share"]).optional()
+            sort: z.enum(["recent", "market_volume_share"]).default("recent")
                 .describe("Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over from, or the last 30 days when from is omitted. A cursor is bound to the order it was minted in"),
         },
         annotations: readAnnotations,
@@ -84,7 +79,28 @@ Returns: Historical large trades with replay metadata, current review_score (sig
     });
 }
 export function registerGetLargeTradesHistory(server, client) {
-    registerTradeHistory(server, client, { name: "get_large_trades_history", title: "Replay historical large trades", path: "/api/v1/large-trades/history" });
+    registerTradeHistory(server, client, {
+        name: "get_large_trades_history",
+        title: "Replay historical large trades",
+        path: "/api/v1/large-trades/history",
+        description: `Replay historical large trades from the local record. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort.
+
+Args:
+  - limit (number, 1-100, default 20)
+  - cursor (string, optional): Pagination cursor with wth_ prefix
+  - min_size (number, optional): Minimum trade size in USD
+  - condition_id (string, optional): Exact raw provider condition_id
+  - trader (string, optional): Wallet, alias, or username
+  - category (string, optional)
+  - min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time
+  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60
+  - platform (string, optional): polymarket or all
+  - from/to (string, optional): RFC3339 traded_at bounds
+  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
+  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
+
+Returns: Historical large trades with replay metadata, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`,
+    });
 }
 /** Deprecated spelling of get_large_trades_history (#16304). */
 export function registerGetWhaleTradesHistory(server, client) {
@@ -92,19 +108,32 @@ export function registerGetWhaleTradesHistory(server, client) {
         name: "get_whale_trades_history",
         title: "Replay Historical Whale Trades",
         path: "/api/v1/whale-trades/history",
-        deprecatedOf: "get_large_trades_history",
+        description: `Deprecated alias of get_large_trades_history (#16304), kept live; it calls the deprecated /api/v1/whale-trades/history path. Replay historical whale trades from local whale_alerts rows. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort.
+
+Args:
+  - limit (number, 1-100, default 20)
+  - cursor (string, optional): Pagination cursor with wth_ prefix
+  - min_size (number, optional): Minimum trade size in USD
+  - condition_id (string, optional): Exact raw provider condition_id
+  - trader (string, optional): Wallet, alias, or username
+  - category (string, optional)
+  - min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time
+  - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60
+  - platform (string, optional): polymarket or all
+  - from/to (string, optional): RFC3339 traded_at bounds
+  - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume
+  - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in)
+
+Returns: Historical whale trades with replay metadata, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.`,
     });
 }
 function registerTradeDetail(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16304), kept live; it calls the deprecated ${tool.path} path. ` : ""}Read one large trade by ID. Accepts either the wt_ ID returned by large-trade list/history responses or the raw numeric id.
-
-Args:
-  - id (string, required): Large trade ID such as wt_123 or 123
-
-Returns: One large trade with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label.`,
+        description: tool.description,
         inputSchema: {
+            // `get_large_trade_id_schema` in `backend/src/mcp/tools/schema.rs` names
+            // the prefix too (#18083); the two sides must read the same.
             id: z.string().trim().min(1).describe("Large trade ID such as wt_123 or 123"),
         },
         annotations: readAnnotations,
@@ -119,7 +148,17 @@ Returns: One large trade with trader info, market context, size, side, price, cu
     });
 }
 export function registerGetLargeTrade(server, client) {
-    registerTradeDetail(server, client, { name: "get_large_trade", title: "Get large trade", path: "/api/v1/large-trades" });
+    registerTradeDetail(server, client, {
+        name: "get_large_trade",
+        title: "Get large trade",
+        path: "/api/v1/large-trades",
+        description: `Read one large trade by ID. Accepts either the wt_ ID returned by large-trade list/history responses or the raw numeric id.
+
+Args:
+  - id (string, required): Large trade ID such as wt_123 or 123
+
+Returns: One large trade with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label.`,
+    });
 }
 /** Deprecated spelling of get_large_trade (#16304). */
 export function registerGetWhaleTrade(server, client) {
@@ -127,23 +166,23 @@ export function registerGetWhaleTrade(server, client) {
         name: "get_whale_trade",
         title: "Get Whale Trade",
         path: "/api/v1/whale-trades",
-        deprecatedOf: "get_large_trade",
+        description: `Deprecated alias of get_large_trade (#16304), kept live; it calls the deprecated /api/v1/whale-trades/{id} path, whose envelope keeps object: whale_trade. Read one whale trade by ID. Accepts either the wt_ ID returned by whale-trade list/history responses or the raw numeric whale_alerts.id.
+
+Args:
+  - id (string, required): Whale trade ID such as wt_123 or 123
+
+Returns: One whale trade with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label.`,
     });
 }
 function registerMarketFlowBatch(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16312), kept live; it calls the deprecated POST ${tool.path} path, whose envelope keeps object: market_intel_batch. Read-only batch lookup` : "Read-only batch lookup of market flow"} for 1-${MAX_BATCH_ITEMS} raw provider condition_id values. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST ${tool.path}.
-
-Args:
-  - condition_ids (string[], required): Raw provider condition IDs
-  - timeframe (string, optional): "1h", "4h", "24h", or "7d" (default "24h")
-
-Returns: Ordered batch market-flow results with per-item success or error details.`,
+        description: tool.description,
         inputSchema: {
             condition_ids: z.array(z.string().trim().min(1)).min(1).max(MAX_BATCH_ITEMS)
-                .describe("Raw provider condition IDs"),
-            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h"),
+                .describe("Raw provider condition_id values"),
+            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h")
+                .describe("Shared lookback window"),
         },
         annotations: readAnnotations,
     }, async ({ condition_ids, timeframe }) => {
@@ -160,6 +199,13 @@ export function registerBatchGetMarketFlow(server, client) {
         name: "batch_get_market_flow",
         title: "Batch market flow",
         path: "/api/v1/markets/flow/batch",
+        description: `Read-only batch lookup of market flow for 1-${MAX_BATCH_ITEMS} raw provider condition_id values. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST /api/v1/markets/flow/batch.
+
+Args:
+  - condition_ids (string[], required): Raw provider condition IDs
+  - timeframe (string, optional): "1h", "4h", "24h", or "7d" (default "24h")
+
+Returns: Ordered batch market-flow results with per-item success or error details.`,
     });
 }
 /** Deprecated spelling of batch_get_market_flow (#16312). */
@@ -168,7 +214,13 @@ export function registerBatchGetMarketIntel(server, client) {
         name: "batch_get_market_intel",
         title: "Batch Market Intelligence",
         path: "/api/v1/markets/intel/batch",
-        deprecatedOf: "batch_get_market_flow",
+        description: `Deprecated alias of batch_get_market_flow (#16312), kept live; it calls the deprecated POST /api/v1/markets/intel/batch path, whose envelope keeps object: market_intel_batch. Read-only batch lookup for 1-${MAX_BATCH_ITEMS} raw provider condition_id values. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST /api/v1/markets/intel/batch.
+
+Args:
+  - condition_ids (string[], required): Raw provider condition IDs
+  - timeframe (string, optional): "1h", "4h", "24h", or "7d" (default "24h")
+
+Returns: Ordered batch market-intelligence results with per-item success or error details.`,
     });
 }
 // Canonical "sharp money" spelling (epic #6912, #16300, #16308); "sharp
@@ -185,20 +237,23 @@ Args:
   - limit (number, 1-100, default 20): Max results per page
   - cursor (string, optional): Pagination cursor with smf_ prefix
   - category (string, optional): Filter by provider-backed market category
-  - platform (string, optional): "polymarket" or "all" (both select Polymarket)
+  - platform (string, optional): "polymarket" or "all" (default "all")
   - min_grade (string, optional): Minimum trader grade S, A, B, C, D, or F (default "B" = S/A/B)
   - direction (string, optional): Filter by net flow direction: "YES" or "NO"
 
 Returns: Ranked markets with sharp_money (net_flow_usd, direction, whale_trade_count, buy/sell volumes) and market identity. smart_money is a deprecated byte-identical alias of sharp_money.`,
         inputSchema: {
-            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h"),
-            limit: z.number().int().min(1).max(100).default(20),
+            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h")
+                .describe("Lookback window (default 24h)"),
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe("Max results (1-100, default 20)"),
             cursor: z.string().optional()
                 .describe("Pagination cursor with smf_ prefix"),
             category: z.string().optional()
                 .describe("Filter by provider-backed market category"),
-            platform: z.enum(["polymarket", "all"]).optional(),
-            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+            platform: z.enum(["polymarket", "all"]).default("all")
+                .describe("Platform filter (default all)"),
+            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).default("B")
                 .describe("Minimum trader grade (default B = S/A/B)"),
             direction: z.enum(["YES", "NO"]).optional()
                 .describe("Filter by net flow direction"),
@@ -226,20 +281,23 @@ Args:
   - limit (number, 1-100, default 20): Max results per page
   - cursor (string, optional): Pagination cursor with smf_ prefix
   - category (string, optional): Filter by provider-backed market category
-  - platform (string, optional): "polymarket" or "all" (both select Polymarket)
+  - platform (string, optional): "polymarket" or "all" (default "all")
   - min_grade (string, optional): Minimum trader grade S, A, B, C, D, or F (default "B" = S/A/B)
   - direction (string, optional): Filter by net flow direction: "YES" or "NO"
 
 Returns: Ranked markets with sharp_money (net_flow_usd, direction, whale_trade_count, buy/sell volumes) and market identity. smart_money is a deprecated byte-identical alias of sharp_money.`,
         inputSchema: {
-            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h"),
-            limit: z.number().int().min(1).max(100).default(20),
+            timeframe: z.enum(["1h", "4h", "24h", "7d"]).default("24h")
+                .describe("Lookback window (default 24h)"),
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe("Max results (1-100, default 20)"),
             cursor: z.string().optional()
                 .describe("Pagination cursor with smf_ prefix"),
             category: z.string().optional()
                 .describe("Filter by provider-backed market category"),
-            platform: z.enum(["polymarket", "all"]).optional(),
-            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+            platform: z.enum(["polymarket", "all"]).default("all")
+                .describe("Platform filter (default all)"),
+            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).default("B")
                 .describe("Minimum trader grade (default B = S/A/B)"),
             direction: z.enum(["YES", "NO"]).optional()
                 .describe("Filter by net flow direction"),
@@ -293,8 +351,10 @@ Returns: List of position timeline events with pagination metadata.`,
         inputSchema: {
             condition_id: z.string().trim().min(1).describe("Market condition ID"),
             trader_id: z.number().int().positive().describe("Internal traders.id alias"),
-            limit: z.number().int().min(1).max(100).default(20),
-            cursor: z.string().optional(),
+            limit: z.number().int().min(1).max(100).default(20)
+                .describe("Max events (1-100, default 20)"),
+            cursor: z.string().optional()
+                .describe("Pagination cursor from previous response"),
         },
         annotations: readAnnotations,
     }, async ({ condition_id, trader_id, limit, cursor }) => {
@@ -341,13 +401,20 @@ Args:
 
 Returns: Event replay window with retention and completeness metadata; each event carries trade when expanded.`,
         inputSchema: {
-            cursor: z.string().optional(),
-            limit: z.number().int().min(1).max(100).default(50),
-            trader: z.string().optional(),
-            condition_id: z.string().optional(),
-            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional(),
-            min_size: z.number().min(0).optional(),
-            expand: z.enum(["trade"]).optional(),
+            cursor: z.string().optional()
+                .describe("Opaque event replay cursor; bound to the filters the walk ran with"),
+            limit: z.number().int().min(1).max(100).default(50)
+                .describe("Max events (1-100, default 50)"),
+            trader: z.string().optional()
+                .describe("Only this wallet's trades: address, trd_ id or username (bound to the cursor)"),
+            condition_id: z.string().optional()
+                .describe("Only this market's trades: raw condition_id or mkt_ id (bound to the cursor)"),
+            min_grade: z.enum(["S", "A", "B", "C", "D", "F"]).optional()
+                .describe("Only wallets at this grade or better (bound to the cursor)"),
+            min_size: z.number().min(0).optional()
+                .describe("Only trades of at least this size in USD (bound to the cursor)"),
+            expand: z.enum(["trade"]).optional()
+                .describe("trade: add the public trade read to every event, so no per-event detail call is needed"),
         },
         annotations: readAnnotations,
     }, async ({ cursor, limit, trader, condition_id, min_grade, min_size, expand }) => {
@@ -445,9 +512,12 @@ Args:
 
 Returns: Report snapshot metadata and entries.`,
         inputSchema: {
-            week: z.string().regex(/^\d{4}-\d{2}$/).optional(),
-            from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
-            to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+            week: z.string().regex(/^\d{4}-\d{2}$/).optional()
+                .describe("ISO week selector in YYYY-WW format"),
+            from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional()
+                .describe("UTC source-range start in YYYY-MM-DD format"),
+            to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional()
+                .describe("UTC source-range end in YYYY-MM-DD format"),
         },
         annotations: readAnnotations,
     }, async ({ week, from, to }) => {
@@ -512,11 +582,11 @@ Returns: Trader export snapshot metadata.`,
 export function registerGetCoverage(server, client) {
     server.registerTool("get_coverage", {
         title: "Get coverage",
-        description: `Read which V1 data surfaces the API serves for Polymarket, the one venue it covers. Polymarket reports a status (supported, partial, or unsupported) for grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes.
+        description: `Read which V1 data surfaces the API serves for Polymarket, the one venue it covers. Every surface reports the status supported: grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes.
 
 Args: none
 
-Returns: Static backend-owned coverage document keyed by venue.`,
+Returns: Static backend-owned coverage document under the single key polymarket.`,
         inputSchema: {},
         annotations: readAnnotations,
     }, async () => {
@@ -533,11 +603,11 @@ Returns: Static backend-owned coverage document keyed by venue.`,
 export function registerGetPlatforms(server, client) {
     server.registerTool("get_platforms", {
         title: "Get Platform Capability Matrix",
-        description: `Deprecated alias of get_coverage (#16315), kept live; it calls the deprecated /api/v1/platforms path, which serves the same body. Read the provider capability matrix declaring which V1 data surfaces are supported, partial, or unsupported per platform. Polymarket reports a status (supported, partial, or unsupported) for grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes so you do not assume parity across providers.
+        description: `Deprecated alias of get_coverage (#16315), kept live; it calls the deprecated /api/v1/platforms path, which serves the same body. Read which V1 data surfaces the API serves for Polymarket, the one venue it covers. Every surface reports the status supported: grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes.
 
 Args: none
 
-Returns: Static backend-owned platform capability matrix keyed by platform.`,
+Returns: Static backend-owned coverage document under the single key polymarket.`,
         inputSchema: {},
         annotations: readAnnotations,
     }, async () => {
@@ -565,8 +635,9 @@ Args:
 
 Returns: List of matching content items with content_id, kind, slug, title, excerpt, and url.`,
         inputSchema: {
-            q: z.string().min(1).max(256).describe("Search query"),
-            limit: z.number().int().min(1).max(50).default(10),
+            q: z.string().min(1).max(256).describe("Search query (1-256 characters before whitespace trimming, non-empty after trimming)"),
+            limit: z.number().int().min(1).max(50).default(10)
+                .describe("Max results (1-50, default 10)"),
         },
         annotations: readAnnotations,
     }, async ({ q, limit }) => {
@@ -590,8 +661,9 @@ Args:
 
 Returns: Report snapshot metadata and entries (source_range, snapshot.status, completeness, reconciliation, report).`,
         inputSchema: {
-            granularity: z.enum(["daily", "weekly", "monthly"]),
-            period: z.string().min(1).describe("Period token for the granularity"),
+            granularity: z.enum(["daily", "weekly", "monthly"])
+                .describe("Report granularity selector"),
+            period: z.string().min(1).describe("Period token: daily YYYY-MM-DD, weekly YYYY-WW or a from,to YYYY-MM-DD pair, monthly YYYY-MM"),
         },
         annotations: readAnnotations,
     }, async ({ granularity, period }) => {
@@ -607,7 +679,7 @@ Returns: Report snapshot metadata and entries (source_range, snapshot.status, co
 function registerSideObservations(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16310), kept live; it calls the deprecated ${tool.path} path. ` : ""}Observation-only evidence for sports and esports markets, for a Pro API key: graded-holder piles the ranked route does not fund. cohort is required: wider_holder, in_play, or emerging_pile. Every row carries observation_only=true, and the canonical side, backing_score and side_share keys beside the older piled_side, conviction_score and smart_score spellings, which carry the same values. The page carries snapshot_as_of, degraded, funnel, and meta: when degraded is true the snapshot is partial and is not healthy evidence. Never feeds or changes get_pre_game_sides. A refreshed snapshot rejects an old cursor with cursor_expired; request the first page again.`,
+        description: tool.description,
         inputSchema: {
             cohort: z.enum(["wider_holder", "in_play", "emerging_pile"]).describe("Observation cohort; required"),
             category: z.string().optional().describe("Sport category; omitted means all sports"),
@@ -642,6 +714,7 @@ export function registerGetPreGameSideObservations(server, client) {
         name: "get_pre_game_side_observations",
         title: "List pre-game side observations",
         path: "/api/v1/sports/pre-game-side-observations",
+        description: `Observation-only evidence for sports and esports markets, for a Pro API key: graded-holder piles the ranked route does not fund. cohort is required: wider_holder (pre-game holder piles outside the funded route's admission), in_play (provider-confirmed live games with fresh holder and directional evidence), or emerging_pile (wider_holder rows whose sharp share is in [0.75, 0.85) with a complete holder scan, before kickoff). Every row carries observation_only=true, the provider market and token identity, kickoff, observed_at, the side and its price, the graded-holder distribution and scores, holder_scan_complete, directional_status, directional_rank_score, and rank. Canonical field names are side, backing_score and side_share; the older piled_side, conviction_score and smart_score keys carry the same values and stay on the wire. The page carries snapshot_as_of, degraded, funnel, and meta: when degraded is true the snapshot is partial and is not healthy evidence. This surface never feeds or changes get_pre_game_sides. Supports category (omitted means all sports; a non-sport category returns an empty list), limit (1-100, default 20), and cursor (pinned to the cohort and snapshot; a refreshed snapshot rejects it with cursor_expired, so request the first page again).`,
     });
 }
 /** Deprecated spelling of get_pre_game_side_observations (#16310). */
@@ -650,17 +723,17 @@ export function registerGetSportsEdgeObservations(server, client) {
         name: "get_sports_edge_observations",
         title: "Get Sports Edge Observations",
         path: "/api/v1/sports-edge-observations",
-        deprecatedOf: "get_pre_game_side_observations",
+        description: `Deprecated alias of get_pre_game_side_observations (#16310), kept live; it calls the deprecated /api/v1/sports-edge-observations path. Observation-only evidence for sports and esports markets, for a Pro API key: graded-holder piles the ranked signals route does not fund. cohort is required: wider_holder (pre-game holder piles outside the funded route's admission), in_play (provider-confirmed live games with fresh holder and directional evidence), or emerging_pile (wider_holder rows whose sharp share is in [0.75, 0.85) with a complete holder scan, before kickoff). Every row carries observation_only=true, the provider market and token identity, kickoff, observed_at, the piled outcome and price, the graded-holder distribution and scores, holder_scan_complete, directional_status, directional_rank_score, and rank. The page carries snapshot_as_of, degraded, funnel, and meta: when degraded is true the snapshot is partial and is not healthy evidence. This surface never feeds or changes get_sports_edge_signals. Supports category (omitted means all sports; a non-sport category returns an empty list), limit (1-100, default 20), and cursor (pinned to the cohort and snapshot; a refreshed snapshot rejects it with cursor_expired, so request the first page again).`,
     });
 }
 function registerSides(server, client, tool) {
     server.registerTool(tool.name, {
         title: tool.title,
-        description: `${tool.deprecatedOf ? `Deprecated alias of ${tool.deprecatedOf} (#16310), kept live; it calls the deprecated ${tool.path} path. ` : ""}Upcoming games ranked by the side profitable wallets hold, for a Pro API key. Eligibility uses recent graded large-trade flow; ranking uses current graded holder concentration. Returns market identity, the side and its token ID, kickoff, grade distribution, backing_score, ranked_at, and availability, with the older piled_side, signal_created_at, conviction_score and smart_score keys carrying the same values. Analytics, not an order instruction. Cached kickoffs may have passed; inspect timestamps before acting.`,
+        description: tool.description,
         inputSchema: {
             category: z.string().optional().describe("Sport category; omitted means all sports"),
             limit: z.number().int().min(1).max(100).default(20),
-            cursor: z.string().optional().describe("Opaque cursor pinned to a ranked snapshot"),
+            cursor: z.string().optional().describe("Opaque cursor pinned to a signal snapshot"),
             horizon_hours: z.number().int().min(1).max(48).default(12),
             min_grade: z.enum(["S", "A", "B"]).default("B"),
         },
@@ -689,6 +762,7 @@ export function registerGetPreGameSides(server, client) {
         name: "get_pre_game_sides",
         title: "List pre-game sides",
         path: "/api/v1/sports/pre-game-sides",
+        description: `Upcoming games ranked by the side profitable wallets hold, for a Pro API key. Eligibility uses recent graded large-trade flow; ranking uses current graded holder concentration. Returns provider market identity, the side and its token ID, kickoff, grade distribution, backing_score, ranked_at, and availability. Canonical field names are side, ranked_at, backing_score and side_share; the older piled_side, signal_created_at, conviction_score and smart_score keys carry the same values and stay on the wire. A row is analytics, not an order instruction. Cached snapshots can include kickoffs that have since passed; inspect timestamps before acting. Supports category, limit (1-100, default 20), cursor, horizon_hours (1-48, default 12), and min_grade (S, A, B; default B).`,
     });
 }
 /** Deprecated spelling of get_pre_game_sides (#16310). */
@@ -697,7 +771,7 @@ export function registerGetSportsEdgeSignals(server, client) {
         name: "get_sports_edge_signals",
         title: "Get Ranked Sports Edge Signals",
         path: "/api/v1/sports-edge-signals",
-        deprecatedOf: "get_pre_game_sides",
+        description: `Deprecated alias of get_pre_game_sides (#16310), kept live; it calls the deprecated /api/v1/sports-edge-signals path. Ranked pre-game sports and esports signals for a Pro API key. Eligibility uses recent graded whale flow; ranking uses current graded holder concentration. Returns provider market identity, backed outcome and token ID, kickoff, grade distribution, conviction, snapshot time, and availability. A signal is analytics, not an order instruction. Cached snapshots can include kickoffs that have since passed; inspect timestamps before acting. Supports category, limit (1-100, default 20), cursor, horizon_hours (1-48, default 12), and min_grade (S, A, B; default B).`,
     });
 }
 //# sourceMappingURL=read-parity.js.map