mcp-odds-api

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

FAQ from mcp-odds-api

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.