mcp-odds-api

# 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: ```json { "mcpServers": { "mcp-odds-api": { "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>", } } } } ``` 3. 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. 4. 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: ```bash $ uvx --env-file /path/to/.env mcp-odds-api --transport sse --port 9090 ``` >Note the use of `nvx` and not `uvx` will fetch `mcp-odds-api` from the default registry https://pypi.org. ## Development ### Setup 1. **Prerequisites**: - Python 3.10 or higher. - A OddsAPI key ([request here](https://the-odds-api.com/account/)). - `uv` package manager ([installation](https://docs.astral.sh/uv/)). 2. **Clone the Repository**: ```bash git clone https://github.com/marcoeg/m…