1. Conduid
  2. AI
  3. Odds API MCP Server
MCP server · AI

Odds API MCP Server

by · github.com/odds-api-io/odds-api-mcp-server

MCP server connecting Claude Desktop to The Odds API — live sports odds, scores, and schedules

Unclaimed ai
InstallView source
37Low

Scored 13 days ago · breakdown

About Odds API MCP Server

Odds API MCP Server is an MCP server published by odds-api-io in the AI category: mCP server connecting Claude Desktop to The Odds API — live sports odds, scores, and schedules.

The repository has 2 stars and 3 forks, with the last commit 11 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Claude Code
claude mcp add odds-api-mcp-server -- npx -y odds-api-mcp-server
npx
npx -y odds-api-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (2)

get_leaguesGet leagues for a sport (with optional `all` flag for inactive leagues)

Parameters not published.

get_sportsList all available sports with slugs

Parameters not published.

Ask AI

✦

Ask AI about Odds API MCP Server

Powered by Claude · Grounded in docs

I know everything about Odds API MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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.

Features

  • 22 API tools covering the full Odds-API.io v3 surface: sports, events, odds, historical data, value bets, arbitrage, dropping odds, and more
  • Documentation resources for AI context
  • Real-time data from 265+ 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

Variable Required Description
ODDS_API_KEY Yes Your API key from odds-api.io

Available Tools

Sports & Leagues

Tool Description
get_sports List all available sports with slugs
get_leagues Get leagues for a sport (with optional all flag for inactive leagues)

Bookmakers

Tool Description
get_bookmakers List all supported bookmakers
get_selected_bookmakers Get your currently selected bookmakers
select_bookmakers Add bookmakers to your selection
clear_selected_bookmakers Clear all selected bookmakers (once per 12h)

Events

Tool Description
get_events Get events with filtering (league, status, date range, participant, bookmaker, pagination)
get_event Get a single event by ID
get_live_events Get currently live events
search_events Search events by team name or text

Odds

Tool Description
get_odds Get odds for an event from selected bookmakers
get_multi_odds Get odds for up to 10 events in one call
get_odds_movements Get historical line movements for a market
get_updated_odds Get recently changed odds (polling)

Historical

Tool Description
get_historical_events Get finished events for a sport/league/date range
get_historical_odds Get closing odds and scores for finished events

Betting Analytics

Tool Description
get_value_bets Get positive EV opportunities for a bookmaker
get_arbitrage_bets Get arbitrage opportunities with optimal stakes
get_dropping_odds Track sharp bookmaker line movements by sport, league, market, and time window

Participants

Tool Description
get_participants Get teams/participants for a sport
get_participant Get a single participant by ID

Reference

Tool Description
get_documentation Fetch full API documentation

Resources

Resource URI Description
odds-api://documentation Complete API documentation
odds-api://openapi OpenAPI/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

Links

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Odds API MCP Server

How do I install Odds API MCP Server?

Run claude mcp add odds-api-mcp-server -- npx -y odds-api-mcp-server, then add the server to your MCP client's configuration.

Is Odds API MCP Server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Odds API MCP Server still maintained?

Yes — the last commit was 11 days ago. The repository has 2 stars and 3 forks.