FantasyPros: Fantasy Advice

Get the authenticated user's synced leagues. Returns a compact summary per league: the league ``key`` (the id to pass to league-scoped tools), league/team names, host, size, scoring, and league-type flags.

get_leagues

Get NFL depth chart data by team or player. In season, each player's ecrRank is this week's expert consensus rank (the rest-of-season rank for a team on bye), the same number the FantasyPros Depth Charts page shows. Out of season it is the draft rank.

get_nfl_depth_charts

Check whether an NFL player is rostered or available across the user's leagues. Use this whenever the user asks if a player is owned, taken, available, on the waiver wire, or a free agent. Scans every team in each of the user's synced NFL leagues and reports, per league, which team owns the player (flagging the user's own team) or that they're an available free agent. This is NOT limited to the user's own roster — prefer it over get_roster for any ownership/availability question.

get_player_ownership

Get NFL stats for one or more players. Covers individual defensive players as well as offense. For IDP, solo and assisted tackles ARE returned, as `def_tackle` and `def_assist`, alongside `def_sack`, `def_int`, `def_ff` and `def_fr` — check the response before telling a user a defensive stat is unavailable. Tackles for loss, passes defended and QB hits are the ones genuinely absent. For IDP rows the `points*` fields are a generic default, not the league's scoring; the response says so in `instructions`. Never quote them as the player's fantasy points.

get_player_stats

Get leaderboard results for a stat category.

get_leaders

Get expert-consensus player projections (NFL or MLB) from FantasyPros. NFL rows include standard, half-PPR, and full-PPR points plus the per-position stat lines; MLB rows carry hitter or pitcher stat lines.

get_projections

Get one or all team rosters for an NFL or MLB league. With no selector, returns the authenticated user's own team. Pass team_id for an exact team-id match (it takes precedence over team_name), or pass team_name for an exact match (case-insensitive; no fuzzy matching). If you only have an approximate name, first resolve the exact one from get_league_settings (teams) — or from the available_teams list this tool returns on a miss. Pass all_teams=true to return every team; it cannot be combined with a team selector.

get_roster

Get team schedules and strength-of-schedule data. Strength-of-schedule exists for offensive positions and for team defenses (DST) only. IDP leagues have no per-defender SOS: a DST number describes how opposing offenses are expected to fare against that team's entire defense, and says nothing about an individual linebacker or edge rusher. Never answer a question about one IDP player with a DST schedule. The response echoes the effective SOS window (sos_window / per-team "weeks" label), the current week, and season_state (current_week is 0 in the offseason). Every team carries its bye_week, so pass all the teams in a lineup to check byes for any week, including a later one.

get_schedule_and_strength

Analyze league power rankings and playoff odds (NFL) or category rankings (MLB). NFL ranks and scores are horizon-dependent and the response says which horizon it used, in `horizon`, along with `total_teams`. Always state the horizon when quoting a rank or score, and never treat a team rank on one horizon as contradicting player rankings on another — a roster is legitimately ranked differently for rest-of-season than for dynasty. Every horizon is reachable on every league. The site shows Draft, Dynasty and Weekly as tabs regardless of league type, so you can always fetch the one the user is looking at: never tell a user you cannot access the dynasty (or weekly, or draft) view. If their number disagrees with yours, they are most likely reading a different tab — ask which, or re-fetch that horizon.

league_analyzer

Find suggested MLB waiver moves, or analyze a specific potential add. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

mlb_waiver_finder

Get current matchup status and win probability for a league (NFL). In an elimination (guillotine) league there is no opponent: the response has league_format="elimination" and gives every alive team's chance of being safe this week instead of a win probability.

matchup_analyzer

Rank the other teams in an NFL league by how well they fit a specific trade. Give the position the user would trade away, the position they want, or both. Returns partners best fit first, with the ranks behind each score. Call this before naming a trade partner: a viable partner is weak where the user is selling and strong where the user is buying, and the comparison is done here so it does not have to be reasoned out.

rank_trade_partners

Force an upstream roster resync for a league (completes inline). Use whenever the synced roster may be stale — e.g. the user says they just added or dropped a player on their league host, a waiver claim has since been processed, or a roster read disagrees with what the user reports. start_sit_assistant already resyncs automatically before acting; other tools read the roster as last synced.

resync_league

Get start/sit lineup recommendations for a league. NFL uses the FantasyPros start/sit advice endpoint. MLB uses the optimal lineup endpoint (getLeagueLineupJSON) and takes the first optimal hitter + pitcher lineups, diffed against the current roster. Only players already on the user's roster are evaluated. Free agents and other teams' players never appear, and a rostered player's expert-start percentage is not a comparison against them — to weigh starting a player the user does not roster, use get_player_comparisons instead. NFL advice is always for the league's current matchup week, reported as `nfl_week`. It is not advice for a later week: for "next week" or a named later week, use get_projections (weekly, that week, the roster's player_ids) and that week's byes instead. Returns status='league_not_found' when the league key is not recognized upstream, and status='no_data' when the league has no synced roster data — never treat those as a real (empty) lineup. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

start_sit_assistant

Analyze a specific fantasy trade (NFL or MLB). Evaluate the trade by dynasty power-ranking change in dynasty leagues and rest-of-season change in all other leagues (the NFL response's default_* fields already pick the right one); weekly change is context only, never the primary metric. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

trade_analyzer

Get top trade suggestions from FantasyPros Trade Finder (NFL). All filters combine: give-side (player_trade_away, position_trade_away) and get-side (player_trade_for, position_trade_for) narrow to their intersection, so "send a TE, get an RB" is one call with both set. The response echoes `filters_applied`; if it comes back with an error saying nothing matched, that is a real empty result — no filter was silently dropped, so do not re-run with fewer filters and present the wider result as though it answered the question. Suggested gains are rest-of-season power-ranking changes. Evaluate trades by dynasty power-ranking change in dynasty leagues (run trade_analyzer on top candidates to get it) and rest-of-season change in all other leagues; weekly change is context only, never the primary metric. The league is resynced and trades are computed from current rosters on every call, so there is no need to call resync_league first. Every finder_ value (gains and before/after scores) comes from Trade Finder's own computation and can differ from the site's Trade Analyzer. When quoting exact power-ranking numbers to the user, run trade_analyzer on that trade and quote its numbers — for rest-of-season as well as dynasty. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

trade_finder

Analyze a specific waiver move. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

waiver_analyzer

Find top waiver recommendations for a league (NFL). `data_source` names which upstream answered. With "getWaiverPlan" (the normal path) each recommended add carries priority_value — the upstream recommendation strength used for ordering: in FAAB leagues it is the suggested bid in dollars (mirrored as "FAB Bid"), otherwise a relative waiver priority. With "waiverFinder" the league's host does not support the automated waiver plan, so the response is a ranked candidate list instead: rows carry recommendation_score and expert_agreement, and there is NO priority_value and NO "FAB Bid" because bid and pending-claim data cannot be retrieved for that host. A `limitations` list spells this out — relay it, and never quote or estimate a bid on that path. Premium feature (any paid tier). On a plan without it, the response returns status='premium_required' instead of results. If so, tell the user this feature is not included in their current plan.

waiver_finder