# SportRadar MCP Server

MCP server providing tools to query live scores, schedules, standings, and game stats from the SportRadar API.

## Supported Sports
- **NFL** — Schedule, standings, game stats, boxscores
- **NBA** — Schedule, daily scores, standings, game summaries
- **NHL** — Schedule, daily scores, standings, game summaries
- **NCAAMB** — Daily schedule, rankings, standings, game summaries
- **Soccer** — Daily results/schedule, competitions, standings
- **Tennis** — Rankings (ATP/WTA), daily results, competitions

## Setup

### 1. Install dependencies

```bash
cd sportradar-mcp
pip install -e .
```

Or with uv:
```bash
uv pip install -e .
```

### 2. Configure API key

Copy `.env.example` to `.env` and add your SportRadar API key:

```bash
cp .env.example .env
```

```
SPORTRADAR_API_KEY=your_key_here
SPORTRADAR_ACCESS_LEVEL=trial
```

### 3. Connect to Claude Desktop

Add to your Claude Desktop config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "sportradar": {
      "command": "python",
      "args": ["C:/Users/manka/sportradar-mcp/server.py"],
      "env": {
        "SPORTRADAR_API_KEY": "your_key_here"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `nfl_schedule` | NFL schedule by season/week |
| `nfl_standings` | NFL standings by division |
| `nfl_game_stats` | Detailed game statistics |
| `nfl_boxscore` | Game boxscore |
| `nba_schedule` | NBA season schedule |
| `nba_daily_schedule` | NBA scores for a date |
| `nba_standings` | NBA standings by conference |
| `nba_game_summary` | Detailed game summary |
| `nhl_schedule` | NHL season schedule |
| `nhl_daily_schedule` | NHL scores for a date |
| `nhl_standings` | NHL standings by division |
| `nhl_game_summary` | Detailed game summary |
| `ncaamb_daily_schedule` | College basketball scores for a date |
| `ncaamb_rankings` | AP Top 25 rankings |
| `ncaamb_standings` | Conference standings |
| `ncaamb_game_summary` | Detailed game summary |
| `soccer_daily_results` | Soccer results for a date |
| `soccer_daily_schedule` | Upcoming soccer matches |
| `soccer_competitions` | List available leagues |
| `soccer_standings` | League standings by season |
| `tennis_rankings` | ATP/WTA rankings |
| `tennis_daily_results` | Tennis results for a date |
| `tennis_competitions` | List tournaments |
| `sportradar_raw` | Raw endpoint access for any sport |

## Example Prompts

- "What are the NFL standings?"
- "Show me NBA scores from yesterday"
- "Who's ranked #1 in college basketball?"
- "Get me the ATP tennis rankings"
- "What Premier League matches are on today?"