@0xinsider/mcp 3.6.2 → 3.9.0

package/dist/tools/sport-leaderboards.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { ApiClient } from "../client.js";
+export declare function registerGetLeaderboardLeagues(server: McpServer, client: ApiClient): void;
+export declare function registerGetSportLeaderboard(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=sport-leaderboards.d.ts.map

package/dist/tools/sport-leaderboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sport-leaderboards.d.ts","sourceRoot":"","sources":["../../src/tools/sport-leaderboards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAczC,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBxF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCtF"}

package/dist/tools/sport-leaderboards.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { fail, ok, withMeta } from "./result.js";
+// Sport and league boards over stdio (#32157). They mirror the remote entries
+// in backend/src/mcp/tools/contract.rs; scripts/mcp-catalog-parity.mjs proves
+// the two tool lists match, and the description text is kept in step by hand.
+const readAnnotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: false,
+};
+export function registerGetLeaderboardLeagues(server, client) {
+    server.registerTool("get_leaderboard_leagues", {
+        title: "List Leaderboard Leagues",
+        description: `List every league that has its own skill leaderboard, grouped by sport, most ranked wallets first. Each row's sport and slug are the sport and league arguments of get_sport_leaderboard. A league is listed once its edge sort ranks at least min_ranked wallets.
+
+A ranking being rebuilt returns read_model_warming with a retry time.
+
+Args: none
+
+Returns: min_ranked, min_resolved, refreshed_at and leagues[] (category, sport, slug, name, ranked_traders, total_traders).`,
+        inputSchema: z.object({}),
+        annotations: readAnnotations,
+    }, async (_args, ctx) => {
+        try {
+            const response = await client.request("/api/v1/leaderboard/leagues", undefined, undefined, { signal: ctx.mcpReq.signal });
+            return ok(withMeta(response.data, response.meta));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+export function registerGetSportLeaderboard(server, client) {
+    server.registerTool("get_sport_leaderboard", {
+        title: "Get Sport Leaderboard",
+        description: `Get one sport's skill leaderboard, or with league one league's: the board the site's sport pages show. Wallets need min_resolved resolved markets in the sport or league. sort edge (the default) ranks edge_skill, the edge over the price paid pulled toward the board's edge_average by how much of the record is noise; a wallet without a ranked edge sorts after the ranked ones. sort pnl ranks realized P&L and win_rate the Wilson lower bound of the win rate. Boards are ranked to 100 wallets.
+
+A sport outside sports and esports is not_found on sport; a league the sport has no board for is not_found on league (get_leaderboard_leagues lists them).
+
+Args:
+  - sport (string, required): Sport slug, e.g. soccer, basketball, football, esports; an alias such as nba reads its sport's board
+  - league (string, optional): League slug of the sport, e.g. premier-league
+  - sort (string, optional): edge (default), pnl or win_rate
+  - limit (number, 1-100, default 20): Rows from the top of the board
+
+Returns: sport, category, league, sort, min_resolved, limit, total_traders, edge_average, volume_scope, as_of and rows[] (rank, id, address, username, platform, grade, n_resolved, wins, losses, win_rate, win_rate_wilson_lb, price_edge, edge_hold, edge_skill, pnl, volume, cost, roi, last_category_trade_at).`,
+        inputSchema: z.object({
+            sport: z.string().trim().min(1).describe("Sport slug, e.g. soccer, basketball, football or esports; an alias such as nba reads its sport's board"),
+            league: z.string().trim().min(1).optional().describe("League slug of the sport from get_leaderboard_leagues, e.g. premier-league; omit for the sport board"),
+            sort: z.enum(["edge", "pnl", "win_rate"]).default("edge").describe("Ranking axis: edge over the price paid (default), realized P&L, or win rate"),
+            limit: z.number().int().min(1).max(100).default(20).describe("Rows from the top of the board (1-100, default 20)"),
+        }),
+        annotations: readAnnotations,
+    }, async ({ sport, league, sort, limit }, ctx) => {
+        try {
+            const response = await client.request(`/api/v1/leaderboard/sports/${encodeURIComponent(sport)}`, { league, sort, limit }, undefined, { signal: ctx.mcpReq.signal });
+            return ok(withMeta(response.data, response.meta));
+        }
+        catch (error) {
+            return fail(error);
+        }
+    });
+}
+//# sourceMappingURL=sport-leaderboards.js.map

package/dist/tools/sport-leaderboards.js.map

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

package/dist/tools/trader-reads.js

@@ -22,7 +22,7 @@ function traderPath(address, suffix) {
 export function registerGetTraderContext(server, client) {
     server.registerTool("get_trader_context", {
         title: "Get trader context",
-        description: `One structured context object for a trader: the full get_trader profile plus position_summary (sync coverage and realized and unrealized P&L rollups with an as_of open-position clock), data_as_of and a freshness_note on what the point-in-time snapshot covers. position_summary is absent when the trader is not tracked locally or native net economics is unavailable. A wallet address with no trader yet returns sync_status "unknown" on the nested trader; a username or trader id that matches no trader is a not_found error.
+        description: `One structured context object for a trader: the full get_trader profile plus position_summary (sync coverage and realized and unrealized P&L rollups with an as_of open-position clock), data_as_of and a freshness_note on what the point-in-time snapshot covers. position_summary is absent when the trader is not tracked locally or native net economics is unavailable. Its open-position figures (markets_open, unrealized_mtm, cost_basis_locked) cover the wallet's sports and esports markets, each judged when read; markets_synced, markets_resolved and the resolved win figures count every stored market, which can include markets of other categories, and sync_coverage adds markets_pruned and markets_unstored, its deleted and its unstored markets of other categories, and markets_combo, its combo markets, to markets_synced; markets_total, total_realized_pnl and synced_realized_pnl cover every Polymarket market of the wallet. A wallet address with no trader yet returns sync_status "unknown" on the nested trader; a username or trader id that matches no trader is a not_found error.
 
 Args:
   - address (string, required): Wallet address (0x...), username, or trd_-prefixed trader id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xinsider/mcp",
-  "version": "3.6.2",
+  "version": "3.9.0",
   "mcpName": "io.github.0xinsider/mcp",
   "description": "Official 0xinsider CLI and MCP server: Polymarket analytics & infrastructure for sports and esports markets",
   "type": "module",
@@ -58,16 +58,16 @@
     "README.md"
   ],
   "dependencies": {
-    "@modelcontextprotocol/server": "^2.3.1",
-    "zod": "^4.6.5"
+    "@modelcontextprotocol/server": "^2.4.0",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
     "@types/node": "^22.20.5",
     "semver": "^7.8.5",
     "tsx": "^4.23.15",
     "typescript": "^7.0.2",
-    "oxlint": "1.85.0",
-    "oxlint-tsgolint": "7.0.2002"
+    "oxlint": "1.89.0",
+    "oxlint-tsgolint": "7.0.2005"
   },
   "imports": {
     "#sdk": "./dist/sdk/index.js"