@0xinsider/mcp 2.1.3 → 2.4.0

package/dist/tools/get-insider-radar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-insider-radar.d.ts","sourceRoot":"","sources":["../../src/tools/get-insider-radar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAwDlF"}
+{"version":3,"file":"get-insider-radar.d.ts","sourceRoot":"","sources":["../../src/tools/get-insider-radar.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAOzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BlF"}

package/dist/tools/get-insider-radar.js

@@ -1,51 +1,29 @@
-import { z } from "zod";
-import { fail, listResult } from "./result.js";
+// Deprecated alias of get_suspicious_trades (#16301). It keeps calling the
+// deprecated /api/v1/insider-radar path and shares the canonical tool's schema
+// and wording, so an existing client keeps working unchanged.
+import { fail, listResult, ok } from "./result.js";
+import { SUSPICIOUS_TRADES_DESCRIPTION, suspiciousTradesInputSchema, } from "./get-suspicious-trades.js";
 export function registerGetInsiderRadar(server, client) {
     server.registerTool("get_insider_radar", {
         title: "Get Insider Radar Flags",
-        description: `Suspicious trading pattern flags — pre-resolution accumulation and coordinated wallets. Each flag carries recorded per-signal component scores; they are nullable and historical. Cursor-paginated by suspicion score (highest first).
-
-Each flag includes:
-- suspicion_score (0-100)
-- severity (flag or watch)
-- Sub-scores: timing, edge, size, fresh_wallet
-- Evidence JSON with details
-
-Args:
-  - limit (number, 1-100, default 20): Max results per page
-  - cursor (string, optional): Pagination cursor from previous response
-  - min_suspicion (number, 0-100, default 0): Minimum suspicion score
-  - severity (string, optional): Filter by severity: "flag" or "watch"
-
-Returns: List of radar flags with trader, market, scores, and evidence.`,
-        inputSchema: {
-            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_suspicion: z.number().min(0).max(100).default(0)
-                .describe("Minimum suspicion score (0-100)"),
-            severity: z.enum(["flag", "watch"]).optional()
-                .describe("Filter by severity level"),
-        },
+        description: `Deprecated alias of get_suspicious_trades (#16301), kept live; it calls the deprecated /api/v1/insider-radar path. ${SUSPICIOUS_TRADES_DESCRIPTION}`,
+        inputSchema: suspiciousTradesInputSchema,
         annotations: {
             readOnlyHint: true,
             destructiveHint: false,
             idempotentHint: true,
             openWorldHint: false,
         },
-    }, async ({ limit, cursor, min_suspicion, severity }) => {
+    }, async ({ limit, cursor, min_suspicion, severity, mode }) => {
         try {
             const response = await client.request("/api/v1/insider-radar", {
                 limit,
                 cursor,
                 min_suspicion,
                 severity,
+                mode,
             });
-            const result = listResult(response);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
+            return ok(listResult(response));
         }
         catch (error) {
             return fail(error);

package/dist/tools/get-insider-radar.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-insider-radar.js","sourceRoot":"","sources":["../../src/tools/get-insider-radar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAiB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;;;;;;;;;;;;;;wEAcqD;QAClE,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;iBAChD,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC1B,QAAQ,CAAC,0CAA0C,CAAC;YACvD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;iBACjD,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;iBAC3C,QAAQ,CAAC,0BAA0B,CAAC;SACxC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE;gBAC7D,KAAK;gBACL,MAAM;gBACN,aAAa;gBACb,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-insider-radar.js","sourceRoot":"","sources":["../../src/tools/get-insider-radar.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,+EAA+E;AAC/E,8DAA8D;AAI9D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAiB;IAC1E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,sHAAsH,6BAA6B,EAAE;QAClK,WAAW,EAAE,2BAA2B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE;gBAC7D,KAAK;gBACL,MAAM;gBACN,aAAa;gBACb,QAAQ;gBACR,IAAI;aACL,CAAC,CAAC;YACH,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-leaderboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-leaderboard.d.ts","sourceRoot":"","sources":["../../src/tools/get-leaderboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAkDjF"}
+{"version":3,"file":"get-leaderboard.d.ts","sourceRoot":"","sources":["../../src/tools/get-leaderboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAsBzC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAkDjF"}

package/dist/tools/get-leaderboard.js

@@ -1,5 +1,23 @@
 import { z } from "zod";
 import { fail, listResult } from "./result.js";
+/**
+ * The strategies `GET /api/v1/leaderboard` accepts (`STRATEGY_ENUM` in
+ * `backend/src/api_v1/handlers/leaderboard.rs`, the spec's enum, and the SDK's
+ * `LEADERBOARD_STRATEGIES`). Any other value is a 400 at the route, so the
+ * schema refuses it first (#16548).
+ */
+const LEADERBOARD_STRATEGIES = [
+    "accumulator",
+    "algo_trader",
+    "arbitrageur",
+    "directional",
+    "event_driven",
+    "market_maker",
+    "momentum",
+    "scalper",
+    "speculator",
+    "swing_trader",
+];
 export function registerGetLeaderboard(server, client) {
     server.registerTool("get_leaderboard", {
         title: "Get Trader Leaderboard",
@@ -9,7 +27,7 @@ Args:
   - limit (number, 1-100, default 20): Max results per page
   - cursor (string, optional): Pagination cursor from previous response
   - category (string, optional): Filter by category slug
-  - strategy (string, optional): Filter by strategy type
+  - strategy (string, optional): One of accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader
 
 Returns: Ranked list of traders with grade, score, P&L, volume, win rate, and strategy.`,
         inputSchema: {
@@ -19,7 +37,7 @@ Returns: Ranked list of traders with grade, score, P&L, volume, win rate, and st
                 .describe("Pagination cursor from previous response"),
             category: z.string().optional()
                 .describe("Filter by category slug"),
-            strategy: z.string().optional()
+            strategy: z.enum(LEADERBOARD_STRATEGIES).optional()
                 .describe("Filter by strategy type"),
         },
         annotations: {

package/dist/tools/get-leaderboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-leaderboard.js","sourceRoot":"","sources":["../../src/tools/get-leaderboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAiB;IACzE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;;;;;;;;wFAQqE;QAClF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;iBAChD,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC1B,QAAQ,CAAC,0CAA0C,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5B,QAAQ,CAAC,yBAAyB,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5B,QAAQ,CAAC,yBAAyB,CAAC;SACvC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;gBAC3D,KAAK;gBACL,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-leaderboard.js","sourceRoot":"","sources":["../../src/tools/get-leaderboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,sBAAsB,GAAG;IAC7B,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,UAAU;IACV,SAAS;IACT,YAAY;IACZ,cAAc;CACN,CAAC;AAEX,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAiB;IACzE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;;;;;;;;wFAQqE;QAClF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;iBAChD,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC1B,QAAQ,CAAC,0CAA0C,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5B,QAAQ,CAAC,yBAAyB,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;iBAChD,QAAQ,CAAC,yBAAyB,CAAC;SACvC;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE;gBAC3D,KAAK;gBACL,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-suspicious-trades.d.ts

@@ -0,0 +1,26 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ApiClient } from "../client.js";
+/** Shared by the canonical list tool and its deprecated alias. */
+export declare const suspiciousTradesInputSchema: {
+    readonly limit: z.ZodDefault<z.ZodNumber>;
+    readonly cursor: z.ZodOptional<z.ZodString>;
+    readonly min_suspicion: z.ZodDefault<z.ZodNumber>;
+    readonly severity: z.ZodOptional<z.ZodEnum<{
+        flag: "flag";
+        watch: "watch";
+    }>>;
+    readonly mode: z.ZodOptional<z.ZodEnum<{
+        live: "live";
+        stable: "stable";
+    }>>;
+};
+/** Shared by the canonical by-ID tool and its deprecated alias. */
+export declare const suspiciousTradeInputSchema: {
+    readonly id: z.ZodString;
+};
+export declare const SUSPICIOUS_TRADES_DESCRIPTION = "Stored trades whose recorded suspicion score meets the live flag threshold. Cursor-paginated by suspicion score (highest first). Use mode=stable when a walk must stay on one published scoring generation; restart when it returns cursor_expired.\n\nEach suspicious trade includes:\n- suspicion_score (60-100)\n- severity (currently flag)\n- Sub-scores: size and fresh_wallet when recorded; timing and edge are null\n- Evidence JSON with the scorer's stored signals\n\nArgs:\n  - limit (number, 1-100, default 20): Max results per page\n  - cursor (string, optional): Pagination cursor from previous response\n  - min_suspicion (number, 0-100, default 0): Minimum score; the live floor of 60 also applies\n  - severity (string, optional): \"flag\" selects live rows; \"watch\" returns none because no live watch policy exists\n  - mode (string, optional): \"live\" (default) uses fresh cached pages; \"stable\" pins the walk to one published scoring generation\n\nReturns: List of suspicious trades with trader, market, scores, and evidence.";
+export declare const SUSPICIOUS_TRADE_DESCRIPTION = "Read one suspicious trade by ID. Accepts the rf_ ID returned by list responses or the raw numeric whale_alerts.id.\n\nArgs:\n  - id (string, required): Suspicious trade ID such as rf_123 or 123\n\nReturns: One suspicious trade with trader, market, suspicion scores, and evidence.";
+export declare function registerGetSuspiciousTrades(server: McpServer, client: ApiClient): void;
+export declare function registerGetSuspiciousTrade(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=get-suspicious-trades.d.ts.map

package/dist/tools/get-suspicious-trades.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-suspicious-trades.d.ts","sourceRoot":"","sources":["../../src/tools/get-suspicious-trades.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAUzC,kEAAkE;AAClE,eAAO,MAAM,2BAA2B;aACtC,KAAK;aAEL,MAAM;aAEN,aAAa;aAEb,QAAQ;;;;aAER,IAAI;;;;CAEI,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,0BAA0B;aACrC,EAAE;CACM,CAAC;AAEX,eAAO,MAAM,6BAA6B,mhCAeoC,CAAC;AAE/E,eAAO,MAAM,4BAA4B,4RAK0C,CAAC;AAEpF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBtF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBrF"}

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

@@ -0,0 +1,91 @@
+// Canonical "suspicious trades" tools (#16301, epic #16300). The wording and
+// the argument list mirror `backend/src/mcp/tools/contract.rs`, so the remote
+// endpoint and this stdio server describe the same surface. The older
+// get_insider_radar / get_insider_radar_flag tools stay registered as
+// deprecated aliases on the deprecated /api/v1/insider-radar paths.
+import { z } from "zod";
+import { fail, listResult, ok, withMeta } from "./result.js";
+const readAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+/** Shared by the canonical list tool and its deprecated alias. */
+export const suspiciousTradesInputSchema = {
+    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_suspicion: z.number().min(0).max(100).default(0)
+        .describe("Minimum suspicion score (0-100); the live floor of 60 also applies"),
+    severity: z.enum(["flag", "watch"]).optional()
+        .describe('"flag" selects live rows; "watch" returns none because no live watch policy exists'),
+    mode: z.enum(["live", "stable"]).optional()
+        .describe('"live" (default) uses fresh cached pages; "stable" pins the walk to one published scoring generation'),
+};
+/** Shared by the canonical by-ID tool and its deprecated alias. */
+export const suspiciousTradeInputSchema = {
+    id: z.string().trim().min(1).describe("Suspicious trade ID such as rf_123 or 123"),
+};
+export const SUSPICIOUS_TRADES_DESCRIPTION = `Stored trades whose recorded suspicion score meets the live flag threshold. Cursor-paginated by suspicion score (highest first). Use mode=stable when a walk must stay on one published scoring generation; restart when it returns cursor_expired.
+
+Each suspicious trade includes:
+- suspicion_score (60-100)
+- severity (currently flag)
+- Sub-scores: size and fresh_wallet when recorded; timing and edge are null
+- Evidence JSON with the scorer's stored signals
+
+Args:
+  - limit (number, 1-100, default 20): Max results per page
+  - cursor (string, optional): Pagination cursor from previous response
+  - min_suspicion (number, 0-100, default 0): Minimum score; the live floor of 60 also applies
+  - severity (string, optional): "flag" selects live rows; "watch" returns none because no live watch policy exists
+  - mode (string, optional): "live" (default) uses fresh cached pages; "stable" pins the walk to one published scoring generation
+
+Returns: List of suspicious trades with trader, market, scores, and evidence.`;
+export const SUSPICIOUS_TRADE_DESCRIPTION = `Read one suspicious trade by ID. Accepts the rf_ ID returned by list responses or the raw numeric whale_alerts.id.
+
+Args:
+  - id (string, required): Suspicious trade ID such as rf_123 or 123
+
+Returns: One suspicious trade with trader, market, suspicion scores, and evidence.`;
+export function registerGetSuspiciousTrades(server, client) {
+    server.registerTool("get_suspicious_trades", {
+        title: "Get suspicious trades",
+        description: SUSPICIOUS_TRADES_DESCRIPTION,
+        inputSchema: suspiciousTradesInputSchema,
+        annotations: readAnnotations,
+    }, async ({ limit, cursor, min_suspicion, severity, mode }) => {
+        try {
+            const response = await client.request("/api/v1/suspicious-trades", {
+                limit,
+                cursor,
+                min_suspicion,
+                severity,
+                mode,
+            });
+            return ok(listResult(response));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+export function registerGetSuspiciousTrade(server, client) {
+    server.registerTool("get_suspicious_trade", {
+        title: "Get suspicious trade",
+        description: SUSPICIOUS_TRADE_DESCRIPTION,
+        inputSchema: suspiciousTradeInputSchema,
+        annotations: readAnnotations,
+    }, async ({ id }) => {
+        try {
+            const response = await client.request(`/api/v1/suspicious-trades/${encodeURIComponent(id)}`);
+            return ok(withMeta(response.data, response.meta));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+//# sourceMappingURL=get-suspicious-trades.js.map

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

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

package/dist/tools/get-whale-trades.d.ts

@@ -1,4 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ApiClient } from "../client.js";
+export declare function registerGetLargeTrades(server: McpServer, client: ApiClient): void;
+/** Deprecated spelling of get_large_trades (#16304). */
 export declare function registerGetWhaleTrades(server: McpServer, client: ApiClient): void;
 //# sourceMappingURL=get-whale-trades.d.ts.map

package/dist/tools/get-whale-trades.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-whale-trades.d.ts","sourceRoot":"","sources":["../../src/tools/get-whale-trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA0DjF"}
+{"version":3,"file":"get-whale-trades.d.ts","sourceRoot":"","sources":["../../src/tools/get-whale-trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAmEzC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAEjF;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAOjF"}

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

@@ -1,9 +1,9 @@
 import { z } from "zod";
 import { fail, listResult } from "./result.js";
-export function registerGetWhaleTrades(server, client) {
-    server.registerTool("get_whale_trades", {
-        title: "List Whale Trades",
-        description: `Get recent large trades from graded prediction market traders. Each trade includes signal scoring, trader grade, and market context. Cursor-paginated, newest first.
+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 signal scoring, trader grade, and market context. Cursor-paginated, newest first.
 
 Args:
   - limit (number, 1-100, default 20): Max results per page
@@ -13,7 +13,7 @@ Args:
   - 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
 
-Returns: List of whale trades with trader info, market context, size, side, price, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
+Returns: List of large trades with trader info, market context, size, side, price, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
         inputSchema: {
             limit: z.number().int().min(1).max(100).default(20)
                 .describe("Max results (1-100, default 20)"),
@@ -36,7 +36,7 @@ Returns: List of whale trades with trader info, market context, size, side, pric
         },
     }, async ({ limit, cursor, min_size, category, min_grade, suspicious_only }) => {
         try {
-            const response = await client.request("/api/v1/whale-trades", {
+            const response = await client.request(tool.path, {
                 limit,
                 cursor,
                 min_size,
@@ -54,4 +54,16 @@ Returns: List of whale trades with trader info, market context, size, side, pric
         }
     });
 }
+export function registerGetLargeTrades(server, client) {
+    registerTradeList(server, client, { name: "get_large_trades", title: "List large trades", path: "/api/v1/large-trades" });
+}
+/** Deprecated spelling of get_large_trades (#16304). */
+export function registerGetWhaleTrades(server, client) {
+    registerTradeList(server, client, {
+        name: "get_whale_trades",
+        title: "List Whale Trades",
+        path: "/api/v1/whale-trades",
+        deprecatedOf: "get_large_trades",
+    });
+}
 //# 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":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAiB;IACzE,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE;;;;;;;;;;2YAUwX;QACrY,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;iBAChD,QAAQ,CAAC,iCAAiC,CAAC;YAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC1B,QAAQ,CAAC,0CAA0C,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;iBACtC,QAAQ,CAAC,0CAA0C,CAAC;YACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBAC5B,QAAQ,CAAC,8CAA8C,CAAC;YAC3D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;iBACzD,QAAQ,CAAC,sBAAsB,CAAC;YACnC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;iBACpC,QAAQ,CAAC,2CAA2C,CAAC;SACzD;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE;QAC1E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,sBAAsB,EAAE;gBAC5D,KAAK;gBACL,MAAM;gBACN,QAAQ;gBACR,QAAQ;gBACR,SAAS;gBACT,eAAe;aAChB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-whale-trades.js","sourceRoot":"","sources":["../../src/tools/get-whale-trades.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ApiClient } from "../client.js";
 export declare function registerBatchGetTraders(server: McpServer, client: ApiClient): void;
+export declare function registerGetLargeTradesHistory(server: McpServer, client: ApiClient): void;
+/** Deprecated spelling of get_large_trades_history (#16304). */
 export declare function registerGetWhaleTradesHistory(server: McpServer, client: ApiClient): void;
+export declare function registerGetLargeTrade(server: McpServer, client: ApiClient): void;
+/** Deprecated spelling of get_large_trade (#16304). */
 export declare function registerGetWhaleTrade(server: McpServer, client: ApiClient): void;
 export declare function registerBatchGetMarketIntel(server: McpServer, client: ApiClient): void;
 export declare function registerGetSmartMoneyFlows(server: McpServer, client: ApiClient): void;
@@ -19,6 +23,10 @@ export declare function registerGetTraderExportSnapshot(server: McpServer, clien
 export declare function registerGetPlatforms(server: McpServer, client: ApiClient): void;
 export declare function registerSearchContent(server: McpServer, client: ApiClient): void;
 export declare function registerGetReport(server: McpServer, client: ApiClient): void;
+export declare function registerGetPreGameSideObservations(server: McpServer, client: ApiClient): void;
+/** Deprecated spelling of get_pre_game_side_observations (#16310). */
 export declare function registerGetSportsEdgeObservations(server: McpServer, client: ApiClient): void;
+export declare function registerGetPreGameSides(server: McpServer, client: ApiClient): void;
+/** Deprecated spelling of get_pre_game_sides (#16310). */
 export declare function registerGetSportsEdgeSignals(server: McpServer, client: ApiClient): void;
 //# sourceMappingURL=read-parity.d.ts.map

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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAWzC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BlF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA4CxF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BhF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BtF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAyCrF;AAKD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAyCrF;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,CAkC1F;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2BtF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6CtF;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,CA+B1F;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,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,CA2BhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B5E;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAoC5F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BvF"}
+{"version":3,"file":"read-parity.d.ts","sourceRoot":"","sources":["../../src/tools/read-parity.ts"],"names":[],"mappings":"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"}

package/dist/tools/read-parity.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { fail, listResult, ok, withMeta } from "./result.js";
+import { SUSPICIOUS_TRADE_DESCRIPTION, suspiciousTradeInputSchema, } from "./get-suspicious-trades.js";
 import { MAX_BATCH_ITEMS } from "../constants.js";
 const readAnnotations = {
     readOnlyHint: true,
@@ -34,10 +35,10 @@ Returns: Ordered batch trader results with per-item success or error details.`,
         }
     });
 }
-export function registerGetWhaleTradesHistory(server, client) {
-    server.registerTool("get_whale_trades_history", {
-        title: "Replay Historical Whale Trades",
-        description: `Replay historical whale trades from local whale_alerts rows. Supports cursor pagination plus condition, trader, category, grade, platform, and RFC3339 from/to filters.
+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, and RFC3339 from/to filters.
 
 Args:
   - limit (number, 1-100, default 20)
@@ -51,7 +52,7 @@ Args:
   - platform (string, optional): polymarket or all
   - from/to (string, optional): RFC3339 traded_at bounds
 
-Returns: Historical whale trades with replay metadata, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
+Returns: Historical large trades with replay metadata, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
         inputSchema: {
             limit: z.number().int().min(1).max(100).default(20),
             cursor: z.string().optional(),
@@ -68,7 +69,7 @@ Returns: Historical whale trades with replay metadata, current signal_score and
         annotations: readAnnotations,
     }, async (args) => {
         try {
-            const response = await client.request("/api/v1/whale-trades/history", args);
+            const response = await client.request(tool.path, args);
             return ok(listResult(response));
         }
         catch (error) {
@@ -76,22 +77,34 @@ Returns: Historical whale trades with replay metadata, current signal_score and
         }
     });
 }
-export function registerGetWhaleTrade(server, client) {
-    server.registerTool("get_whale_trade", {
-        title: "Get Whale Trade",
-        description: `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.
+export function registerGetLargeTradesHistory(server, client) {
+    registerTradeHistory(server, client, { name: "get_large_trades_history", title: "Replay historical large trades", path: "/api/v1/large-trades/history" });
+}
+/** Deprecated spelling of get_large_trades_history (#16304). */
+export function registerGetWhaleTradesHistory(server, client) {
+    registerTradeHistory(server, client, {
+        name: "get_whale_trades_history",
+        title: "Replay Historical Whale Trades",
+        path: "/api/v1/whale-trades/history",
+        deprecatedOf: "get_large_trades_history",
+    });
+}
+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): Whale trade ID such as wt_123 or 123
+  - id (string, required): Large trade ID such as wt_123 or 123
 
-Returns: One whale trade with trader info, market context, size, side, price, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
+Returns: One large trade with trader info, market context, size, side, price, current signal_score and trader grade, point-in-time recorded_signal_score (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.`,
         inputSchema: {
-            id: z.string().trim().min(1).describe("Whale trade ID such as wt_123 or 123"),
+            id: z.string().trim().min(1).describe("Large trade ID such as wt_123 or 123"),
         },
         annotations: readAnnotations,
     }, async ({ id }) => {
         try {
-            const response = await client.request(`/api/v1/whale-trades/${encodeURIComponent(id)}`);
+            const response = await client.request(`${tool.path}/${encodeURIComponent(id)}`);
             return ok(withMeta(response.data, response.meta));
         }
         catch (error) {
@@ -99,6 +112,18 @@ Returns: One whale 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" });
+}
+/** Deprecated spelling of get_large_trade (#16304). */
+export function registerGetWhaleTrade(server, client) {
+    registerTradeDetail(server, client, {
+        name: "get_whale_trade",
+        title: "Get Whale Trade",
+        path: "/api/v1/whale-trades",
+        deprecatedOf: "get_large_trade",
+    });
+}
 export function registerBatchGetMarketIntel(server, client) {
     server.registerTool("batch_get_market_intel", {
         title: "Batch Market Intelligence",
@@ -260,15 +285,10 @@ Returns: List of position timeline events with pagination metadata.`,
 export function registerGetInsiderRadarFlag(server, client) {
     server.registerTool("get_insider_radar_flag", {
         title: "Get Insider Radar Flag",
-        description: `Read one insider-radar flag by ID. Accepts either the rf_ ID returned by insider-radar list responses or the raw numeric radar_flags.id.
-
-Args:
-  - id (string, required): Radar flag ID such as rf_123 or 123
-
-Returns: One radar flag with trader, market, suspicion scores, and evidence.`,
-        inputSchema: {
-            id: z.string().trim().min(1).describe("Radar flag ID such as rf_123 or 123"),
-        },
+        // Deprecated alias of get_suspicious_trade (#16301): same schema, the
+        // deprecated path, kept live for existing clients.
+        description: `Deprecated alias of get_suspicious_trade (#16301), kept live; it calls the deprecated /api/v1/insider-radar/{id} path. ${SUSPICIOUS_TRADE_DESCRIPTION}`,
+        inputSchema: suspiciousTradeInputSchema,
         annotations: readAnnotations,
     }, async ({ id }) => {
         try {
@@ -467,7 +487,7 @@ Returns: Trader export snapshot metadata.`,
 export function registerGetPlatforms(server, client) {
     server.registerTool("get_platforms", {
         title: "Get Platform Capability Matrix",
-        description: `Read the provider capability matrix declaring which V1 intelligence surfaces are supported, partial, or unsupported per platform. Polymarket reports a status (supported, partial, or unsupported) for grade, pnl, strategy, timeline, whale_signal, insider_radar, and market_snapshot. Use this before choosing trader, market, whale, or radar routes to inspect the supported Polymarket surfaces.
+        description: `Read the provider capability matrix declaring which V1 intelligence surfaces are supported, partial, or unsupported per platform. Polymarket reports a status (supported, partial, or unsupported) for grade, pnl, strategy, timeline, whale_signal, 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.
 
 Args: none
 
@@ -538,10 +558,10 @@ Returns: Report snapshot metadata and entries (source_range, snapshot.status, co
         }
     });
 }
-export function registerGetSportsEdgeObservations(server, client) {
-    server.registerTool("get_sports_edge_observations", {
-        title: "Get Sports Edge Observations",
-        description: "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, in_play, or emerging_pile. Every row carries observation_only=true. 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_sports_edge_signals. A refreshed snapshot rejects an old cursor with cursor_expired; request the first page again.",
+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.`,
         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"),
@@ -551,7 +571,7 @@ export function registerGetSportsEdgeObservations(server, client) {
         annotations: readAnnotations,
     }, async (args) => {
         try {
-            const response = await client.request("/api/v1/sports-edge-observations", args);
+            const response = await client.request(tool.path, args);
             return ok({
                 data: response.data,
                 has_more: response.has_more,
@@ -571,26 +591,46 @@ export function registerGetSportsEdgeObservations(server, client) {
         }
     });
 }
-export function registerGetSportsEdgeSignals(server, client) {
-    server.registerTool("get_sports_edge_signals", {
-        title: "Get Ranked Sports Edge Signals",
-        description: "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 market identity, backed outcome and token ID, kickoff, grade distribution, conviction, snapshot time, and availability. Analytics, not an order instruction. Cached kickoffs may have passed; inspect timestamps before acting.",
+export function registerGetPreGameSideObservations(server, client) {
+    registerSideObservations(server, client, {
+        name: "get_pre_game_side_observations",
+        title: "List pre-game side observations",
+        path: "/api/v1/sports/pre-game-side-observations",
+    });
+}
+/** Deprecated spelling of get_pre_game_side_observations (#16310). */
+export function registerGetSportsEdgeObservations(server, client) {
+    registerSideObservations(server, client, {
+        name: "get_sports_edge_observations",
+        title: "Get Sports Edge Observations",
+        path: "/api/v1/sports-edge-observations",
+        deprecatedOf: "get_pre_game_side_observations",
+    });
+}
+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.`,
         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 signal snapshot"),
+            cursor: z.string().optional().describe("Opaque cursor pinned to a ranked snapshot"),
             horizon_hours: z.number().int().min(1).max(48).default(12),
             min_grade: z.enum(["S", "A", "B"]).default("B"),
         },
         annotations: readAnnotations,
     }, async (args) => {
         try {
-            const response = await client.request("/api/v1/sports-edge-signals", args);
+            const response = await client.request(tool.path, args);
+            // `meta` verbatim, like every other list tool (#16548): its
+            // directional_source "degraded" says the ranking fell back to the raw
+            // backing score, and request_id correlates the read.
             return ok({
                 data: response.data,
                 has_more: response.has_more,
                 next_cursor: response.next_cursor,
                 ...(response.total === undefined ? {} : { total: response.total }),
+                ...(response.meta === undefined ? {} : { meta: response.meta }),
             });
         }
         catch (error) {
@@ -598,4 +638,20 @@ export function registerGetSportsEdgeSignals(server, client) {
         }
     });
 }
+export function registerGetPreGameSides(server, client) {
+    registerSides(server, client, {
+        name: "get_pre_game_sides",
+        title: "List pre-game sides",
+        path: "/api/v1/sports/pre-game-sides",
+    });
+}
+/** Deprecated spelling of get_pre_game_sides (#16310). */
+export function registerGetSportsEdgeSignals(server, client) {
+    registerSides(server, client, {
+        name: "get_sports_edge_signals",
+        title: "Get Ranked Sports Edge Signals",
+        path: "/api/v1/sports-edge-signals",
+        deprecatedOf: "get_pre_game_sides",
+    });
+}
 //# sourceMappingURL=read-parity.js.map