Getting Started

MCP server

Connect OpenOddsAPI to any AI — Claude, Cursor, VS Code or your own agent — in one config block.

The OpenOddsAPI MCP server exposes the REST API as callable tools. Install it once, add a config block to any MCP client, and AI agents — coding assistants like Claude Code and Cursor, or AI products — can query odds, events and scores in plain language. Agents auto-discover the tools and can even create their own scoped API key, so there is no docs archaeology and no manual setup.

Install

Run the server anywhere Node is available:

bash

npx -y @openoddsapi/mcp-server

Connect a client

Add the server to your MCP client configuration. For Claude Desktop:

JSON

{
  "mcpServers": {
    "openoddsapi": {
      "command": "npx",
      "args": ["-y", "@openoddsapi/mcp-server"],
      "env": { "OPENODDSAPI_API_KEY": "sk_live_9f2c1b7e4d8a" }
    }
  }
}

Available tools

Tool	What it does
list_sports	All sports with live odds, keys and regions.
get_odds	Odds for a sport, filtered by market, bookmaker, region and odds format.
get_events	Upcoming, live and final events for a sport.
get_scores	Scores with period-by-period detail.
get_books	Bookmaker coverage by region.
get_status	API health, version and your rate-limit usage.
create_api_key	Create a scoped, revocable API key for an application or agent.

Example prompts

Who is favoured to win the UFC title fight this weekend? — calls get_odds with sport="ufc", market="moneyline".
Best-priced moneyline across US books for every NFL game this Sunday — calls get_odds with sport="nfl", region="us".
Did the Chiefs cover the spread in week 1? — calls get_scores with sport="nfl".

NOTEThe MCP server and the REST API serve the same data. Use MCP for agents and assistants, REST for your own services — or both.