Odds API MCP server

by odds-api-io·io.github.odds-api-io/odds-api-mcp-server·v1.6.0·2 stars

No reviews yet

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

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

Growing

2 stars159 downloads/wk

Reviews

Write one

Nobody has reviewed Odds API yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Odds API tools (25)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

clear_selected_bookmakers
Clear all selected bookmakers for the authenticated user. Limited to once every 12 hours.
get_arbitrage_bets
Get arbitrage opportunities across bookmakers. Returns profit margin, optimal stake distribution, and direct bet links for each leg.
get_bookmakers
List all supported bookmakers with their name and active status.
get_documentation
Fetch the complete Odds-API.io API documentation.
get_dropping_odds
Get odds that have dropped the most from opening, based on sharp bookmaker data. Useful for tracking where sharp money is moving. Updated every ~10 seconds. Only available on paid plans. Response includes drop percentages for multiple time windows (sinceOpening, 12h, 24h, 48h). For player prop markets, the response includes market.label with the player name (e.g. 'Carlos Baleba'). Use markets=Play
get_event
Get a single event by its unique ID.
get_events
Get events for a sport with filtering by league, participant, status, date range, bookmaker availability, and pagination support.
get_historical_events
Get finished events for a sport and league within a date range (max 31-day span).
get_historical_odds
Get closing odds and final scores for a finished event from selected bookmakers.
get_leagues
Get leagues for a sport. Returns league name, slug, and active event count.
get_live_events
Get all currently live events across all sports, optionally filtered by sport.
get_markets
List the exact market names served for a sport, with how to read each one (shape), the period it covers and whether it is available prematch and live. Use it before passing markets to other tools; names must match in full, e.g. 'ML' not 'Match Winner'.
get_multi_odds
Get odds for multiple events in a single request (up to 10 events). Counts as only 1 API call.
get_odds
Get betting odds for a specific event from selected bookmakers.
get_odds_movements
Get historical odds line movements for an event from a bookmaker. Returns opening, latest, and all intermediate price changes for a specific market.
get_participant
Get a single participant/team by their unique ID.
get_participants
Get teams/participants for a sport, optionally filtered by name search.
get_selected_bookmakers
Get the authenticated user's currently selected bookmakers.
get_settlements
Get what happened in up to 50 events: status (pending, live, awaiting_result, settled, cancelled), final score by period and a `final` flag that says the result is confirmed. Unknown ids are listed in notFound. Paid plans.
get_sports
List all available sports with their name and slug identifier.
get_updated_odds
Get odds updated since a Unix timestamp for a bookmaker and sport, limited to the markets you name. The timestamp must be at most 90 seconds old. Useful for efficient polling.
get_value_bets
Get positive expected value betting opportunities for a bookmaker. Updated every 5 seconds. EV formula: (Probability x Odds) - 1.
grade_bets
Settle up to 50 bets. Each selection is graded as won, lost, void, half_won, half_lost, pending or ungradeable, with a reason, a `final` flag and the score it was based on. Covers 64 markets in 20 sports, including Asian handicap quarter lines, totals, corners, bookings and player props. Football settles on 90 minutes. Paid plans.
search_events
Search events by team name or text query. Returns up to 10 matching results.
select_bookmakers
Add bookmakers to the authenticated user's selection.

Public scan report

scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it

no findings

Code scan9 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 5 days ago15/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Odds API compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 25; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 2; more than 75% of 28,688 servers
Downloads a week: 159; more than 72% of 12,191 servers with a package

What its tools let an agent do: 25 read

Release history: 3 versions in the registry since 2026-07-24, latest 2026-10-13, typically one every 59 days.

Install Odds API in Claude Code, Cursor or VS Code

Runs npx -y odds-api-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

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

Add to Cursor

What the publisher says

From the Odds API repository's README, as published. We do not edit it. Read it on GitHub

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

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 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/claudedesktopconfig.json on macOS, %APPDATA%\Claude\claudedesktopconfig.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

Available Tools

Sports & Leagues

Bookmakers

Events

Odds

Historical

Betting Analytics

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Odds API: common questions

Is Odds API MCP server safe?: Mostly: it is graded B (80/100). Read the Odds API safety report
How do I install Odds API?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Odds API need an API key?: Yes. The registry entry asks for ODDS_API_KEY.
Is Odds API maintained?: The last commit was 8 days ago (2026-10-27). The latest release is v1.6.0.
How does Odds API compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 25 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.