English Français العربية

io.github.odds-api-io/odds-api-mcp-server

Registre officiel Jeux, sport et divertissement

Live sports betting odds from 365+ bookmakers across 34 sports, with value bets and arbitrage.

Code source Site web Documentation

Que pouvez-vous faire avec io.github.odds-api-io/odds-api-mcp-server ?

  • 25 API tools covering the full Odds-API.io v3 surface: sports, events, odds, historical data, bet settlement, value bets, arbitrage, dropping odds, and more
  • Documentation resources for AI context
  • Real-time data from 365+ bookmakers across 34 sports

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package odds-api-mcp-server
Claude Code 
claude mcp add odds-api-mcp-server -e 'ODDS_API_KEY=<your odds_api_key>' -- npx -y odds-api-mcp-server@1.6.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "odds-api-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "odds-api-mcp-server@1.6.0"
            ],
            "env": {
                "ODDS_API_KEY": "<your odds_api_key>"
            }
        }
    }
}

Variables d'environnement

  • ODDS_API_KEY obligatoire secret Odds-API.io API key (free tier available, no credit card)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Odds-API.io MCP Server
  2. Features
  3. Quick Start
  4. Configuration
  5. Available Tools
  6. Resources
  7. Example Usage
  8. Development
  9. License
  10. Links

Odds-API.io MCP Server

Model Context Protocol (MCP) server for Odds-API.io - providing AI tools like Claude, Cursor, and VS Code with direct access to sports betting odds data.

Full AI-tooling docs: docs.odds-api.io/ai-vibe-coding

Features

  • 25 API tools covering the full Odds-API.io v3 surface: sports, events, odds, historical data, bet settlement, value bets, arbitrage, dropping odds, and more
  • Documentation resources for AI context
  • Real-time data from 365+ bookmakers across 34 sports

Quick Start

One-Click Install (Claude Desktop)

Download the latest .mcpb file from Releases and open it. Claude Desktop will prompt you for your API key.

Claude Code CLI
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server
Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}
Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}
VS Code

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}
Global Install (alternative)
npm install -g odds-api-mcp-server

Then use odds-api-mcp as the command instead of npx -y odds-api-mcp-server.

Configuration

VariableRequiredDescription
ODDS_API_KEYYesYour API key from odds-api.io

Available Tools

Sports & Leagues
ToolDescription
get_sportsList all available sports with slugs
get_leaguesGet leagues for a sport (with optional all flag for inactive leagues)
get_marketsList the exact market names a sport serves, with shape, period and prematch/live availability
Bookmakers
ToolDescription
get_bookmakersList all supported bookmakers
get_selected_bookmakersGet your currently selected bookmakers
select_bookmakersAdd bookmakers to your selection
clear_selected_bookmakersClear all selected bookmakers (once per 12h)
Events
ToolDescription
get_eventsGet events with filtering (league, status, date range, participant, bookmaker, pagination)
get_eventGet a single event by ID
get_live_eventsGet currently live events
search_eventsSearch events by team name or text
Odds
ToolDescription
get_oddsGet odds for an event from selected bookmakers
get_multi_oddsGet odds for up to 10 events in one call
get_odds_movementsGet historical line movements for a market
get_updated_oddsGet recently changed odds (polling), for the markets you name
Historical
ToolDescription
get_historical_eventsGet finished events for a sport/league/date range
get_historical_oddsGet closing odds and scores for finished events
Betting Analytics
ToolDescription
get_settlementsStatus, final score and final flag for up to 50 events
grade_betsSettle up to 50 bets as won, lost, void, half won or half lost
get_value_betsGet positive EV opportunities for a bookmaker
get_arbitrage_betsGet arbitrage opportunities with optimal stakes
get_dropping_oddsTrack sharp bookmaker line movements by sport, league, market, and time window
Participants
ToolDescription
get_participantsGet teams/participants for a sport
get_participantGet a single participant by ID
Reference
ToolDescription
get_documentationFetch full API documentation

Resources

Resource URIDescription
odds-api://documentationComplete API documentation
odds-api://openapiOpenAPI/Swagger specification

Example Usage

Once configured, ask your AI assistant things like:

  • "What sports are available on Odds-API?"
  • "Show me upcoming Premier League matches"
  • "Get odds for the next Arsenal match from Bet365 and SingBet"
  • "Find value bets on Bet365 with event details"
  • "Are there any arbitrage opportunities between Bet365 and Unibet?"
  • "Show me how the odds moved for event 12345 on the spread market"
  • "Get historical results for La Liga in January 2026"
  • "Show me the biggest dropping odds in football right now"
  • "What Premier League odds have dropped the most in the last 12 hours?"

Development

git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm test

License

MIT

Questions fréquentes

Qu'est-ce que io.github.odds-api-io/odds-api-mcp-server ?

Live sports betting odds from 365+ bookmakers across 34 sports, with value bets and arbitrage.

Comment installer io.github.odds-api-io/odds-api-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add odds-api-mcp-server -e 'ODDS_API_KEY=<your odds_api_key>' -- npx -y odds-api-mcp-server@1.6.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.odds-api-io/odds-api-mcp-server ?

Oui. Il attend ODDS_API_KEY, à renseigner dans sa configuration.

io.github.odds-api-io/odds-api-mcp-server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.odds-api-io/odds-api-mcp-server ?

Il est publié par odds-api-io. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.