Win your draft. Dominate your season. With data, not gut feeling.
NFL MCP turns real NFL & fantasy data into a decisive edge — a suite of tools that plug straight into your AI assistant (Claude Desktop, Claude Code, Cursor, …). Ask a plain question, get a data-backed answer: who to draft, who to start, whether that trade is a fleece, and what your playoff odds really are — for your league, your roster, your pick, in real time.
This isn't another rankings site you tab away from mid-draft. It lives inside your assistant and answers the question you actually asked.
You: "I'm on the clock at 1.09 in my 12-team half-PPR draft — who do I take?"
🏈 NFL MCP: Jahmyr Gibbs (RB) — top value here (VBD 8787), and there's a value cliff at RB after him (−1995). Elite WRs are deeper, so lock the RB now and grab WR at the turn.
You: "Start Puka Nacua or DeVonta Smith this week?"
🏈 NFL MCP: Nacua — 18.7 projected (floor 11.6 / ceiling 25.8), ✅ high snap share, smash matchup. Start Nacua with confidence.
You: "Is trading my Bijan for their CeeDee + a WR2 fair?"
🏈 NFL MCP: Slightly favors you (fairness 82/100) — two startable pieces beat one stud for your thin WR room.
⚠️ You'd drop to 3 RB, so mind the depth.
Real tool outputs — value cliffs, projections with floor/ceiling, market-value trade fairness — rendered by your assistant.
🎯 Draft day
- VBD draft board ranked by value over replacement — the ordering that wins drafts, not raw ADP.
- Live "war room" — during your real Sleeper draft it reads the board live and calls the best pick for your roster, with value-cliff warnings and positional-run alerts.
- Rehearse first — run 100 mock drafts from your slot before you're on the clock.
📊 Every week
- Start/sit with automatic projections — no manual point entry.
value × matchup × Vegas game-script × usage × injury, with floor/ceiling and a transparent breakdown. - A real matchup edge — which defense a player actually feasts on, from real weekly results (not a stale rankings page).
- Streaming planner — the best DST / K / QB / TE to stream over the next 1-3 weeks (soft defense, weak opposing offense, strong own offense).
- Weather / wind — fade passing and kickers in the ugly-weather games (wind ≥ 15 mph), dome games flagged neutral.
🔄 Trades & waivers
- Trade analyzer on real market values — knows your league's exact format and flags a lopsided deal with evidence.
- FAAB bids — exactly how much to spend on that waiver breakout (market value + league demand + your budget).
🏆 Season strategy
- Monte-Carlo playoff odds — "72% to make it — 84% if you win this week." Real probabilities, not vibes.
- Strength of schedule — rest-of-season and playoff-week (15-17) difficulty per position, for stash and trade-deadline calls.
- Bye-week coordination, trade-deadline timing, opponent-weakness scouting.
- Real data, zero gut-feeling heuristics — market-consensus values (FantasyCalc), real weekly stats (nflverse), your live league (Sleeper), news & injuries (ESPN), weather (Open-Meteo). No paid API keys required to start.
- Honest about uncertainty — when it lacks live data it says so (and falls back transparently) instead of faking a confident call.
- It grades its own accuracy. A built-in backtest measures whether its projections actually beat a baseline on real past seasons, and a daily watchdog alerts if a data source changes. Most fantasy tools never check whether they're right. This one does.
docker run --rm -p 9000:9000 ghcr.io/gtonic/nfl_mcp:latestConnect it to your assistant, then just ask:
"My Sleeper username is
gary— find my league, build my draft board, and simulate a draft from my slot."
Claude Code (CLI):
claude mcp add --transport http nfl-mcp http://localhost:9000/mcp/Claude Desktop / Cursor — bridge via mcp-remote:
{
"mcpServers": {
"nfl-mcp": { "command": "npx", "args": ["-y", "mcp-remote", "http://localhost:9000/mcp/"] }
}
}Full setup, configuration and deployment → docs/TECHNICAL.md. Draft-day walkthrough → docs/DRAFT_DAY.md.
70+ MCP tools over HTTP, grouped by what they do. Every tool's full parameter reference lives in AGENT.md; below is the map.
🎯 Draft & player values
get_draft_board (VBD-tiered board) · recommend_draft_pick (best pick live) · simulate_draft (offline mock) · get_player_values / get_player_value (market consensus) · analyze_trade (fairness on real values) · get_league_drafts · get_draft · get_draft_picks · get_draft_traded_picks
📊 Weekly lineup & projections
project_player / project_players (transparent weekly points) · get_start_sit_recommendation · get_roster_recommendations · compare_players_for_slot · analyze_full_lineup
🗓️ Matchup, schedule & environment
get_defense_rankings · get_matchup_difficulty · analyze_roster_matchups · get_strength_of_schedule (ROS SOS) · get_playoff_sos (weeks 15-17) · get_streaming_options (DST/K/QB/TE streaming) · get_weather_forecast (wind/weather impact) · get_strategic_matchup_preview · get_vegas_lines · get_game_environment · analyze_roster_vegas · get_stack_opportunities
🏆 Season strategy & opponents
get_playoff_odds (Monte-Carlo) · get_season_bye_week_coordination · get_trade_deadline_analysis · get_playoff_preparation_plan · analyze_opponent
💸 Waivers & FAAB
get_waiver_wire_dashboard · get_waiver_log · check_re_entry_status · recommend_faab_bid
🏈 Your Sleeper league
get_league · get_rosters · get_league_users · get_matchups · get_playoff_bracket · get_transactions · get_traded_picks · get_trending_players · get_fantasy_context (aggregate) · get_nfl_state · get_user · get_user_leagues · fetch_all_players
🩺 Injuries & availability
get_injury_report · get_high_confidence_injuries (multi-source) · get_gameday_inactives
📰 NFL data & news (ESPN)
get_nfl_news · get_teams / fetch_teams · get_depth_chart · get_team_injuries · get_team_player_stats · get_nfl_standings · get_team_schedule · get_league_leaders
🧠 Coaching intelligence
get_coaching_staff · get_all_coaching_staffs · get_coaching_tree · get_scheme_classification
📈 CBS Sports
get_cbs_player_news · get_cbs_projections · get_cbs_expert_picks
👥 Players / athletes
fetch_athletes · lookup_athlete · search_athletes · get_athletes_by_team
🌐 Web & health
crawl_url (SSRF-guarded text extraction) · GET /health (REST)
- docs/TECHNICAL.md — setup, configuration, architecture, data sources, eval suite, CI/CD, security.
- AGENT.md — full per-tool reference for AI agents.
- docs/DRAFT_DAY.md — before/during draft-day playbook.
- SECURITY.md — security policy, SSRF protections, reporting.
- CHANGELOG.md — release history.
MIT — see LICENSE.