🏟️ Sports MCP Server

A Model Context Protocol (MCP) server that unifies The Odds API and SportMonks Football API v3 into a single tool surface for Claude Desktop and Claude Code.

What This Does

Total: 28 tools available to Claude via MCP.

Related MCP server: AltSportsData MCP Server

Quick Start

1. Install dependencies

cd sports-mcp-server
npm install
npm run build

2. Set your API keys

You'll configure these in the Claude Desktop config (step 3), but for testing:

export ODDS_API_KEY="your-odds-api-key-here"
export SPORTMONKS_TOKEN="your-sportmonks-token-here"

3. Configure Claude Desktop

Add this to your Claude Desktop config file:

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

{
  "mcpServers": {
    "sports-data": {
      "command": "node",
      "args": ["/FULL/PATH/TO/sports-mcp-server/dist/index.js"],
      "env": {
        "ODDS_API_KEY": "your-odds-api-key-here",
        "SPORTMONKS_TOKEN": "your-sportmonks-token-here"
      }
    }
  }
}

⚠️ Replace /FULL/PATH/TO/ with the actual absolute path to the project.

4. Restart Claude Desktop

After saving the config, restart Claude Desktop. You should see the sports tools available in the MCP tools menu.

For Claude.ai (Web / Chrome) — ⭐ This is what you want

The web app needs an HTTP server, not stdio. Here's how:

Step 1: Build & start the HTTP server

cd sports-mcp-server
npm install
npm run build

# Start the HTTP server with your API keys
ODDS_API_KEY=your-key-here SPORTMONKS_TOKEN=your-token-here npm run start:http

You should see:

🏟️  Sports MCP Server (HTTP/SSE) running on http://localhost:3456
   Tools: 10 Odds API + 18 SportMonks = 28 total
   Odds API key:     ✅ configured
   SportMonks token: ✅ configured

Step 2: Connect in Claude.ai

1. Go to claude.ai → Settings (bottom-left gear icon)

2. Click Integrations in the left sidebar

3. Click Add Custom Integration

4. Set:

   • Name: Sports Data

   • URL: http://localhost:3456/sse

5. Save and enable it

That's it — the 28 tools are now available in your Claude.ai conversations.

Optional: Protect with auth token

ODDS_API_KEY=xxx SPORTMONKS_TOKEN=xxx MCP_AUTH_TOKEN=my-secret npm run start:http

Then add the token in the integration config as a Bearer token.

Optional: Run on a remote server

If you want it always-on (e.g. on a VPS or Render/Railway):

1. Deploy the project to your server

2. Run npm run start:http with your env vars

3. Use https://your-server.com/sse as the integration URL

4. Set MCP_AUTH_TOKEN for security

Keep it running (local)

Use pm2 or a simple background process:

# Install pm2 globally
npm install -g pm2

# Start as a daemon
ODDS_API_KEY=xxx SPORTMONKS_TOKEN=xxx pm2 start dist/server-http.js --name sports-mcp

# Auto-restart on reboot
pm2 startup
pm2 save

For Claude Desktop (local app)

See the config under Quick Start above — uses stdio transport via dist/index.js.

For Claude Code

claude mcp add sports-data node /FULL/PATH/TO/sports-mcp-server/dist/index.js \
  -e ODDS_API_KEY=your-key \
  -e SPORTMONKS_TOKEN=your-token

Tool Reference

The Odds API Tools (prefix: odds_)

Common sport keys: basketball_nba, basketball_ncaab, americanfootball_nfl, americanfootball_ncaaf, icehockey_nhl, soccer_epl, soccer_germany_bundesliga, soccer_spain_la_liga, soccer_france_ligue_one, tennis_atp_*, tennis_wta_*

SportMonks Tools (prefix: sm_)

Using Includes (SportMonks)

SportMonks tools support an include parameter for enriched responses:

include: "participants,scores,league,statistics,events"
include: "player,position,teams"
include: "fixtures,rounds"

Using Filters (SportMonks)

Some endpoints support filters:

filters: "fixtureLeagues:8"       # Filter by league ID
filters: "eventTypes:14,18"        # Filter event types

Example Prompts

Once configured, you can ask Claude things like:

• "Get me tonight's NBA odds from DraftKings and FanDuel — spreads, moneylines, and totals"

• "Pull EPL standings for this season"

• "What are the live soccer scores right now?"

• "Compare the historical odds movement for the Lakers game last Tuesday"

• "Get Arsenal's xG data and current squad"

• "Show me value bets from SportMonks predictions for today's fixtures"

• "Get player props available for tonight's NFL game"

Architecture

src/
├── index.ts          # MCP server entry — stdio transport (Claude Desktop / Claude Code)
├── server-http.ts    # MCP server entry — HTTP/SSE transport (claude.ai web)
├── odds-api.ts       # The Odds API tool definitions (10 tools)
├── sportmonks.ts     # SportMonks tool definitions (18 tools)
└── http.ts           # Shared HTTP utility (fetch + URL builder)

License

MIT