odds-api-mcp-server 1.1.1 → 1.2.0

package/dist/index.js

@@ -319,6 +319,62 @@ const tools = [
             return jsonResponse(await apiRequest("/odds/updated", { since, bookmaker, sport }));
         },
     },
+    // ── Dropping Odds ───────────────────────────────────────────────
+    {
+        name: "get_dropping_odds",
+        description: "Get odds that have dropped the most from opening, based on sharp bookmaker data. Useful for tracking where sharp money is moving. Updated every ~10 seconds. Only available on paid plans.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sport: {
+                    type: "string",
+                    description: "Sport slug to filter by (e.g., 'football', 'basketball')",
+                },
+                league: {
+                    type: "string",
+                    description: "League slug to filter by (e.g., 'england-premier-league'). Requires sport to also be set.",
+                },
+                market: {
+                    type: "string",
+                    description: "Market type to filter by: 'ML', 'Spread', or 'Totals'",
+                },
+                timeWindow: {
+                    type: "string",
+                    description: "Time window for drop calculation and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+                },
+                minDrop: {
+                    type: "number",
+                    description: "Minimum drop percentage threshold (default: 0)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Results per page, 1-200 (default: 50)",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number, 1-indexed (default: 1)",
+                },
+                includeEventDetails: {
+                    type: "boolean",
+                    description: "Include expanded event details (home, away, date, sport, league) in response",
+                },
+            },
+            required: [],
+        },
+        async handler(args) {
+            const { sport, league, market, timeWindow, minDrop, limit, page, includeEventDetails } = args;
+            return jsonResponse(await apiRequest("/dropping-odds", {
+                sport,
+                league,
+                market,
+                timeWindow,
+                minDrop,
+                limit,
+                page,
+                includeEventDetails: includeEventDetails || undefined,
+            }));
+        },
+    },
     // ── Historical ──────────────────────────────────────────────────
     {
         name: "get_historical_events",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odds-api-mcp-server",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "MCP server for Odds-API.io - Access sports betting odds data from AI tools like Claude, Cursor, and VS Code",
   "type": "module",
   "main": "dist/index.js",

package/src/index.test.ts

@@ -63,6 +63,7 @@ describe("Tool Registry", () => {
     "get_multi_odds",
     "get_odds_movements",
     "get_updated_odds",
+    "get_dropping_odds",
     "get_historical_events",
     "get_historical_odds",
     "get_value_bets",
@@ -72,8 +73,8 @@ describe("Tool Registry", () => {
     "get_documentation",
   ];
 
-  it("has all 21 tools registered", () => {
-    expect(tools).toHaveLength(21);
+  it("has all 22 tools registered", () => {
+    expect(tools).toHaveLength(22);
   });
 
   it("has no duplicate tool names", () => {
@@ -134,6 +135,7 @@ describe("Tool Schemas - Required Parameters", () => {
     ["get_multi_odds", ["eventIds", "bookmakers"]],
     ["get_odds_movements", ["eventId", "bookmaker", "market"]],
     ["get_updated_odds", ["since", "bookmaker", "sport"]],
+    ["get_dropping_odds", []],
     ["get_historical_events", ["sport", "league", "from", "to"]],
     ["get_historical_odds", ["eventId", "bookmakers"]],
     ["get_value_bets", ["bookmaker"]],
@@ -459,6 +461,58 @@ describe("Tool Handlers", () => {
     expect(calledUrl.searchParams.get("since")).toBe(String(since));
   });
 
+  it("get_dropping_odds passes all optional params", async () => {
+    const fetchMock = mockFetchJson([]);
+    globalThis.fetch = fetchMock;
+
+    await toolMap.get("get_dropping_odds")!.handler({
+      sport: "football",
+      league: "england-premier-league",
+      market: "ML",
+      timeWindow: "12h",
+      minDrop: 5,
+      limit: 100,
+      page: 2,
+      includeEventDetails: true,
+    });
+
+    const calledUrl = new URL(fetchMock.mock.calls[0][0]);
+    expect(calledUrl.pathname).toBe("/v3/dropping-odds");
+    expect(calledUrl.searchParams.get("sport")).toBe("football");
+    expect(calledUrl.searchParams.get("league")).toBe("england-premier-league");
+    expect(calledUrl.searchParams.get("market")).toBe("ML");
+    expect(calledUrl.searchParams.get("timeWindow")).toBe("12h");
+    expect(calledUrl.searchParams.get("minDrop")).toBe("5");
+    expect(calledUrl.searchParams.get("limit")).toBe("100");
+    expect(calledUrl.searchParams.get("page")).toBe("2");
+    expect(calledUrl.searchParams.get("includeEventDetails")).toBe("true");
+  });
+
+  it("get_dropping_odds sends includeEventDetails only when true", async () => {
+    const fetchMock = mockFetchJson([]);
+    globalThis.fetch = fetchMock;
+
+    await toolMap.get("get_dropping_odds")!.handler({ includeEventDetails: false });
+    const url = new URL(fetchMock.mock.calls[0][0]);
+    expect(url.searchParams.has("includeEventDetails")).toBe(false);
+
+    await toolMap.get("get_dropping_odds")!.handler({});
+    const url2 = new URL(fetchMock.mock.calls[1][0]);
+    expect(url2.searchParams.has("includeEventDetails")).toBe(false);
+  });
+
+  it("get_dropping_odds works with no params", async () => {
+    const fetchMock = mockFetchJson([]);
+    globalThis.fetch = fetchMock;
+
+    await toolMap.get("get_dropping_odds")!.handler({});
+
+    const calledUrl = new URL(fetchMock.mock.calls[0][0]);
+    expect(calledUrl.pathname).toBe("/v3/dropping-odds");
+    expect(calledUrl.searchParams.has("sport")).toBe(false);
+    expect(calledUrl.searchParams.has("league")).toBe(false);
+  });
+
   it("get_historical_events passes all required params", async () => {
     const fetchMock = mockFetchJson([]);
     globalThis.fetch = fetchMock;

package/src/index.ts

@@ -408,6 +408,77 @@ const tools: ToolDefinition[] = [
     },
   },
 
+  // ── Dropping Odds ───────────────────────────────────────────────
+
+  {
+    name: "get_dropping_odds",
+    description:
+      "Get odds that have dropped the most from opening, based on sharp bookmaker data. Useful for tracking where sharp money is moving. Updated every ~10 seconds. Only available on paid plans.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sport: {
+          type: "string",
+          description: "Sport slug to filter by (e.g., 'football', 'basketball')",
+        },
+        league: {
+          type: "string",
+          description: "League slug to filter by (e.g., 'england-premier-league'). Requires sport to also be set.",
+        },
+        market: {
+          type: "string",
+          description: "Market type to filter by: 'ML', 'Spread', or 'Totals'",
+        },
+        timeWindow: {
+          type: "string",
+          description: "Time window for drop calculation and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+        },
+        minDrop: {
+          type: "number",
+          description: "Minimum drop percentage threshold (default: 0)",
+        },
+        limit: {
+          type: "number",
+          description: "Results per page, 1-200 (default: 50)",
+        },
+        page: {
+          type: "number",
+          description: "Page number, 1-indexed (default: 1)",
+        },
+        includeEventDetails: {
+          type: "boolean",
+          description: "Include expanded event details (home, away, date, sport, league) in response",
+        },
+      },
+      required: [],
+    },
+    async handler(args) {
+      const { sport, league, market, timeWindow, minDrop, limit, page, includeEventDetails } =
+        args as {
+          sport?: string;
+          league?: string;
+          market?: string;
+          timeWindow?: string;
+          minDrop?: number;
+          limit?: number;
+          page?: number;
+          includeEventDetails?: boolean;
+        };
+      return jsonResponse(
+        await apiRequest("/dropping-odds", {
+          sport,
+          league,
+          market,
+          timeWindow,
+          minDrop,
+          limit,
+          page,
+          includeEventDetails: includeEventDetails || undefined,
+        }),
+      );
+    },
+  },
+
   // ── Historical ──────────────────────────────────────────────────
 
   {