Log inSubmit server
Odds API MCP Server logo

Odds API MCP Server

Access live, historical, and analytical sports betting odds from Odds-API.io through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Odds API MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "odds-api-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "env": {
        "ODDS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 25 tools correctly (10d ago).

Overview

odds-api-mcp-server MCP server connects MCP-compatible AI clients to Odds-API.io sports betting data through an API key. It provides tools for finding sports, leagues, bookmakers, events, participants, current odds, historical odds, line movements, value bets, arbitrage, and dropping odds. Run it with npx or a global npm installation using a standard stdio MCP configuration. Reach for it when an agent needs to query or analyze bookmaker data without building a direct Odds-API.io client.

Use cases

  • Find upcoming events by sport, league, team, or date
  • Compare odds across selected bookmakers
  • Monitor live events and recently changed odds
  • Review historical closing odds and scores
  • Identify value bets, arbitrage, and dropping lines

Key features

  • Sports, league, bookmaker, event, and participant queries
  • Current, multi-event, updated, and historical odds
  • Event search and live-event retrieval
  • Value-bet and arbitrage analysis
  • Bookmaker selection management
  • Documentation and OpenAPI MCP resources

Tools25

What Odds API MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~2.9k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 51d

What it can do

From the 25 tools this server returned when we ran it.

Can delete or modify data · 1Makes network requests · 2Read-only tools · 24
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age304 days
Maintainers1

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11h ago via OSV.dev · odds-api-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads463Package downloads in the last 30 days.
Last commit15d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed25Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Odds API MCP Server works

What the odds-api-mcp-server MCP server does

The odds-api-mcp-server MCP server exposes Odds-API.io sports betting data to AI clients through MCP. It covers sports, leagues, bookmakers, events, teams or other participants, current odds, historical results, and market movements across 34 sports. Access requires an Odds-API.io API key supplied through the ODDS_API_KEY environment variable.

Agents can use the server to discover available sports and leagues, inspect supported bookmakers, search for events, retrieve live events, or look up a specific event by ID. Odds tools return prices from the selected bookmakers, support requests for up to 10 events, and provide recently changed or historically moving lines. Separate analytics tools identify positive-EV opportunities, arbitrage opportunities with suggested stakes, and notable line drops.

How it works

The server runs as a local stdio process and communicates with an MCP client. The documented launch path uses npx -y odds-api-mcp-server; a global npm installation can instead expose the odds-api-mcp command. After startup, the client can invoke the exposed tools and request the server's documentation resources.

Bookmaker selection is stateful within the API workflow: agents can inspect the current selection, add bookmakers, and clear the selection. Odds retrieval uses the selected bookmakers. Event queries support filters including league, status, date range, participant, bookmaker, and pagination. Historical tools focus on finished events, closing odds, and scores.

The server also exposes odds-api://documentation and odds-api://openapi, giving an AI client access to API documentation and the OpenAPI specification as MCP resources.

Setup and configuration

Install the package through npx in the MCP client configuration, or install it globally with npm. Set ODDS_API_KEY to an API key from Odds-API.io. The README provides configuration examples for Claude Desktop, Cursor, VS Code, and Claude Code.

A typical stdio configuration supplies npx as the command, passes -y odds-api-mcp-server as arguments, and places the API key in the server's environment. Keep the key in the environment configuration rather than embedding it in prompts or tool arguments.

For local development, the repository supports cloning the project, running npm install, then using npm run build and npm test.

Tools and capabilities

The tool groups cover:

  • Sports and leagues: list sports and retrieve active or inactive leagues.
  • Bookmakers: list supported bookmakers and manage the current selection.
  • Events: filter, search, retrieve, and inspect live events.
  • Odds: fetch event odds, query multiple events, inspect line movements, and poll for updates.
  • Historical data: find completed events and retrieve closing odds with scores.
  • Betting analysis: find value bets, arbitrage opportunities, and dropping odds.
  • Participants: list or retrieve teams and other participants for a sport.
  • Reference: fetch full API documentation.

The odds-api-mcp-server MCP server is suited to assistants that need structured sports data for research, monitoring, comparison, or analysis rather than a general-purpose web search workflow.

Limitations and notes

An API key is required to run the server. get_multi_odds accepts no more than 10 events per call. Clearing the selected bookmakers is limited to once per 12-hour period according to the tool description. The available data, bookmakers, sports, and API behavior depend on the connected Odds-API.io account and service.

Review the returned event, bookmaker, market, and timing details before using them in another system.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Odds API MCP Server

odds-api-mcp-server is an MCP server that connects AI clients to Odds-API.io sports betting data through an API key. Its main tools list sports, leagues, bookmakers, events, and participants; retrieve current, historical, and changed odds; and identify value bets, arbitrage opportunities, and dropping lines. It also exposes API documentation resources.

Install it with `npx -y odds-api-mcp-server` in your MCP client configuration, or run `npm install -g odds-api-mcp-server` and use `odds-api-mcp`. Set the required `ODDS_API_KEY` environment variable to an Odds-API.io API key.

Yes, odds-api-mcp-server works with Cursor through a project or global `.cursor/mcp.json` configuration. Define the server with `npx`, pass `-y odds-api-mcp-server`, and provide `ODDS_API_KEY` in the environment.

It can retrieve current odds for events from selected bookmakers, odds for up to 10 events in one call, recently updated odds, historical line movements, and closing odds for finished events. The server also provides value-bet, arbitrage, and dropping-odds queries.

Related MCP servers

All in Sports All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOdds API MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/odds-api-mcp-server?style=directory)](https://allmcps.com/mcp/odds-api-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/odds-api-mcp-server"><img src="https://allmcps.com/api/badge/odds-api-mcp-server?style=directory" alt="Odds API MCP Server on AllMCPs" /></a>