oddsapi/odds-api-mcp-server repository overview

MCP server that gives Claude, Cursor, VS Code and other AI tools direct access to real-time sports betting odds from Odds-API.io: 450+ bookmakers, 34 sports, 12,000+ leagues, plus value bets, arbitrage and dropping odds.

⁠Quick start

The server speaks MCP over stdio, so run it with -i and pass your API key as an environment variable:

docker run -i --rm -e ODDS_API_KEY=your-api-key oddsapi/odds-api-mcp-server

Get a key at https://odds-api.io⁠.

⁠Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "odds-api": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "ODDS_API_KEY", "oddsapi/odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

⁠Cursor

Add the same block to .cursor/mcp.json in your project or your global Cursor MCP settings:

{
  "mcpServers": {
    "odds-api": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "ODDS_API_KEY", "oddsapi/odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

⁠Tools

33 tools covering every public Odds-API.io v3 REST endpoint: sports, markets, leagues, bookmakers, events, live events, search, odds with a market filter, multi-event odds, odds summaries (best, average and fair prices), odds movements, updated odds, value bets, arbitrage, dropping odds, historical events, search and odds, closing lines, settlement and bet grading, golf outrights (odds and results), participants, bookmaker id mappings and request quota. The participant logo (an image) and the WebSocket stream are not exposed as tools.

⁠Links

• Website: https://odds-api.io⁠
• AI and vibe coding guide: https://docs.odds-api.io/ai-vibe-coding⁠
• Source and issues: https://github.com/odds-api-io/odds-api-mcp-server⁠
• npm: https://www.npmjs.com/package/odds-api-mcp-server⁠

An API key from a paid plan is required: https://odds-api.io/pricing⁠