odds-api-mcp-server 1.2.1 → 1.3.0

package/.mcpbignore

@@ -0,0 +1,64 @@
+# Source files (dist/ has the compiled output)
+src/
+tsconfig.json
+*.ts
+!dist/**
+
+# Dev dependencies & test files
+node_modules/vitest/
+node_modules/@vitest/
+node_modules/typescript/
+node_modules/ts-node/
+node_modules/vite/
+node_modules/rolldown/
+node_modules/@rolldown/
+node_modules/lightningcss/
+node_modules/lightningcss-*/
+node_modules/fsevents/
+node_modules/chai/
+node_modules/tinybench/
+node_modules/tinyexec/
+node_modules/tinyrainbow/
+node_modules/tinyglobby/
+node_modules/picomatch/
+node_modules/picocolors/
+node_modules/postcss/
+node_modules/source-map-js/
+node_modules/magic-string/
+node_modules/expect-type/
+node_modules/stackback/
+node_modules/siginfo/
+node_modules/why-is-node-running/
+node_modules/diff/
+node_modules/fdir/
+node_modules/assertion-error/
+node_modules/@tsconfig/
+node_modules/@types/chai/
+node_modules/@types/deep-eql/
+node_modules/@types/estree/
+node_modules/@cspotcode/
+node_modules/@jridgewell/
+node_modules/@oxc-project/
+node_modules/@standard-schema/
+node_modules/v8-compile-cache-lib/
+node_modules/create-require/
+node_modules/make-error/
+node_modules/yn/
+node_modules/acorn/
+node_modules/acorn-walk/
+node_modules/arg/
+node_modules/convert-source-map/
+node_modules/es-module-lexer/
+node_modules/estree-walker/
+node_modules/nanoid/
+node_modules/obug/
+node_modules/pathe/
+node_modules/std-env/
+node_modules/detect-libc/
+
+# Git, lockfiles, misc
+.git/
+.gitignore
+package-lock.json
+node_modules/.package-lock.json
+*.mcpb

package/README.md

@@ -4,12 +4,16 @@ Model Context Protocol (MCP) server for [Odds-API.io](https://odds-api.io) - pro
 
 ## Features
 
-- **21 API tools** covering the full Odds-API.io v3 surface: sports, events, odds, historical data, value bets, arbitrage, and more
+- **22 API tools** covering the full Odds-API.io v3 surface: sports, events, odds, historical data, value bets, arbitrage, dropping odds, and more
 - **Documentation resources** for AI context
 - **Real-time data** from 265+ bookmakers across 34 sports
 
 ## Quick Start
 
+### One-Click Install (Claude Desktop)
+
+Download the latest `.mcpb` file from [Releases](https://github.com/odds-api-io/odds-api-mcp-server/releases/latest) and open it. Claude Desktop will prompt you for your API key.
+
 ### Claude Code CLI
 
 ```bash
@@ -133,6 +137,7 @@ Then use `odds-api-mcp` as the command instead of `npx -y odds-api-mcp-server`.
 |------|-------------|
 | `get_value_bets` | Get positive EV opportunities for a bookmaker |
 | `get_arbitrage_bets` | Get arbitrage opportunities with optimal stakes |
+| `get_dropping_odds` | Track sharp bookmaker line movements by sport, league, market, and time window |
 
 ### Participants
 
@@ -165,6 +170,8 @@ Once configured, ask your AI assistant things like:
 - "Are there any arbitrage opportunities between Bet365 and Unibet?"
 - "Show me how the odds moved for event 12345 on the spread market"
 - "Get historical results for La Liga in January 2026"
+- "Show me the biggest dropping odds in football right now"
+- "What Premier League odds have dropped the most in the last 12 hours?"
 
 ## Development
 
@@ -186,5 +193,3 @@ MIT
 - [Documentation](https://docs.odds-api.io) - API docs
 - [API Reference](https://api.odds-api.io/v3/docs/index.html) - Swagger/OpenAPI
 - [npm](https://www.npmjs.com/package/odds-api-mcp-server) - Package registry
-ndex.html) - Swagger/OpenAPI
-- [npm](https://www.npmjs.com/package/odds-api-mcp-server) - Package registry

package/dist/index.js

@@ -322,7 +322,7 @@ const tools = [
     // ── 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.",
+        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. Response includes drop percentages for multiple time windows (sinceOpening, 12h, 24h, 48h).",
         inputSchema: {
             type: "object",
             properties: {
@@ -336,11 +336,15 @@ const tools = [
                 },
                 market: {
                     type: "string",
-                    description: "Market type to filter by: 'ML', 'Spread', or 'Totals'",
+                    description: "Market name to filter by (case-insensitive). Supported: ML, Spread, Totals, Spread HT, Totals HT, Totals 1Q, Spread 1Q, Team Total Home, Team Total Away, Corners Spread, Corners Totals, Corners Spread HT, Corners Totals HT, Bookings Spread, Bookings Totals, Player Props",
                 },
                 timeWindow: {
                     type: "string",
-                    description: "Time window for drop calculation and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+                    description: "Time window for drop filtering and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+                },
+                sort: {
+                    type: "string",
+                    description: "Sort order: 'drop' (highest drop %), 'recent' (latest movement), 'kickoff' (soonest event). Default: 'drop'",
                 },
                 minDrop: {
                     type: "number",
@@ -362,12 +366,13 @@ const tools = [
             required: [],
         },
         async handler(args) {
-            const { sport, league, market, timeWindow, minDrop, limit, page, includeEventDetails } = args;
+            const { sport, league, market, timeWindow, sort, minDrop, limit, page, includeEventDetails } = args;
             return jsonResponse(await apiRequest("/dropping-odds", {
                 sport,
                 league,
                 market,
                 timeWindow,
+                sort,
                 minDrop,
                 limit,
                 page,
@@ -539,7 +544,7 @@ const tools = [
 ];
 // ── Server Setup ─────────────────────────────────────────────────────────────
 const toolMap = new Map(tools.map((tool) => [tool.name, tool]));
-const server = new Server({ name: "odds-api-mcp", version: "1.1.1" }, { capabilities: { tools: {}, resources: {} } });
+const server = new Server({ name: "odds-api-mcp", version: "1.3.0" }, { capabilities: { tools: {}, resources: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: tools.map(({ name, description, inputSchema }) => ({
         name,

package/manifest.json

@@ -0,0 +1,68 @@
+{
+  "manifest_version": "0.3",
+  "name": "odds-api",
+  "display_name": "Odds-API.io",
+  "version": "1.2.2",
+  "description": "Real-time sports betting odds from 250+ bookmakers. Fetch odds, find value bets, spot arbitrage opportunities, and track dropping odds across 20+ sports.",
+  "long_description": "Connect Claude to the Odds-API.io platform for real-time sports betting data.\n\nFetch live and pre-match odds from 250+ bookmakers across football, basketball, tennis, baseball, ice hockey, and 15+ more sports. Compare odds, find value bets backed by sharp bookmaker consensus, discover arbitrage opportunities, and track dropping odds to see where the smart money is moving.\n\nIncludes tools for events, odds, historical data, value bets, arbitrage detection, and dropping odds.\n\nRequires an API key from odds-api.io (free tier available).",
+  "author": {
+    "name": "Odds-API.io",
+    "email": "hello@odds-api.io",
+    "url": "https://odds-api.io"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/odds-api-io/odds-api-mcp-server.git"
+  },
+  "homepage": "https://odds-api.io",
+  "documentation": "https://docs.odds-api.io",
+  "support": "https://github.com/odds-api-io/odds-api-mcp-server/issues",
+  "license": "MIT",
+  "keywords": ["sports", "betting", "odds", "football", "basketball", "arbitrage", "value-bets", "bookmakers"],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"],
+      "env": {
+        "ODDS_API_KEY": "${user_config.api_key}"
+      }
+    }
+  },
+  "tools": [
+    { "name": "get_sports", "description": "List all available sports" },
+    { "name": "get_bookmakers", "description": "List all active bookmakers" },
+    { "name": "get_leagues", "description": "Get leagues for a sport" },
+    { "name": "get_events", "description": "Get upcoming events with filters" },
+    { "name": "get_live_events", "description": "Get currently live events with scores" },
+    { "name": "search_events", "description": "Search events by team name" },
+    { "name": "get_odds", "description": "Get odds for an event from selected bookmakers" },
+    { "name": "get_multi_odds", "description": "Get odds for multiple events in one call" },
+    { "name": "get_odds_movements", "description": "Get historical odds movements for an event" },
+    { "name": "get_updated_odds", "description": "Get recently updated odds across all events" },
+    { "name": "get_dropping_odds", "description": "Find odds that have dropped significantly from sharp bookmakers" },
+    { "name": "get_historical_events", "description": "Get past events for a sport and league" },
+    { "name": "get_historical_odds", "description": "Get closing odds for a finished event" },
+    { "name": "get_value_bets", "description": "Find value bets based on sharp bookmaker consensus" },
+    { "name": "get_arbitrage_bets", "description": "Find arbitrage opportunities across bookmakers" },
+    { "name": "get_selected_bookmakers", "description": "View your currently selected bookmakers" },
+    { "name": "select_bookmakers", "description": "Set your active bookmaker selection" },
+    { "name": "clear_selected_bookmakers", "description": "Reset bookmaker selection to default" }
+  ],
+  "user_config": {
+    "api_key": {
+      "type": "string",
+      "title": "API Key",
+      "description": "Your Odds-API.io API key. Get one free at odds-api.io",
+      "sensitive": true,
+      "required": true
+    }
+  },
+  "compatibility": {
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "odds-api-mcp-server",
-  "version": "1.2.1",
+  "version": "1.3.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.ts

@@ -413,7 +413,7 @@ const tools: ToolDefinition[] = [
   {
     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.",
+      "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. Response includes drop percentages for multiple time windows (sinceOpening, 12h, 24h, 48h).",
     inputSchema: {
       type: "object",
       properties: {
@@ -427,11 +427,16 @@ const tools: ToolDefinition[] = [
         },
         market: {
           type: "string",
-          description: "Market type to filter by: 'ML', 'Spread', or 'Totals'",
+          description:
+            "Market name to filter by (case-insensitive). Supported: ML, Spread, Totals, Spread HT, Totals HT, Totals 1Q, Spread 1Q, Team Total Home, Team Total Away, Corners Spread, Corners Totals, Corners Spread HT, Corners Totals HT, Bookings Spread, Bookings Totals, Player Props",
         },
         timeWindow: {
           type: "string",
-          description: "Time window for drop calculation and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+          description: "Time window for drop filtering and sorting: 'opening', '12h', '24h', '48h' (default: 'opening')",
+        },
+        sort: {
+          type: "string",
+          description: "Sort order: 'drop' (highest drop %), 'recent' (latest movement), 'kickoff' (soonest event). Default: 'drop'",
         },
         minDrop: {
           type: "number",
@@ -453,12 +458,13 @@ const tools: ToolDefinition[] = [
       required: [],
     },
     async handler(args) {
-      const { sport, league, market, timeWindow, minDrop, limit, page, includeEventDetails } =
+      const { sport, league, market, timeWindow, sort, minDrop, limit, page, includeEventDetails } =
         args as {
           sport?: string;
           league?: string;
           market?: string;
           timeWindow?: string;
+          sort?: string;
           minDrop?: number;
           limit?: number;
           page?: number;
@@ -470,6 +476,7 @@ const tools: ToolDefinition[] = [
           league,
           market,
           timeWindow,
+          sort,
           minDrop,
           limit,
           page,
@@ -680,7 +687,7 @@ const tools: ToolDefinition[] = [
 const toolMap = new Map(tools.map((tool) => [tool.name, tool]));
 
 const server = new Server(
-  { name: "odds-api-mcp", version: "1.1.1" },
+  { name: "odds-api-mcp", version: "1.3.0" },
   { capabilities: { tools: {}, resources: {} } },
 );