INDIVIDUAL MCP TOOL

get_best_lines

Best available price per outcome across all books for a sport — the single best number a bettor could get on each side.

theoddsapi.comnone authenticationAvailability not checked

LIVE ENDPOINT

https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY

No auth detected

Connect to this endpoint to inspect the live schema for get_best_lines and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.theoddsapi]
url = "https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "theoddsapi": {
      "type": "http",
      "url": "https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: theoddsapi
Remote MCP URL: https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "theoddsapi": {
      "url": "https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "theoddsapi": {
      "type": "http",
      "url": "https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "theoddsapi",
  "transport": "streamable-http",
  "url": "https://mcp.theoddsapi.com/mcp?apiKey=YOUR_KEY"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

list_sports — List every valid sport_key the API supports (e.g.
get_odds — Current odds for a sport across sportsbooks.
get_account_status — Check the current key's status: plan tier, today's usage, and remaining requests.
detect_edges — Cross-book edges: where a book's price diverges from the fair-value (Pinnacle-anchored) line for a sport.
get_historical_odds — Historical odds snapshots from the archive for backtesting.
get_props — Player prop lines (points, strikeouts, passing yards, etc.) across sportsbooks, for games starting within the next 24 hours.