# Odds API MCP Server

An MCP (Model Context Protocol) server that connects Claude Desktop to [The Odds API](https://the-odds-api.com/), 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](https://nodejs.org/) v18 or later
- An API key from [The Odds API](https://the-odds-api.com/) (free tier available)

## Installation

1. Clone this repository:

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

2. Install dependencies:

   ```bash
   npm install
   ```

3. Build:

   ```bash
   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):

```json
{
  "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:

   ```bash
   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](https://the-odds-api.com/liveapi/guides/v4/). See their docs for full details on available sports, markets, and bookmaker regions.

## License

MIT