Skip to main content
Glama
fanduelapi-mcp

fanduelapi-mcp

fanduelapi-mcp

MCP server (stdio) for FanDuel API: FanDuel Sportsbook player props, line moves, game lines, +EV and arbitrage for Claude Desktop, Claude Code, Cursor, Codex, Windsurf, VS Code and any MCP client.

It is a small relay with no dependencies: each JSON-RPC message from your client goes to the hosted server at https://fanduelapi.com/api/mcp with your key, and the reply comes back on stdout. Use it when your client only speaks stdio; clients that support remote servers can use the URL directly (https://fanduelapi.com/mcp).

FanDuel API is an independent data service operated by Stunning Couches LLC. It is not affiliated with, endorsed by or sponsored by FanDuel.

Use it

Free key, no card: https://fanduelapi.com/sign-up. Without a key the keyless tools still work.

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

{
  "mcpServers": {
    "fanduelapi": {
      "command": "npx",
      "args": ["-y", "fanduelapi-mcp"],
      "env": { "FANDUEL_API_KEY": "fd_..." }
    }
  }
}

Claude Code:

claude mcp add fanduelapi --env FANDUEL_API_KEY=fd_... -- npx -y fanduelapi-mcp

Codex (~/.codex/config.toml):

[mcp_servers.fanduelapi]
command = "npx"
args = ["-y", "fanduelapi-mcp"]
env = { FANDUEL_API_KEY = "fd_..." }

Then ask, for example: "Which NBA points props on FanDuel moved most in the last hour?" or "Show FanDuel prices above the fair price tonight."

Related MCP server: parlayapi-mcp

Tools

The tool list comes from the hosted server, so it stays current. On 15 November 2026 it was:

  • No key: search_docs, fetch_doc, search, fetch, get_sample_props, describe_signup, start_signup, finish_signup, get_onboarding_questions, send_feedback.

  • With a key: list_props, line_move, prop_history, recent_changes, odds_board, game_report, positive_ev, arbitrage, compare_books, list_events, watches, onboarding and subscription tools.

Check it with no key:

printf '%s\n' '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_sample_props","arguments":{"sport":"nba"}}}' | npx -y fanduelapi-mcp

Settings

Variable

Default

Meaning

FANDUEL_API_KEY

none

Your key. Sent as Authorization: Bearer.

FANDUEL_MCP_URL

https://fanduelapi.com/api/mcp

Upstream server.

FANDUEL_MCP_TIMEOUT_MS

60000

Per-request timeout.

Calls spend credits like REST calls do; see https://fanduelapi.com/credits. When a plan's month runs out, the tool result says so with a one-click link for the person; the server never buys anything.

Tests

npm test                    # against a local fake upstream
FANDUEL_LIVE=1 npm test     # also checks the hosted server's keyless tools

License

MIT

Available Tools

29 tools
answer_onboardingA

Answer the onboarding questions for your user, from what you know about their project. Ask them what you do not know; never guess. Answering again replaces the answers; the same answers twice change nothing. Your user sees them on their dashboard, marked as answered by their agent. Costs no quota.

Inputs: answers (required), client.

arbitrageA

Arbitrage across FanDuel, DraftKings and Novig: two sides of one market at different venues whose prices guarantee a profit, with stakes that pay the same either way. type=middles finds middles (two lines with a window where both legs win). Use it for "any arbs on tonight's NBA games?". Developer plan and up; Free gets a short labelled sample and the upgrade link. A default call costs 5 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), type, books, limit, +4 more.

cancel_subscriptionA

Cancel your user's paid plan at the end of the current billing period. Only call this when your user asked to cancel. A reason is required: ask your user why they are cancelling and pass their answer; never pick a reason for them. Reasons: got_what_i_needed (I got the data I needed), too_expensive (Too expensive), missing_data (Missing data or features I need), reliability (Errors or slow responses), not_using (Not using it enough), switched (Switched to another service), other (Something else). "other" needs a comment. keep_subscription undoes it. Costs no quota.

Inputs: reason (required), client, comment.

compare_booksA

One FanDuel market next to the same market elsewhere: the Novig fair (no-vig) price, the DraftKings price and the PrizePicks line, with FanDuel's EV against the fair price and the better sportsbook price per side. Use it for "how does FanDuel's line on compare?" or "is FanDuel's total off market?". Covers player props and game lines. Free plan: five minutes behind. A default call costs 3 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), limit, league, offset, +3 more.

create_watchesC

Create one of your Watches.

Inputs: stat (required), player (required), user_request (required), line, +1 more.

delete_watchesB

Delete one of your Watches. Cannot be undone, so confirm with your user first.

Inputs: id (required), user_request (required).

describe_signupC

What agent signup needs and its limits. No key.

Inputs: no named parameters.

fetchC

Fetch one FanDuel API doc by id from search. The fetch shape ChatGPT connectors use. No key.

Inputs: id (required).

fetch_docA

Read one doc from search_docs in full, by id or URL. No key.

Inputs: id (required).

finish_signupA

Collect the key after your user approves the email. Poll every interval seconds. The key is returned once: store it as FANDUEL_API_KEY.

Inputs: device_code (required).

game_reportA

Everything for one game in one call: game lines for every period, every player prop with its move since open and FanDuel's alternate ladder for it, a count by stat and the biggest movers. Use it for a weekly betting report or a research note on one game ("full odds and player props for Chiefs vs Bills"). Find the event_id with list_events or odds_board. A default call costs 8 credits (table: https://fanduelapi.com/credits).

Inputs: event_id (required), user_request (required).

get_onboarding_questionsA

The questions that finish setting up your user's account, with their ids and options. With a key, also the answers already given. Costs no quota.

Inputs: no named parameters.

get_sample_propsA

Up to 10 real FanDuel player props, delayed like the free plan, so you can check fit before signup. No key.

Inputs: stat, limit, sport, player.

get_subscriptionA

Your user's plan and subscription status, including a scheduled cancellation, and the reasons cancel_subscription accepts. Costs no quota.

Inputs: no named parameters.

get_watchesC

Read one of your Watches by id.

Inputs: id (required), user_request (required).

keep_subscriptionA

Undo a scheduled cancellation, so your user's plan renews as normal. Only when your user asks. Costs no quota.

Inputs: no named parameters.

line_moveA

How a prop moved from open to now. Use it to answer "has 's line moved?" or "which way is the money going?". Give a prop_id for one prop, or a player (optionally stat or event_id) for all of that player's props. Returns open and current line and prices, line_move in stat units, line_direction, fair_over_move_pp (no-vig over probability shift in percentage points), price_direction and move counts. A default call costs 3 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), stat, player, prop_id, +1 more.

list_eventsA

Upcoming and live games FanDuel lists, with each game's event_id, start time, in-play flag and how many props it carries. Use it to find a game before calling list_props with event_id. Filter by sport or league. A default call costs 1 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), limit, sport, league, +1 more.

list_propsA

Current FanDuel player prop lines and prices. Use it to answer "what is the line for ?" or to scan a game or league board. Each prop has line, over and under prices in American and decimal odds, status, and a move summary from open. Filter by player, stat, sport, league or event_id. A default call costs 3 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), stat, team, limit, +7 more.

list_watchesC

List Watches. A player prop you track, with the line or price move that should alert you.

Inputs: user_request (required), limit, offset.

odds_boardA

The odds board: every game of a league with its game lines (moneyline, spread, total) in one call, grouped by game. Use it instead of reading games one at a time: "what are tonight's NBA lines?", "show me every NFL spread this week". Pass date (US Eastern YYYY-MM-DD) for one day, market_type for other families (comma list, or all), and changed_since (an ISO time such as the last call's meta.as_of) to get only markets that moved. With no sport or league it reads the league with the most open game lines. A default call costs 4 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), date, limit, sport, +4 more.

positive_evA

+EV bets: FanDuel prices that pay more than the fair chance, measured against the Novig exchange's no-vig price for the same side and line. Use it for "what are the best +EV FanDuel bets right now?" or "is there value on points?". Each row has the FanDuel price, the fair probability and price, ev_pct, edge_cents, Kelly stakes, main_line and confidence. books=fanduel,draftkings adds DraftKings prices. Free plan: top 10, five minutes behind. A default call costs 3 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), sort, books, limit, +8 more.

prop_historyA

Every recorded state of one prop, oldest first: each line move, price move and suspension with its time, plus the move summary. Use it after list_props or line_move when you need the full path, not just open and current. A default call costs 10 credits (table: https://fanduelapi.com/credits).

Inputs: prop_id (required), user_request (required).

recent_changesA

The change feed: every new prop, line move, price move and status change after a cursor, oldest first. Use it to keep up with the market without rereading the board. Start with since "now" (no rows, just the cursor to poll from) or 0 (the last 24 hours), then pass back meta.next_cursor each time. Optional league filter. A default call costs 1 credits (table: https://fanduelapi.com/credits).

Inputs: user_request (required), limit, since, league.

search_docsA

Search the FanDuel API docs, guides and answers. No key. Returns ids for fetch_doc.

Inputs: query (required).

send_feedbackB

Tell the team what is missing or wrong. The team reads every one. Costs no quota.

Inputs: kind (required), message (required), contact.

start_signupA

Start a key for your user. Ask them for their email and what they are building; never guess. They approve an emailed link (signing in first if the email already has an account); then call finish_signup.

Inputs: email (required), use_case (required), ref, agent, +1 more.

update_watchesC

Change fields on one of your Watches.

Inputs: id (required), user_request (required), line, note, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 29 tools

    Disambiguation3/5

    Most tools target distinct resources (props, events, line history, EV, arbitrage, watch CRUD, billing), but there are outright duplicates: search_docs vs search and fetch_doc vs fetch are functionally the same pair, differing only in 'shape'. There is also mild overlap between list_events, odds_board and game_report (all can surface games/lines), so an agent must read descriptions carefully to pick correctly.

    Naming Consistency3/5

    The dominant pattern is snake_case verb_noun (list_watches, get_subscription, cancel_subscription), but a substantial second family of bare-noun analytics names exists (line_move, prop_history, recent_changes, odds_board, game_report, positive_ev, arbitrage) plus bare verbs (search, fetch). Within-set pluralization is also odd (create_watches/get_watches vs get_subscription), so conventions are mixed though still readable.

    Tool Count2/5

    At 29 tools this is a heavy surface for an odds API, and a meaningful share is not earning its place: two doc-search aliases, a three-step signup flow, and a separate cancellation trio. The domain is broad (odds data + billing + onboarding), but the set could be trimmed toward the 15-20 range without losing capability.

    Completeness4/5

    Coverage is strong: docs search, discovery (events/odds board/game report), prop data with history and change feed, analytics (EV, arbitrage, book comparison), watchlist CRUD, signup and subscription lifecycle, feedback and onboarding. Gaps are minor — no endpoint for enumerating stat types, players/teams, or managing watch notification delivery — and are workable around via existing filters.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • 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
    • 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
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to access FantasyPros data through tools for injury news, player lookup, consensus rankings, and projections.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Official MCP server for the SportsGameOdds API. Query live and pre-match odds, scores, player props, results and settlement across 85+ sportsbooks and 67+ leagues, with endpoint discovery, documentation search and usage monitoring built in.
      1,031 npm
      2
      Apache 2.0