mcpField
M
mcp-odds-api

mcp-odds-api

Local
github.com/marcoegDeveloper Tools4Updated 78w ago
Repository

About mcp-odds-api

mcp-odds-api is an MCP server for querying OddsAPI sports events and betting odds. It supports region and sport filters through environment variables and offers SSE and STDIO transports.

Key features

  1. 01Retrieve in-play and upcoming events
  2. 02Get odds across selected markets
  3. 03Fetch odds for a specific event
  4. 04Limit queries by region and sport
  5. 05SSE and STDIO transports

Use cases

  1. 01Check live and upcoming matches
  2. 02Review odds for selected markets
  3. 03Retrieve odds for a particular match

MCP support

Exposes OddsAPI event and odds queries as MCP tools: `get_events`, `get_odds`, and `get_event_odds`. Supports SSE and STDIO transports.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "odds-api": {
      "command": "uvx",
      "args": [
        "/path/to/.env"
      ]
    }
  }
}
Run commanduvx /path/to/.env

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypi/path/to/.env

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-odds-api

A mimimalist Model Context Protocol MCP server to interact with the OddsAPI.

Features

  • Uses environmental variables to limit the queries to some regions and a single sport.

It supports both SSE and STDIO transports.

Tools

The server implements the following tools to interact with the OddsAPI:

  • get_events:

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

  • get_odds:

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

  • get_event_odds:

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

Configuration

  1. Create _or edit the Claude Desktop configuration file located at:

    • On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • On Windows: %APPDATA%/Claude/claude_desktop_config.json

  2. Add the following:

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": ["mcp-odds-api"],
      "env": {
        "ODDS_API_KEY": "<your-api-odds-key>",
        "ODDS_API_REGIONS": "<region1>", "<region2>",
        "ODDS_API_SPORT": "<selected-sport-key>",
      }
    }
  }
}

  1. Replace /path/to/uvx with the absolute path to the uvx executable. Find the path with which uvx command in a terminal. This ensures that the correct version of uvx is used when starting the server.

  2. Restart Claude Desktop to apply the changes.

Run the stand-alone SSE server

Create a .env file from .env.example and then execute the following command:

$ uvx --env-file /path/to/.env mcp-odds-api --transport sse --port 9090

Note the use of nvx and not uvx will fetch mcp-bauplan from the default registry https://pypi.org.

Development

Setup

  1. Prerequisites:

  2. Clone the Repository:

git clone https://github.com/marcoeg/mcp-odds-api
cd mcp-nvd
  1. Set Environment Variables:
    • Create a .env file in the project root:
    ODDS_API_KEY="" ODDS_API_REGIONS="", "" ODDS_API_SPORT=""
  2. Install Dependencies:
uv sync
uv pip install -e .
Start the server with SSE transport
$ uv run mcp-odds-api --transport sse --port 9090
python-dotenv could not parse statement starting at line 2
2025-04-30 19:35:34 - dotenv.main - WARNING - python-dotenv could not parse statement starting at line 2
INFO:     Started server process [68314]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:9090 (Press CTRL+C to quit)
Run the Inspector:
$ CLIENT_PORT=8077 TARGET_PORT=9090 \
npx @modelcontextprotocol/inspector run

Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:8077 🚀

Then open the browser to the URL indicated by the MCP Inspector. Select SSE Transport Type.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.