MCP Odds Api

@marcoeg

Basic information

About MCP Odds Api

MCP server for odds-api

MCP Odds Api config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-odds-api": {
      "command": "uvx",
      "args": [
        "--env-file",
        "/path/to/.env",
        "mcp-odds-api",
        "--transport",
        "sse",
        "--port",
        "9090"
      ]
    }
  }
}

MCP Odds Api tools

- Get in-play and forthcoming events (matches).

- Get odds for all forthcoming events (matches) for selected betting markets.

- Get odds for a specific event (match) for selected betting markets.

Overview

What is mcp-odds-api?

mcp-odds-api is a minimalist Model Context Protocol (MCP) server that provides tools to interact with the OddsAPI. It is designed for developers who want to retrieve sports betting odds and events within an MCP-compatible client (e.g., Claude Desktop). The server uses environment variables to limit queries to specific regions and a single sport, and supports both SSE and STDIO transport protocols.

How to use mcp-odds-api?

Configure the server by adding a JSON entry to the Claude Desktop config file (claude_desktop_config.json), providing the ODDS_API_KEY, ODDS_API_REGIONS, and ODDS_API_SPORT environment variables. Alternatively, run a standalone SSE server with uvx --env-file /path/to/.env mcp-odds-api --transport sse --port 9090. The server exposes three tools: get_events, get_odds, and get_event_odds.

Key features of mcp-odds-api

Uses environment variables to limit queries to selected regions and a single sport
Supports both SSE and STDIO transports
Provides get_events tool for in-play and forthcoming events
Provides get_odds tool for odds across all forthcoming events
Provides get_event_odds tool for odds on a specific event

Use cases of mcp-odds-api

Retrieve a list of upcoming or in-play sports matches via the get_events tool
Get current betting odds for all forthcoming matches using get_odds
Fetch odds for a specific match by providing its event ID with get_event_odds
Integrate sports odds data into an AI assistant or chatbot powered by an MCP client

Frequently asked questions

What are the prerequisites to run mcp-odds-api?

You need Python 3.10 or higher, a valid OddsAPI key (request one at https://the-odds-api.com/account/), and the `uv` package manager installed.

How do I configure mcp-odds-api with Claude Desktop?

Edit the Claude Desktop configuration file (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`; on Windows: `%APPDATA%/Claude/claude_desktop_config.json`) and add an entry under `mcpServers` with the correct `command`, `args`, and `env` variables (`ODDS_API_KEY`, `ODDS_API_REGIONS`, `ODDS_API_SPORT`).

What transport protocols are supported?

The server supports both SSE (Server-Sent Events) and STDIO transports. You can start the server with SSE by passing `--transport sse --port 9090`.

What tools does mcp-odds-api provide?

It provides three tools: `get_events` (returns in-play and forthcoming events), `get_odds` (returns odds for all forthcoming events for selected markets), and `get_event_odds` (returns odds for a specific event for selected markets).

How do I set environment variables?

Create a `.env` file in the project root with `ODDS_API_KEY`, `ODDS_API_REGIONS`, and `ODDS_API_SPORT`, or pass them directly in the Claude Desktop configuration's `env` block.

Comments

More Developer Tools MCP servers

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Innovalyxx Sovereign Edge

edge.innovalyxx.com

Verified cyber-physical AI tools. 25 MCP tools, x402-payable on Base.

Meticulous

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.