# Sports MCP Server

A production-ready **Model Context Protocol (MCP)** server delivering comprehensive
sports intelligence via SSE transport. Built for direct integration with Manus AI
and any MCP-compatible AI assistant.

## Features

| Domain | What You Get |
|---|---|
| **Live Scores** | Real-time scores, game status, period/clock for 15+ sports |
| **Standings** | Full league standings with W/L/PCT, division, conference |
| **Schedule** | Upcoming games, broadcast info, venue details |
| **Betting Odds** | Moneyline, spread, totals from 30+ bookmakers (FanDuel, DraftKings, BetMGM…) |
| **Sports News** | Latest headlines from ESPN + Google News RSS |
| **Highlights** | Game highlight clips with direct video links |
| **Game Summary** | Full box score, scoring plays, statistical leaders |
| **Rosters** | Full team rosters with player details |
| **Player Stats** | Current season statistics for any player |
| **Injury Reports** | Latest injury status for all teams |
| **League Leaders** | Statistical leaders by category |
| **Transactions** | Trades, signings, cuts, and waivers |

## Supported Sports

`nfl` `nba` `mlb` `nhl` `ncaaf` `ncaab` `mls` `epl` `laliga` `bundesliga`
`seriea` `ucl` `wnba` `ufc` `golf` `tennis` `nascar` `f1` `boxing`

## Quick Start

```bash
# 1. Install dependencies
pip install -r requirements.txt

# 2. Configure (optional — only needed for betting odds)
cp .env.example .env
# Edit .env and add your ODDS_API_KEY from https://the-odds-api.com

# 3. Start the server
python server.py
# Server runs at http://localhost:8000
# SSE endpoint: http://localhost:8000/sse
```

## MCP Configuration (Manus Custom MCP)

Paste this into the Parameter Configuration field when adding a Custom MCP in Manus:

```json
{
  "mcpServers": {
    "sports-mcp": {
      "type": "sse",
      "url": "https://YOUR_DEPLOYED_URL/sse"
    }
  }
}
```

## Available MCP Tools

| Tool | Description |
|---|---|
| `get_live_scores` | Live scoreboard for any sport |
| `get_standings` | League standings |
| `get_schedule` | Upcoming game schedule |
| `get_team_roster` | Full team roster |
| `get_player_stats` | Player season statistics |
| `get_injury_report` | Injury report by sport/team |
| `get_betting_odds` | Live odds (requires ODDS_API_KEY) |
| `get_available_betting_sports` | List all bettable sports |
| `get_sports_news` | Latest news headlines |
| `get_highlights` | Game highlight video links |
| `get_game_summary` | Full box score and game details |
| `get_league_leaders` | Statistical leaders by category |
| `get_transactions` | Trades, signings, transactions |
| `health_check` | Server status and configuration |

## Data Sources

- **ESPN API** — Scores, standings, schedules, rosters, injuries, stats (free, no key)
- **The Odds API** — Betting odds from 30+ bookmakers (free: 500 credits/month)
- **Google News RSS** — Sports news headlines (free, no key)

## Betting Odds Setup

1. Visit [https://the-odds-api.com](https://the-odds-api.com)
2. Sign up for a free account (no credit card required)
3. Copy your API key
4. Set `ODDS_API_KEY=your_key` in your `.env` file or environment

The free tier provides **500 credits/month** — each odds request costs 1 credit per
region × market combination, so you get ~100 full requests per month at no cost.