Odds API 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

1. Clone this repository:

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

2. Install dependencies:

   npm install
   

3. 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:

1. Create a .env file in the project root:

   ODDS_API_KEY=your-api-key-here
   

2. 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