Report whether Yahoo Fantasy is set up and what the next step is. Use this for 'fantasy status'.

Begin or resume setup ('fantasy login' / 'fantasy start'). Shows how to create a Yahoo app if needed, and returns the authorization link once credentials are known. Optionally pass clientId/clientSecret to save them.

Complete setup using the verification code Yahoo displayed after the user approved access. Optionally also accepts clientId/clientSecret. On success it lists the user's leagues and sets a default automatically when there is only one.

Delete the saved Yahoo Client ID, Client Secret, and refresh token, then show the setup instructions again. Use this for 'fantasy logout' / 'fantasy disconnect' to reset and start over.

Set the default league (and your team in it) used when later commands omit keys. Use for 'fantasy choose team'.

List all fantasy leagues (and game weeks / stat categories) for the logged-in Yahoo account. Use this to discover league_key and team_key values.

Get a league's teams, settings, and current standings. Defaults to the configured league when leagueKey is omitted.

Get stats, standings, and matchups for every team in a league. Pass explicit teamKeys to limit the set, otherwise all teams in the league are fetched.

Get the league standings table — each team's rank, win/loss record, games back, playoff seed, and season category totals. This is the light way to see how teams stack up; use get_teams when you also need every team's full matchup history.

Get a team's roster for a date — each player's roster slot (starting position or BN/IL bench), starting status, injury status, and eligible positions, without any stats. Use this to see who is on the team and who is starting or benched. For per-date Yahoo stats use get_roster_stats; for advanced stats use analyze_roster_stats. Defaults to the configured team and today's date.

Get a team's roster with each player's Yahoo stats for a given date. Like get_roster but heavier — use get_roster when you only need slots/status, or analyze_roster_stats for advanced (Statcast/FanGraphs) stats. Defaults to the configured team and today's date.

Get a team's aggregated stats for a specific scoring week.

Get a team's aggregated stats for the whole season.

Get the league scoreboard (all head-to-head matchups). Pass a week to view a specific week, otherwise the current week is returned.

Get a team's matchups across the season, or only the listed weeks when weeks is provided.

Get stats for one or more players on a specific date. Player keys look like 431.p.10642.

Rank league players (including free agents) by a sort key. sort is a stat id or one of AR (actual rank), OR (overall rank), PTS. sortType scopes the ranking window. Use this to find waiver/free-agent targets. Returns up to 25 players per call; page with start.

List league players (including free agents) in ranked order with their name, position, eligible positions, status, and ownership (free agent or owning team) — but no stats. This is the light way to scan waiver/free-agent targets; once you have candidates, use analyze_player_stats or rank_players for their stats. sort is a stat id or AR / OR / PTS. Returns up to 25 players per call; page with start.

Find players by name (full or partial) and resolve them to player keys. This is the way to turn a name the user typed into the player_key that get_player_stats, analyze_player_stats, add_drop_player, and set_lineup need. Returns name, position, eligible positions, injury status, and ownership (free agent or owning team) — no stats. Optionally narrow by status (e.g. FA to only see free agents) or position (e.g. SP, OF, 2B). Returns up to 25 matches per call; page with start.

Return the stat categories used for scoring in this league (e.g. R, HR, RBI, SB, AVG for batting; W, ERA, WHIP, K, SV, HLD for pitching). Always call this before giving roster add/drop advice so recommendations reflect what actually scores in this league. Results are cached in config since categories rarely change after league creation. Pass leagueKey to force-refresh a different league.

Get recent transactions (adds, drops, trades) in a league. Pass teamKey to filter to a single team's transactions.

DESTRUCTIVE: modifies your real Yahoo roster. Adds a free agent, drops a rostered player, or does both at once. Provide addPlayerKey to add, dropPlayerKey to drop, or both for a simultaneous add/drop. Player keys look like 431.p.10642. Defaults to your configured team. Always confirm the players with the user before calling this.

DESTRUCTIVE: changes your real Yahoo roster positions for a given date. Provide assignments mapping each playerKey to a roster position (e.g. 1B, OF, SP, Util, or BN for bench). Players not listed keep their current slot. Defaults to your configured team and today's date. Confirm the lineup with the user before calling this.

Fetch and aggregate advanced statistics for a single player from multiple authoritative sources: MLB Stats API (standard stats), Baseball Savant (Statcast exit velocity / barrel rate / expected stats), and FanGraphs (WAR, wRC+, K%, BB%, plate discipline). The response includes the league's scoring categories so advice can focus on stats that actually count. Use this before making roster add/drop decisions.

Fetch advanced stats (Statcast, expected stats, FanGraphs) for a batch of rostered players. Accepts at most 10 players per call via playerKeys — callers should first use get_roster to retrieve all player keys, split them into batches of up to 10, and call this tool once per batch (calls can run in parallel). The response includes the league's scoring categories so advice targets stats that actually matter in this league (e.g. SB if stolen bases count, HLD if holds count). Combine with get_roster to see who is starting or benched.

List every probable starting pitcher across MLB for a date, with each one's opponent, home/away, and game start time (UTC). Sourced from the MLB Stats API (no Yahoo auth needed). MLB only posts probables for roughly today through ~2-3 days out, so 'tomorrow' returns a full board, the day after is usually partial, and dates further out return few or none (not yet announced — not an error). Set fantasyContext=true to also label each starter as yourTeam / otherTeam (with the owning manager) / freeAgent — useful for spotting streamable free-agent starters. Enrichment issues about one Yahoo request per starter (~10-26), so leave it off unless you need ownership.