--- updatedAt: 2026-05-15T17:21:03.000Z --- Fetch the complete documentation index at: https://developer.opticodds.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # OpticOdds MCP Integration Guide Connect OpticOdds real-time sports betting data directly to Claude using the Model Context Protocol (MCP). ## Overview The OpticOdds MCP server lets you query real-time odds, fixtures, player props, injuries, results, and more from 200+ sportsbooks — all through natural language in Claude. No REST calls, no boilerplate. Just ask Claude what you need. *** ## Prerequisites Before you begin, make sure you have the following ready: | Requirement | Details | | ---------------------- | -------------------------------------------------------------------------- | | **OpticOdds API Key** | Obtain from [opticodds.com](https://opticodds.com) or your account manager | | **Node.js ≥ 18** | Required for `npx`. Download at [nodejs.org](https://nodejs.org) | | **Claude Desktop App** | Download at [claude.ai/download](https://claude.ai/download) | *** ## Setup Instructions You have **three options** to connect OpticOdds to Claude. Choose whichever fits your workflow. *** ### Option A — Local MCP Server (via `npx`) This method runs the MCP server locally on your machine. Claude Desktop launches it automatically on startup. **Step 1 → Open your Claude Desktop config file** * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` **Step 2 → Paste the following configuration** Replace `your-api-key` with your actual OpticOdds API key. Try this option first: ```json { "mcpServers":{ "opticodds":{ "url":"https://api.opticodds.com/mcp", "headers":{ "Authorization":"Bearer YOUR_API_KEY" } } } } ``` If that doesn't work then you will need to use the `npx` version: ```json { "mcpServers": { "opticodds": { "command": "npx", "args": ["-y", "opticodds-mcp"], "env": { "OPTICODDS_API_KEY": "your-api-key" } } } } ``` > **Note:** If you already have other MCP servers configured, add the `"opticodds"` block inside the existing `"mcpServers"` object — don't overwrite the whole file. **Step 3 → Save the file and restart Claude Desktop** That's it. Claude will automatically launch the OpticOdds MCP server on startup. When we ship updates to the npm package, you get the new version automatically on next restart. *** ### Option B — Remote MCP Server (via HTTP) This method connects to OpticOdds' hosted MCP endpoint directly. No local server process needed. **Run this command in your terminal:** ```bash claude mcp add opticodds \ --transport http \ https://api.opticodds.com/mcp \ -H "Authorization: Bearer " ``` Replace `` with your actual key. *** ### Full Config Reference (Cowork / Claude Code) If you're using Cowork mode or Claude Code with additional preferences enabled, your full config may look like this: ```json { "preferences": { "coworkWebSearchEnabled": true, "coworkScheduledTasksEnabled": true, "ccdScheduledTasksEnabled": true, "sidebarMode": "chat" }, "mcpServers": { "opticodds": { "command": "npx", "args": ["-y", "opticodds-mcp"], "env": { "OPTICODDS_API_KEY": "your-api-key" } } } } ``` *** ## Verifying the Connection After restarting Claude Desktop, you should see a **hammer icon** (🔨) in the chat input area indicating MCP tools are available. Click it to confirm `opticodds` tools are listed. You can also test with a simple prompt: ``` What NBA games are on tonight? ``` If Claude returns live fixture data, you're connected. *** ## Available Tools Once connected, Claude has access to the following OpticOdds capabilities: | Tool | Description | | ----------------------- | ------------------------------------------ | | `get_sports` | List all supported sports | | `get_leagues` | Get leagues for a given sport | | `get_fixtures` | Retrieve upcoming and live fixtures | | `get_odds` | Pull real-time odds for a fixture | | `get_markets` | Discover available betting markets | | `get_sportsbooks` | List available sportsbooks | | `get_player_props` | Get player prop lines | | `get_injuries` | Check injury reports | | `get_results` | Look up final scores and results | | `get_line_history` | View historical line movement | | `find_best_price` | Find the best available price across books | | `find_outliers` | Spot outlier lines across sportsbooks | | `compare_lines` | Compare lines across multiple sportsbooks | | `compare_futures_lines` | Compare futures odds across books | | `grade_bet` | Grade a settled bet | | `grade_futures_bet` | Grade a settled futures bet | *** ## Example Prompts Here are some things you can ask Claude once OpticOdds is connected: **Odds & Lines** * "Compare the moneyline for Lakers vs Celtics across all sportsbooks" * "What's the best price on the Eagles -3.5 this week?" * "Show me any outlier lines on tonight's NHL games" **Player Props** * "Get Jalen Brunson's points prop for tonight" * "Compare Ohtani strikeout lines across DraftKings, FanDuel, and BetMGM" **Fixtures & Results** * "What NFL games are this Sunday?" * "What were the final scores for yesterday's Premier League matches?" **Injuries & Research** * "Are there any injuries for the Warriors ahead of tonight's game?" * "Show me the line history for the Super Bowl spread over the last 7 days" *** ## Troubleshooting | Issue | Solution | | ----------------------------- | ------------------------------------------------------------------------------ | | Tools not appearing in Claude | Make sure the config file is saved and Claude Desktop has been fully restarted | | `npx` command not found | Install Node.js ≥ 18 from [nodejs.org](https://nodejs.org) | | Authentication errors | Double-check your `OPTICODDS_API_KEY` value — no extra spaces or quotes | | Stale data or timeouts | Try restarting Claude Desktop to re-launch the MCP process | *** ## Resources * [OpticOdds API Documentation](https://developer.opticodds.com) * [OpticOdds Website](https://opticodds.com) * [Claude Desktop Download](https://claude.ai/download) * [MCP Protocol Spec](https://modelcontextprotocol.io) *** *Need help? Reach out to your OpticOdds account manager or contact the team at [opticodds.com/contact](https://opticodds.com).*