Skip to main content
Glama
Sign In
getodds-mcp

getodds-mcp

Official
by getoddsapi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

getodds-mcp

MCP server (stdio) for the GetOdds sports odds API. It gives Claude, Cursor, VS Code and any MCP client tools for DraftKings, FanDuel and BetRivers sportsbook prices and PrizePicks, Underdog and DraftKings Pick6 pick'em lines, with the capture time on every row.

Two tools work with no account at all. The rest need a free key (1,000 requests a UTC day, 60 a minute, no card) from https://getoddsapi.com/sign-up.

Install

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most clients:

{
  "mcpServers": {
    "getodds": {
      "command": "npx",
      "args": ["-y", "getodds-mcp"],
      "env": { "GETODDS_API_KEY": "your key, or leave this out for the keyless tools" }
    }
  }
}

Claude Code:

claude mcp add getodds -e GETODDS_API_KEY=$GETODDS_API_KEY -- npx -y getodds-mcp

VS Code (.vscode/mcp.json):

{ "servers": { "getodds": { "type": "stdio", "command": "npx", "args": ["-y", "getodds-mcp"],
  "env": { "GETODDS_API_KEY": "${input:getodds-key}" } } },
  "inputs": [{ "id": "getodds-key", "type": "promptString", "password": true, "description": "GetOdds API key" }] }

Prefer no local process? The same data is on the hosted server https://getoddsapi.com/api/mcp (streamable HTTP, Authorization: Bearer <key>). Configs for eight clients: https://getoddsapi.com/mcp.

Related MCP server: propzapi

Tools

Tool

Key

What it returns

get_public_board

none

DraftKings moneyline, spread, total for nfl, nba, nhl, college-football or soccer-odds-api (cached up to 5 min)

get_odds_board

none

Next DraftKings Sportsbook (NJ) prices across leagues

get_sandbox_odds

none

Keyless sandbox reads, rate-limited per IP (rolling out: until /api/v1/sandbox is live it says so)

create_free_key

none

Free key for the user's own email (rolling out: until POST /api/v1/agent/signup is live it links the sign-up page)

get_odds

free key

Stored DraftKings (via ESPN) odds by league, market, event; fresh_only on by default

search_events

free key

Team-name search returning event ids

get_line_history

free key

Retained price changes for an event or offer

get_pickem_lines

free key + source

PrizePicks, Underdog, Pick6 (draftkings) or FanDuel thresholds

get_fanduel_markets

free key + fanduel

FanDuel native game markets

A successful keyed call uses one credit; failed calls use none. Errors come back as tool errors with the API's own next step (for example the daily limit and its Retry-After).

Example

Real output from get_public_board with {"sport": "nfl"} on 15 Nov 2026 (rows trimmed):

nfl board available DraftKings via ESPN 2026-11-15T05:50:02.275Z rows 24
  Miami Dolphins @ Indianapolis Colts moneyline away null 180 2026-11-15T05:37:38.309Z
  Miami Dolphins @ Indianapolis Colts moneyline home null -218 2026-11-15T05:37:38.309Z
  Miami Dolphins @ Indianapolis Colts spread away 4.5 -112 2026-11-15T05:37:38.309Z

Prompts that work: "What are tonight's NBA moneylines on DraftKings, and when were they captured?", "Show Underdog's lines for the next NFL game", "Has the Lions spread moved today?" (needs a key).

Develop

npm install
npm test          # offline: mocked fetch plus an in-memory MCP client
node server.mjs   # stdio

server.json is the MCP Registry entry (com.getoddsapi/getodds).

GetOdds is an independent developer product, not affiliated with any sportsbook. Operated by Stunning Couches LLC. MIT licensed.

Available Tools

9 tools
create_free_keyCreate a free GetOdds key by emailA

Create a free-tier key (1,000 requests a UTC day, 60 a minute, no card) for the user's own email address. Only call this when the user asked for a key and gave their email. The key is shown once: tell the user to store it as GETODDS_API_KEY. Depends on POST /api/v1/agent/signup.

Inputs: email (required), use_case, agent_name.

get_fanduel_marketsFanDuel native game marketsC
Read-only

FanDuel native markets and selections by league. Filters keep FanDuel exact case. The key needs the fanduel source and FanDuel selected as a bookmaker in the dashboard.

Inputs: limit, league.

get_line_historyRetained price changes for an event or offerA
Read-only

Retained price changes for one event_id or offer_id (DraftKings via ESPN). Not a complete tick history: it holds the changes GetOdds captured.

Inputs: limit, market, event_id, offer_id.

get_oddsStored sportsbook oddsB
Read-only

DraftKings (via ESPN) stored game odds by league and market. Set fresh_only to drop rows not captured recently. One credit per successful call.

Inputs: limit, sport, market, offset, +2 more.

get_odds_boardMixed upcoming-games odds board (no key)B
Read-only

The next DraftKings Sportsbook (New Jersey) prices across leagues, as shown on the getoddsapi.com homepage. No API key, no credits.

Inputs: no named parameters.

get_pickem_linesPick'em player linesA
Read-only

Player prop thresholds from PrizePicks, Underdog or DraftKings Pick6 (source=draftkings), or FanDuel. Lines only; pick'em boards have no per-line odds. The key must have the source granted.

Inputs: limit, source.

get_public_boardPublic odds board for one sport (no key)A
Read-only

DraftKings moneyline, spread and total prices (read through ESPN odds data) for one sport, with the capture time of every row. No API key, no credits; cached up to five minutes, so check observed_at before treating a price as current.

Inputs: sport (required).

get_sandbox_oddsKeyless sandbox odds (no key)A
Read-only

Keyless sandbox read of stored odds for trying request shapes before signing up. Rate-limited per IP. Depends on the /api/v1/sandbox endpoints; if they are not live yet the tool says so and suggests get_public_board.

Inputs: limit, sport, market.

search_eventsSearch events by team nameA
Read-only

Literal, case-insensitive team-name search over retained events. Returns source-specific event ids for get_odds and get_line_history.

Inputs: q (required), limit, sport.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation3/5

    Several tools return odds (get_public_board, get_odds_board, get_odds, get_sandbox_odds), and their boundaries depend on auth, caching, or source rather than a clean resource split. Descriptions help, but an agent could still misselect among them. Source-specific tools and event/history/key tools are more distinct.

    Naming Consistency5/5

    All tool names use snake_case with a consistent verb_noun pattern (get_*, create_*, search_*). The generic get_odds is still readable and fits the convention.

    Tool Count5/5

    Nine tools is well-scoped for an odds API and each maps to a recognizable capability area. The main issue is semantic overlap, not excessive or insufficient count.

    Completeness4/5

    The surface covers public/stored odds, event search, line history, pick'em lines, FanDuel markets, sandbox access, and key creation. Minor gaps include no league/sport/source discovery and no key management or revocation, but core read workflows are present.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Flash Props API

      iFan6oy
      A
      license
      A
      quality
      B
      maintenance
      Live sports betting player props MCP server covering NBA, MLB, NFL, NHL, NCAA, and soccer. Unified from real sportsbooks into one REST API and a real MCP server (Streamable HTTP). Free tier, no card required.
      5
      MIT

    • propzapi

      paperandbeyond23-gif
      A
      license
      Not graded
      quality
      C
      maintenance
      Props-first sports odds API with a hosted MCP server. Live odds and player props (moneyline, spreads, totals) across US sportsbooks, normalized to JSON. Tools: get_odds, get_props, get_events, get_books. API-key auth, free tier.
      MIT No Attribution

    • parlayapi-mcp

      JacobiusMakes
      A
      license
      A
      quality
      B
      maintenance
      Enables MCP-compatible clients to access sports betting odds, player props, prediction markets, live previews, coverage checks, and ParlayAPI account signup through native tools.
      22
      42 PyPI
      1
      MIT
    • novigapi-mcp

      novigapi-mcpofficial

      novigapi
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to access live sports betting market data, including markets and order books, player props, line history, fair prices, closing-line value, +EV and arbitrage comparisons, and devig calculations.
      MIT