SportsGameOdds MCP
Consultez les cotes des paris sportifs en temps réel, les scores, les paris sur les performances des joueurs et les résultats auprès de plus de 85 bookmakers couvrant plus de 67 ligues, directement depuis votre assistant de programmation IA, ainsi que la découverte des points de terminaison, la recherche dans la documentation et le suivi de l’utilisation de l’API.
Documentation
AI-Assisted Development - MCP Server and Context
AI tools can significantly speed up your development process. However, these tools need proper context in order to generate accurate, production-ready code. The information below is designed to help you do just that.
Copy-Paste Context
We highly recommend you either paste the AI Context below into your prompt or add it to an applicable context/rules file.
AI-Friendly Docs
Indexed Documentation
View llms.txt — Includes URLs and descriptions of each of our documentation pages. AI tools can use this to identify specific documentation pages to fetch/read when needed. Length: ~2k tokens
Full Documentation
View llms-full.txt — Includes our entire documentation in a single file. This is helpful for AI tools that have a large context window. Length: ~85k tokens
OpenAPI Specification
View OpenAPI Spec — A full machine-readable API definition with exact schemas for all endpoints/requests and responses. Every page also advertises it via <link rel="service-desc">, so agents can find it without being told the URL. Length: ~600k tokens
Markdown Versions of Any Page
Every page on this site has a Markdown representation — no HTML, no nav, no scripts. Request it either way:
# Content negotiation (acceptmarkdown.com)
curl -H "Accept: text/markdown" https://sportsgameodds.com/docs/basics/quickstart
# Or append .md / .mdx to the URL
curl https://sportsgameodds.com/docs/basics/quickstart.mdx
curl https://sportsgameodds.com/leagues/nfl-odds-api.md
MCP Server
Our MCP server enables AI tools to directly make calls to the API.
You can find the server here: sports-odds-api-mcp.
It provides the following resources/tools:
- List endpoints - Discover available API operations
- Fetch live data - Get events, odds, teams, players, leagues, etc.
- Search documentation - Find relevant info from the documentation
- Monitor usage - Check your API quota and rate limits
- Stream events - Get notified when Events change (AllStar plan only)
Below are installation instructions. Be sure to replace your-api-key-here with your actual API key.
Claude Code
claude mcp add sports-game-odds --env SPORTS_ODDS_API_KEY_HEADER="your-api-key-here" -- npx -y sports-odds-api-mcp
{
"mcpServers": {
"sports-game-odds": {
"command": "npx",
"args": ["-y", "sports-odds-api-mcp@latest"],
"env": {
"SPORTS_ODDS_API_KEY_HEADER": "your-api-key-here"
}
}
}
}
Cursor
{
"mcpServers": {
"sports-game-odds": {
"command": "npx",
"args": ["-y", "sports-odds-api-mcp@latest"],
"env": {
"SPORTS_ODDS_API_KEY_HEADER": "your-api-key-here"
}
}
}
}
VS Code
code --add-mcp '{"name":"sports-game-odds","command":"npx","args":["-y","sports-odds-api-mcp@latest"],"env":{"SPORTS_ODDS_API_KEY_HEADER":"your-api-key-here"}}'
{
"name": "sports-game-odds",
"command": "npx",
"args": ["-y", "sports-odds-api-mcp@latest"],
"env": {
"SPORTS_ODDS_API_KEY_HEADER": "your-api-key-here"
}
}
AI Context
Paste the following into your prompt or add it to an applicable rules file:
# SportsGameOdds API Reference
Real-time and historical sports and odds data.
## Primary Documentation Resources
If your environment can fetch external URLs, use these as your primary sources of truth. **Do not guess or make up information.**
| Resource | URL | Use Case |
| ------------------------------------ | ----------------------------------------------- | ------------------------------------------------------------------------ |
| Documentation Index (~2k tokens) | https://sportsgameodds.com/docs/llms.txt | Quick overview of all documentation pages with descriptions |
| Full Documentation (~85k tokens) | https://sportsgameodds.com/docs/llms-full.txt | Detailed explanations of fields, parameters, and examples |
| OpenAPI Specification (~600k tokens) | https://sportsgameodds.com/openapi.json | Exact request/response schemas, parameter definitions, example responses |
| Any page as Markdown | Append \`.md\` to a page URL, or send \`Accept: text/markdown\` | Clean prose without HTML — e.g. https://sportsgameodds.com/leagues/nfl-odds-api.md |
> **Note:** If you cannot access URLs directly, ask the user to paste in the relevant resource instead of guessing.
## Authentication
- **API Key Required:** Users can obtain one at https://sportsgameodds.com/pricing
- Free tier available
- Paid tiers include free trials
- API key is emailed after signup
- **Security:** Treat the API key as secret. Never invent an API key.
- **Usage:** Include the API key in all requests using one of these methods:
- Query parameter: \`?apiKey=API_KEY\`
- Header: \`x-api-key: API_KEY\`
## Response Format
- All responses are JSON
- Main response data is returned in the \`data\` field
## Endpoints
### Events Endpoint (Most Common)
**URL:** \`GET https://api.sportsgameodds.com/v2/events\`
**Full Documentation:** https://sportsgameodds.com/docs/endpoints/getEvents
#### Common Query Parameters
| Parameter | Example | Description |
| ----------------- | -------------------------- | ---------------------------------------------------- |
| \`oddsAvailable\` | \`true\` | Only return live/upcoming events with odds available |
| \`leagueID\` | \`NBA,NFL,MLB\` | Filter by leagues (comma-separated) |
| \`oddID\` | \`points-home-game-ml-home\` | Filter by odds markets (comma-separated) |
| \`includeAltLines\` | \`true\` | Include alternate spread/over/under lines |
| \`cursor\` | \`<nextCursor>\` | Pagination cursor for next page |
| \`limit\` | \`10\` | Max events to return (default: 10, max: variable) |
#### Event Object Key Fields
| Field | Type | Description |
| -------------------- | ------- | ------------------------------------------- |
| \`eventID\` | string | Unique identifier for the event |
| \`sportID\` | string | ID of the sport |
| \`leagueID\` | string | ID of the league |
| \`teams.home.teamID\` | string | ID of the home team (if applicable) |
| \`teams.away.teamID\` | string | ID of the away team (if applicable) |
| \`status.startsAt\` | date | Start time of the event |
| \`status.started\` | boolean | Whether the event has started |
| \`status.ended\` | boolean | Whether the event has ended |
| \`status.finalized\` | boolean | Whether the event's data has been finalized |
| \`players.<playerID>\` | object | Information about a participating player |
| \`odds\` | object | Odds data for the event |
> **Tip:** When the user has a specific use case (e.g., "get NFL games today with moneyline odds"), help them choose appropriate filters and construct the full request URL or HTTP client code.
## OddID Format
Each \`oddID\` uniquely identifies a specific side/outcome on a betting market.
**Format:** \`{statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}\`
**Examples:**
| oddID | Description |
| ----------------------------------------- | --------------------------------------------------- |
| \`points-home-game-ml-home\` | Moneyline bet on the home team to win the full game |
| \`points-away-1h-sp-away\` | Spread bet on the away team to win the first half |
| \`points-all-game-ou-over\` | Over bet on total points for the full game |
| \`assists-LEBRON_JAMES_1_NBA-game-ou-over\` | Over bet on LeBron James assists for the full game |
## Bookmaker Odds Structure
**Path:** \`odds.<oddID>.byBookmaker.<bookmakerID>\`
| Field | Type | Description |
| ----------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| \`odds\` | string | Current odds in American format |
| \`available\` | boolean | Whether this market is currently available |
| \`spread\` | string (optional) | Current spread/line (when \`betTypeID === "sp"\`) |
| \`overUnder\` | string (optional) | Current over/under line (when \`betTypeID === "ou"\`) |
| \`deeplink\` | string (optional) | Direct URL to the market on bookmaker's website |
| \`altLines\` | array (optional) | Alternate lines (only if \`includeAltLines=true\`). Each object may contain: \`odds\`, \`available\`, \`spread\`, \`overUnder\`, \`lastUpdatedAt\` |
> **Note:** Use the docs and/or OpenAPI spec to confirm additional or optional fields.
## Reference: Common Identifiers
### sportID
| ID | Sport |
| ------------ | ---------- |
| \`BASKETBALL\` | Basketball |
| \`FOOTBALL\` | Football |
| \`SOCCER\` | Soccer |
| \`HOCKEY\` | Hockey |
| \`TENNIS\` | Tennis |
| \`GOLF\` | Golf |
| \`BASEBALL\` | Baseball |
### leagueID
| ID | League |
| ----------------------- | ------------------------ |
| \`NBA\` | NBA |
| \`NFL\` | NFL |
| \`MLB\` | MLB |
| \`NHL\` | NHL |
| \`EPL\` | Premier League |
| \`UEFA_CHAMPIONS_LEAGUE\` | Champions League |
| \`NCAAB\` | Men's College Basketball |
| \`NCAAF\` | Men's College Football |
### bookmakerID
| ID | Bookmaker |
| ------------ | ---------- |
| \`draftkings\` | DraftKings |
| \`fanduel\` | FanDuel |
| \`bet365\` | Bet365 |
| \`circa\` | Circa |
| \`caesars\` | Caesars |
| \`betmgm\` | BetMGM |
| \`betonline\` | BetOnline |
| \`prizepicks\` | PrizePicks |
| \`pinnacle\` | Pinnacle |
### betTypeID & sideID
| betTypeID | Description | Valid sideIDs |
| --------- | --------------- | ------------------------------------------------------------ |
| \`ml\` | Moneyline | \`home\`, \`away\` |
| \`sp\` | Spread | \`home\`, \`away\` |
| \`ou\` | Over/Under | \`over\`, \`under\` |
| \`eo\` | Even/Odd | \`even\`, \`odd\` |
| \`yn\` | Yes/No | \`yes\`, \`no\` |
| \`ml3way\` | 3-Way Moneyline | \`home\`, \`away\`, \`draw\`, \`away+draw\`, \`home+draw\`, \`not_draw\` |
### periodID
| ID | Period |
| ------ | -------------- |
| \`game\` | Full Game |
| \`1h\` | First Half |
| \`2h\` | Second Half |
| \`1q\` | First Quarter |
| \`2q\` | Second Quarter |
| \`3q\` | Third Quarter |
| \`4q\` | Fourth Quarter |
### statID (varies by sport)
| ID | Description |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \`points\` | Stats that determine the winner (points in Baseball/Football, goals in Soccer/Hockey, sets in Tennis, strokes against par in Golf, fight winner in MMA/Boxing) |
| \`rebounds\` | Rebounds |
| \`assists\` | Assists |
| \`steals\` | Steals |
| \`receptions\` | Receptions |
| \`passing_yards\` | Passing yards |
| \`rushing_yards\` | Rushing yards |
| \`receiving_yards\` | Receiving yards |