Odds API MCP Server

An MCP (Model Context Protocol) server that connects Claude Desktop to The Odds API, giving Claude real-time access to sports odds, scores, and schedules across 80+ sports and leagues worldwide.

What It Does

This server lets Claude fetch live sports betting data on your behalf — moneylines, spreads, totals, player props, scores, and more — from major bookmakers across the US, UK, EU, and Australia.

Every response includes your API quota usage so you can track how many requests you have left.

Tools

| Tool | Description | Quota Cost | |---|---|---| | get_sports | List all in-season sports and their keys | Free | | get_events | List upcoming/live events for a sport with IDs and schedules | Free | | get_odds | Get odds from multiple bookmakers for a sport (h2h, spreads, totals, outrights) | 1 per region per market | | get_scores | Get live scores and recently completed games (up to 3 days back) | 1-2 | | get_event_odds | Get odds for a single event, including player props (points, assists, rebounds, etc.) | 1 per region per market | | get_event_markets | See which markets each bookmaker has open for a specific event | Varies |

Prerequisites

Node.js v18 or later
An API key from The Odds API (free tier available)

Installation

Clone this repository:

   git clone https://github.com/acraw4d/odds-api-mcp-server.git
   cd odds-api-mcp-server

Install dependencies:

   npm install

Build:

   npm run build

Configure Claude Desktop

Open your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Add the server to mcpServers (update the path to match where you cloned the repo):

{
  "mcpServers": {
    "odds-api-server": {
      "command": "node",
      "args": [
        "C:\\path\\to\\odds-api-mcp-server\\dist\\index.js"
      ],
      "env": {
        "ODDS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop after saving.

Local Development

If you want to run the server locally outside of Claude Desktop:

Create a .env file in the project root:

   ODDS_API_KEY=your-api-key-here

Build and run:

   npm run build
   npm start

Example Usage

Once configured, you can ask Claude things like:

"What NBA games are on tonight?"
"Show me the moneyline odds for today's MLB games"
"What are the player prop odds for the Lakers game?"
"Get me the scores from yesterday's NFL games"
"What sports are in season right now?"

API Documentation

This server wraps The Odds API v4. See their docs for full details on available sports, markets, and bookmaker regions.

License

MIT

Odds API MCP Server