mcp-odds-api

Name: mcp-odds-api
Author: marcoeg

@marcoeg

代码仓库

关于 mcp-odds-api

MCP server for odds-api

基本信息

分类

开发工具

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

marcoeg

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

- 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.

概览

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.