OpticOdds MCP Integration Guide

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:

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:

{
   "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:

{
  "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:

claude mcp add opticodds \
  --transport http \
  https://api.opticodds.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Replace <YOUR_API_KEY> 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:

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

Video Walkthrough

For a quick visual walkthrough of the setup, watch this Loom: Claude MCP x OpticOdds

Available Tools

Once connected, Claude has access to the following OpticOdds capabilities:

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

Resources

• OpticOdds API Documentation
• OpticOdds Website
• Claude Desktop Download
• MCP Protocol Spec

Need help? Reach out to your OpticOdds account manager or contact the team at opticodds.com/contact.