fanduelapi-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fanduelapi-mcp Which NBA points props moved most in the last hour?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpCodex (~/.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-mcpSettings
Variable | Default | Meaning |
| none | Your key. Sent as |
|
| Upstream server. |
|
| 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 toolsLicense
MIT
Available Tools
29 toolsanswer_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.
searchC
Search FanDuel API docs and answers. The search shape ChatGPT connectors use. No key.
Inputs: query (required).
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
Scored across 29 tools
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.
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.
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.
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
Related MCP Connectors
FanDuel Sportsbook player props, lines and prices as JSON, with every line and price move.
Live and prematch FanDuel odds, price drops and feed health. No key, no signup.
Sports Game Odds MCP — wraps the Sports Game Odds API (sportsgameodds.com)
Live odds, cross-book +EV and graded player-prop results across 37 books. Hosted endpoint included.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProps-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
- AlicenseAqualityBmaintenanceEnables MCP-compatible clients to access sports betting odds, player props, prediction markets, live previews, coverage checks, and ParlayAPI account signup through native tools.221MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to access FantasyPros data through tools for injury news, player lookup, consensus rankings, and projections.1MIT
- AlicenseNot gradedqualityCmaintenanceOfficial 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 npm2Apache 2.0