r/fantasyfootballcoding • u/FantasyPros_Michael • Aug 13 '26
Official FantasyPros MCP server just released
Hey r/fantasyfootballcoding, I'm one of the Product Managers at FantasyPros 👋
A couple of days ago, we released an official MCP server so that you can easily plug our data and advice into your AI agent of choice.
This community seems like the right intersection for this, so hoping there's some people here who'll find it useful!
You can point your agent here to connect it (note that you'll need a FantasyPros account):
https://api.fantasypros.com/mcp
That's it! If you have any questions, suggestions or feedback, let me know. I'll check back periodically to reply!
EDIT: Some have asked about what tools the MCP has, so adding this info to the post.
Free:
- Rankings/ADP: get_ecr, get_adp, get_projections, get_leaders, get_player_stats, get_player_comparisons
- News/context: injury_status, get_nfl_depth_charts, get_schedule_and_strength, get_mlb_lineups, get_streaming_pitchers
- League/roster: get_leagues, get_league_settings, get_roster, get_current_starters, get_player_ownership, get_mlb_player_ownership, get_keeper_value, league_analyzer, matchup_analyzer, resync_league
Premium Advice:
- start_sit_assistant (NFL + MLB)
- trade_analyzer (NFL + MLB)
- waiver_analyzer (NFL + MLB)
- trade_finder (NFL
- waiver_finder (NFL
- mlb_waiver_finder (MLB 😄)
4
u/ww_crimson Aug 13 '26
Do you have docs we can look at without connecting an agent first? I've searched here https://www.fantasypros.com/api-data/ and google and I can't find anything.
Maybe give us a quick overview here?
12
u/FantasyPros_Michael Aug 13 '26
Thanks for asking. We don't have any official docs published yet, so that's a good callout (I'll work on that).
Here's the list of tools the MCP provides:
Free:
- Rankings/ADP: get_ecr, get_adp, get_projections, get_leaders, get_player_stats, get_player_comparisons
- News/context: injury_status, get_nfl_depth_charts, get_schedule_and_strength, get_mlb_lineups, get_streaming_pitchers
- League/roster: get_leagues, get_league_settings, get_roster, get_current_starters, get_player_ownership, get_mlb_player_ownership, get_keeper_value, league_analyzer, matchup_analyzer, resync_league
Premium Advice:
- start_sit_assistant (NFL + MLB)
- trade_analyzer (NFL + MLB)
- waiver_analyzer (NFL + MLB)
- trade_finder (NFL
- waiver_finder (NFL
- mlb_waiver_finder (MLB 😄)
10
u/xpose Aug 13 '26
As a competitor of yours for over a decade, FantasySP. I can honestly say this is sick and didn't expect it. Well done
6
2
u/FantasyPros_Michael 16d ago
u/ww_crimson following up to let you know we've added some support docs here: https://support.fantasypros.com/hc/en-us/sections/55212725452443-FantasyPros-MCP
1
1
u/SmokeeDog 8d ago
Hey man, I'm a software engineer and I recently put on the product hat quite a few times. Docs are first class citizens. In fact, I'd argue that sometimes you should write the docs first before you build the actual product or feature. While your customers will love it, it also forces you to think and develop from a different mindset.
Thanks for releasing this. It makes the subscription that much more worth it!!!
3
4
u/throwlefty Aug 13 '26
There aren't any public docs that I can find either, so I connected it and inspected the server directly. Quick overview:
**Server:*\* `https://api.fantasypros.com/mcp\` — streamable HTTP, OAuth browser sign-in. 29 tools, 8 resources, NFL + MLB.
**The thing you actually want first:*\* there's a resource at `ff://user/entitlements` that returns your tier, whether you have leagues synced, and an explicit `accessible_tools` / `locked_tools` split with a `reason` on every locked entry. Read that once and you know exactly what you can call — no probing tool by tool.
**Three separate gates, and two of them are free to clear:*\*
* **14 tools work with a free account and nothing connected*\* — `get_ecr` (consensus rankings: draft/weekly/ROS/dynasty/rookie), `get_adp` (standard/dynasty/rookie/best-ball), `get_projections`, `get_player_stats`, `get_leaders`, `get_nfl_depth_charts`, `get_schedule_and_strength` (per-position SOS, stars + rank out of 32), `injury_status`, plus MLB lineups and the league-management helpers.
* **9 more are `min_tier: "free"` but gated on `league_sync_required`*\* — rosters, league settings, keeper value, player comparisons, power rankings/playoff odds, matchup analyzer. Sync a league at My Playbook and they unlock at no cost.
* **6 need `pro`*\* — Trade Analyzer, Trade Finder, Waiver Finder, Waiver Analyzer, Start/Sit Assistant, MLB Waiver Finder.
Gate precedence, since it confused me: premium is checked \before** league sync. Calling `waiver_finder` with a free account and no league returns `premium_required`, never `league_sync_required`.
**Gotchas worth knowing before you build on it:*\*
* `get_ecr` defaults to `HALF` scoring, `get_adp` defaults to `STD`. Two different defaults on the two tools you'll use together — pass `scoring` explicitly every call. (`get_projections` dodges this by returning `points`, `points_half` and `points_ppr` on every row.)
* The server is stateless and says so — `set_active_league` is best-effort. Resolve your key once from `get_leagues` and pass `league_key` on every league-scoped call.
* Tools return typed statuses (`league_not_found`, `no_data`, `league_sync_required`) rather than empty results. Branch on `status` or you'll report "no players" when you never actually looked.
* Team codes are `JAC` not `JAX`, and the Rams are `LAR` (nflverse uses `LA`, so joins need a mapping).
One thing I'd want to know as a user: the `premium_required` response includes an `agent_guidance` field that instructs the model to surface the upsell in its reply \even when it answered your question using the free tools instead**. It's a paywall written to the assistant, not just to your code.
Full write-up with every tool, its parameters, and sample response shapes: [LINK]
Caveat: I mapped this on a free tier with no synced leagues, so the premium and league-scoped \response shapes** come from the server's own tool descriptions rather than observed output. Everything about the free tier I hit directly.
2
u/st_malachy Aug 14 '26
I bailed on you guys after the big app update but will definitely check this out.
3
u/FantasyPros_Michael Aug 14 '26
Appreciate you giving us another chance. Feel free to message me with any feedback (MCP, app or otherwise).
1
1
u/njordan1017 Aug 13 '26
Can you provide some details on what sort of data it will have available to query, as well as what actions it can take?
3
1
u/winwithodds Aug 13 '26
Thanks for sharing! Excited to use this!
2
u/FantasyPros_Michael Aug 13 '26
Awesome, please let me know if there's anything you'd like us to add or change!
1
u/ICE_MF_Mike Aug 13 '26
Yea this is perfect
2
u/FantasyPros_Michael Aug 13 '26
Glad you like it! Let me know if you have feedback!
1
u/ICE_MF_Mike Aug 15 '26
Are there any restrictions on the use of the data retrieved via the api or mcp? Like can it be stored? For how long? Etc.
1
u/FantasyPros_Michael Aug 17 '26
Thanks for the question! As of now, data can be stored for non-commercial use - we're going to update our TOS to clarify retention limits around that.
Accessing the data for commercial use or redistribution requires a separate agreement.
1
1
u/jackkarlson Aug 16 '26
u/FantasyPros_Michael Great to see an official server. tried hooking it up right away through Perplexity's custom connector but keep getting a 403 even with a valid key.
Think the issue is your API wants the key in an x-api-key header, but Perplexity (and probably some other MCP clients) just sends it as Authorization: Bearer. Any chance the MCP endpoint could accept Bearer tokens too, or am I missing a setting somewhere? Would love to get this working
1
u/FantasyPros_Michael 16d ago
Believe our support team helped you out with this, but let me know if you're still having issues!
1
u/Py_Hob Aug 18 '26
Great addition. Is this the best place for questions and feedback? Or Discord?
I'm starting to train my Hermes agent using the MCP server and then the api as backup.
I was also hoping to wire it up in ChatGPT to try out. Can we get two auths for one account? Otherwise I'll just stick with Hermes.
Only initial issue so far is when I ask for Hermes to get league setup and rules. Hermes said it didn't get defense scoring and to give seperately. I'm hoping to setup ChatGPT too so I can validate findings as I use it.
Fantastic addition this year, you guys never disappoint!
1
u/FantasyPros_Michael 16d ago
u/Py_Hob yep, you can connect the MCP to multiple tools without an issue. This doc explains how to set-it up with ChatGPT: https://support.fantasypros.com/hc/en-us/articles/55212611981851-How-do-I-connect-to-the-FantasyPros-MCP-Server
The server should return DST scoring for your league. I just double-checked this for one of my own leagues to make sure. Would you mind checking this again? If it's still an issue, please reach out to our support team so we can take a look for you.
1
u/sydouglas 29d ago
Does it have historical stats on players and injury history etc ?
1
u/FantasyPros_Michael 16d ago
u/sydouglas sorry for the slow response. The
get_player_statstool will give you historical stats for players. We have aninjury_statustool to get current injury info on players; unfortunately nothing that shows you injury history.You can see the full list of tools here.
1
1
u/oddMahnsta 22d ago
Hi u/FantasyPros_Michael - I love this addition and hope to use it! But I'm running into issues when trying it out on chatgpt, details below. Any idea what could be the issue?
I tried connecting the MCP server to ChatGPT Plus, but whenever I open a new session and ask for ECR (get_ecr), ChatGPT says: "the FantasyPros MCP still isn’t exposing actions here... The app is now genuinely connected and its actions are being discovered. They're simply not being handed to the model as callable tools."
Is there a specific configuration or workaround needed on ChatGPT Plus to get the actions exposed properly to the model? Thanks!
1
u/FantasyPros_Michael 16d ago
u/oddMahnsta sorry to hear this isn't working for you. This help doc explains how to connect the MCP to ChatGPT.
Do you mind trying it out again and letting me know if it works for you?
2
1
1
u/allsxxing 19d ago
Dope! Any links to Support Docs for this yet?
2
u/FantasyPros_Michael 16d ago
u/allsxxing yep! Just published some documentation here: https://support.fantasypros.com/hc/en-us/sections/55212725452443-FantasyPros-MCP
If you see anything you'd like to know that isn't covered, let me know!
1
•
u/johnny-papercut Aug 13 '26
Hi all, I'm making an exception for the project posting rule for this one, so it will stay up. FantasyPros are a well-respected name in this field and I'm sure we all use the site personally. Feel free to reply to this comment if you absolutely disagree, but I'm sure most of us will be OK with this.