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.