Flaim Fantasy

Use established session context (call get_user_session only if needed), and use this only when the user is clearly asking about a non-current season or an inactive league. This is the historical branch: it returns past seasons and historical leagues outside the current season view. Use for last season, older seasons, inactive leagues, or historical performance. All-time answers are scoped to seasons present in the response; an absent season may be unavailable even if provider history extends further. Sleeper coverage floor: Flaim follows the previous_league_id chain of each Sleeper league back at most 15 seasons including the current one and saves every season Sleeper still serves on it; Sleeper has run since 2017, so today that is the entire history of any Sleeper league. Sleeper seasons are discovered on connect and on refresh_leagues, so a league last synced under the earlier five-season limit needs one refresh before its older seasons appear here, and a season still missing after a refresh means Sleeper did not serve it on that walk, not that Flaim capped the history. thresholdYear is display bucketing, not a retrieval floor. Read-only.

get_ancient_history

Get players available to acquire in the specified fantasy league, optionally filtered by position. This is fantasy-league availability, not professional-contract status. Pass a requested count exactly from 1 through 100. For a request above 100, start compact inventory paging with offset 0 and count up to 100, then pass each returned pagination.nextOffset until the requested number is reached, endReached is true, or no nextOffset is returned. Inventory pages are live best-effort, not a point-in-time snapshot: availability can change while pages are fetched, so never promise an exact complete inventory, no duplicates, or no omissions. Inventory pages preserve provider order: ESPN roster rate, Yahoo overall rank, Sleeper trending then rank; Yahoo inventory pages are not globally market-rate sorted. Prefer the canonical fields: every response carries leagueId, seasonYear, position, count, ordering, capabilities, and ownershipScope; entries carry team (real-life club, null when none) and id (platform player id as a string, when supplied) on every platform, ESPN and Yahoo entries add acquisitionState ("free_agent", "waivers", or null when the platform cannot determine the subtype), and ESPN waiver rows may also add waiverClearsAt (ISO time). Yahoo waiver rows may instead add waiverDate as a YYYY-MM-DD calendar date with no time or timezone; never turn it into an exact clearance time. Legacy platform fields remain alongside for compatibility on ordinary ranked calls, while inventory pages intentionally return compact fields. Refer to leagues, teams, and players by name in answers; IDs are for tool calls only and must not be printed. ESPN always marks capabilities.acquisitionState true. Yahoo marks it true only when at least one returned entry has a known state; Yahoo entries still carry acquisitionState null when the flag is false. ownershipScope "platform_global" means percentOwned/percentStarted cover all leagues on that platform — never ownership within the selected league. An ESPN-wide started rate is never conditional on the player being rostered. Label every reported percentage as an ESPN-wide roster/start rate or Yahoo-wide market rate. Translate ownership scope silently into that provider-wide wording; never print the ownershipScope key, platform_global enum, or get_free_agents tool name. If capabilities marks rates unavailable, write "[Provider] market ownership rate: not provided"; do not print a missing response field name or null value, call get_players, or offer a lookup. When acquisitionState is null or not present, call rows "available players," never specifically free agents or waivers, and do not promise an immediate add. A returned player is already confirmed available in that league. acquisitionState is the provider-reported subtype, not a guarantee that a specific roster move is legal; do not promise an immediate add from it alone. Yahoo entries may add isKeeper as status, cost, and kept when Yahoo sends it; Yahoo has only been observed returning cost as false, so no numeric keeper cost is available from Yahoo. Use get_roster only when the current request separately asks who owns a player; never offer it after an available-player result. Do not include injuryStatus or any injury detail unless the user asks for it; when asked, verify current web evidence and translate provider codes into plain language. State acquisition status in plain language from acquisitionState ("a free agent", "on waivers"); never print raw codes — neither provider codes such as FREEAGENT or WAIVERS nor canonical values like free_agent verbatim. Use current web evidence before adding analysis or pickup recommendations. Use established session context (call get_user_session only if needed), then get_league_info for the selected league if this chat has not already loaded it; fan out once per league for comparisons. Requires authentication on ESPN/Yahoo; Sleeper uses the public API. Read-only. Current date is 2026-11-02. Hard stop: after satisfying a returned-list or field-explanation request, end the answer immediately after the requested facts. Remove every closing question or offer to do more work, including roster checks, lineup-fit checks, comparisons, rankings, recommendations, role or health analysis, trends, or outlooks; never append "if you want", "tell me which player", or a similar invitation unless the user's current request explicitly asks for that additional work.

get_free_agents

Use this when the user asks about completed draft results, exact draft-board positions, or current draft-pick ownership for a selected league. Returns a common draft summary and ordered picks with explicit confirmed, projected, or unavailable placement provenance. A historical selecting team is not a current pick owner; current ownership comes only from ownership.picks[].currentOwnerTeamId. ESPN and Yahoo expose confirmed draft results but no current pick-ownership ledger, so their responses carry no ownership block at all; only Sleeper can report current or future pick ownership, and an exact board placement only when Sleeper supplies enough draft-order evidence. An ownership.scope of changed_picks_only lists only picks known to have changed hands and is not a complete pick inventory. selectionInRound is the round slot rendered in a value such as 12.15, while draftColumn is the stable draft-board column; they are not interchangeable. For a completed Sleeper draft, an omitted ownership block means no draft picks changed hands. Use round to return one draft round. Use team_id to return completed selections made by that historical team and ownership rows currently owned by that team. Omit draft_id to use the league's associated draft; draft_id is Sleeper-only and should be passed only when Flaim previously returned a provider draft ID. Omit season_year for the current sport season, or pass the season_year returned by get_user_session for a specific league or past draft. Use established session context (call get_user_session only if needed), then get_league_info for the specified league if this chat has not already loaded it. For multi-league comparisons, call once per league. Read-only. Current date is 2026-11-02.

get_draft

Saves one of the user's kept asks ("Your asks") from the Flaim home page: adds a new ask, or edits the name and wording of one the user already kept, on the user's Flaim account. It is called by the Flaim home page and hidden from the model on hosts that support MCP Apps. It changes only the user's saved asks, never league data or anything on ESPN, Yahoo, or Sleeper.

save_flaim_home_ask

With session context established, call this once per league the first time this chat works with that league, before the requested standings, matchup, roster, free-agent, player, transaction, or draft tool, then reuse it for later questions about that league. A usable successful get_user_session result from earlier in this chat satisfies that prerequisite; do not repeat it just to satisfy this ordering. Skip it only when answering from session data alone or branching to get_ancient_history. This provides the baseline league context for analysis: league name, settings, scoring type, roster configuration, and team/owner context, plus schedule or season-window metadata when the platform provides it. Keeper and draft-format fields are additive and platform-dependent; never assume one provider's fields exist on another. ESPN adds keeperSettings (keeperCount, keeperCountFuture, keeperOrderType, keeperDeadlineDate) and isKeeperLeague when ESPN reports a keeper count, plus per-team keeperPlayerIds and futureKeeperPlayerIds as raw ESPN player IDs with no name resolution. Sleeper adds leagueFormat, whose typeRaw is an undocumented Sleeper convention that must not be read on its own as a redraft, keeper, dynasty, or guillotine signal, plus per-team keepers as raw Sleeper player IDs. When its settings request succeeds, Yahoo may add draftType, isAuctionDraft, canTradeDraftPicks, waiverType, waiverRule, waiverTime (days), postDraftPlayers, cantCutList, and maxWeeklyAdds; it also adds weeklyDeadline from league metadata. Yahoo statModifiers returns configured per-stat scoring values and may add bonuses as Yahoo's configured target/points rule pairs. These are league rules, not calculated player awards; do not infer whether a target is inclusive or whether multiple tiers stack. Yahoo's rule and deadline codes are raw provider values with no complete published code list: do not decode them, call weeklyDeadline a lock time, or infer that a particular move is legal. The settings fields are omitted, with a warning, when Yahoo's settings request fails. Yahoo exposes no keeper-cost rule. Sleeper futureDraftRounds describes the configured round count for future drafts; use get_draft.draft.rounds for the selected draft's actual round count. When fanning out across multiple leagues, call this once per league. The exact team fields vary by platform but all include ownerName. Use values from get_user_session. Read-only. Current date is 2026-11-02.

get_league_info

Loads sections of one league for the Flaim home page: standings, the user's current roster, the user's matchup for the current period, or the league's latest transactions, each as a small summary, plus the fuller matchup (both lineups or category rows, where the platform reports them) and full roster its team card shows. It is called by the Flaim home page and hidden from the model on hosts that support MCP Apps; for analysis use get_standings, get_roster, get_matchups, and get_transactions instead. Read-only: it reads from ESPN, Yahoo, or Sleeper through the same paths as those tools (football also reads ESPN's public NFL schedule for bye weeks and kickoff times), and results may be cached for a few minutes.

get_flaim_home_league

Get matchups/scoreboard for a specific week or the current week. Yahoo and ESPN head-to-head category leagues (Each Category and Most Categories), in baseball, basketball, and hockey, return per-category rows and a categoryScore of wins/losses/ties per side. On those leagues the side total is a category count or null rather than fantasy points. In a Most Categories league, categoryScore stays the per-category tally. On Yahoo (scoringTypeRaw "headone"), the side that wins more categories takes the single weekly result, and equal category wins is a tie. On ESPN (scoringType "H2H_MOST_CATEGORIES"), use the provider-reported matchup winner for that weekly result rather than deriving it; it can stay UNDECIDED mid-period. Before the provider reports a final winner, describe categoryScore and categories only as the current category lead, not the final weekly result. ESPN category rows include only the stats that league scores. ESPN football and Sleeper stay on fantasy points and do not return category rows. A null categoryScore, value, or result means the provider did not report it; never infer one. ESPN points matchups: totalPoints stays 0 until ESPN decides the matchup, so read each side's currentPoints for the score so far; winner stays UNDECIDED until then. Yahoo matchups: projectedPoints is the sum of each starter's pregame projection for the period. It does not add points as they are scored, so mid-period it routinely differs from points and can sit below the current score; that gap is expected and does not mean the data is stale or inconsistent. When liveProjectedPoints is present it is Yahoo's live projected final; prefer it. winProbability, when present, is Yahoo's estimated chance (0 to 1) that side wins. status reports upcoming, in_progress, or final; Yahoo's winner appears only when status is final. A missing optional field means Yahoo did not provide a usable value; never infer one. Sleeper returns no projection. Sleeper status reports upcoming, in_progress, or final for the requested week; in_progress lasts from before kickoff until Sleeper rolls to the next week, so it does not prove games have started. Sleeper's winner appears only when status is final; mid-week, points are the live score, not a result. Sleeper keeps every provider matchup record: scheduleShape reports "no_h2h_pairings" with reason "unknown" when numeric groups are present but none form an H2H pair, and "unpublished_or_unavailable" when there are no usable pairing IDs. When it has both pairs and unpaired records, it reports the unpaired count. A singleton has away:null and is never labelled a bye or used to infer league format. To request compact player scores for one selected matchup, use detail: "players" with an explicit week and team_id; this is currently ESPN football only and only for season_year 2018 or later. Any other platform, sport, or earlier season returns MATCHUP_DETAIL_UNSUPPORTED. Use established session context (call get_user_session only if needed), then get_league_info for the specified league if this chat has not already loaded it, so the model already knows the league's team names, owner/team mapping, and league context before interpreting the matchup. For multi-league comparisons, call once per league. Read-only. Current date is 2026-11-02.

get_matchups

Get season standings and outcome snapshot; includes verified season-outcome fields when available. Returns team records, rankings, and points summaries. The rank field is a standings sort position (1 = best): on ESPN it follows ESPN's playoffSeed order when every team has a unique valid seed; otherwise Flaim computes it from win percentage (a tie counts as half a win), with wins as the tie-breaker. On Sleeper it is computed by Flaim from wins, with points for as the tie-breaker; on Yahoo it is passed through from Yahoo's own standings API. It is NOT a verified postseason finish. For verified postseason outcome, use finalRank and championshipWon instead. Also returns seasonPhase (regular_season/playoffs_in_progress/season_complete), seasonComplete, and per-team outcome fields: finalRank, championshipWon, playoffOutcome, outcomeConfidence, madePlayoffs, playoffSeed. Outcome fields are null when not verifiable — do not infer championship from rank or team name. outcomeConfidence is 'explicit' when the platform reports final ranks, or 'derived' when the champion and runner-up were determined from the final winners-bracket matchup (ESPN historical seasons may omit final ranks); 'derived' only ever appears on ESPN — Yahoo always returns null here, and Sleeper returns 'explicit' for any completed season whose winners bracket names a champion, including when the finish came from the bracket rather than from reported placements; a tied championship game is resolved using the league's playoff tie rule (ESPN's default advances the higher seed). Note: playoffOutcome returns 'in_progress' on Sleeper for teams in active playoffs; ESPN and Yahoo return null for that state. ESPN may also include projected-rank fields. Every platform also returns waiverPriority (the team's current waiver-claim priority, 1 = first — this is the live priority, NOT get_transactions' waiver_priority, which is the priority some past claim used), and Yahoo and Sleeper add faabBalance (remaining free-agent budget; 0 means spent out, not unknown; on Sleeper it already reflects FAAB traded between teams, so it can exceed the league's starting budget). Either can be null (not applicable, or not reported by the platform — do not read null as proof the league lacks FAAB) and they are not mutually exclusive: a FAAB league may also report waiverPriority as its tie-breaker for equal bids. ESPN standings omit faabBalance entirely rather than returning null. Yahoo basketball Roto additionally returns each team's roto block: season stat values, Yahoo-reported per-category points, a separate overall totalPoints, and independent statsCoverage/pointsCoverage. These are season totals, not current-week or date scores. Raw ratio and percentage strings retain Yahoo's precision. Null means unknown, never zero; genuine zero and decimal points are preserved. The category rows can include display-only or unscored stats: do not infer the configured scoring categories from row counts, numeric point counts, or isDisplayOnly:false. Missing labels or metadata stay unknown. Category points are not category ranks; no category ranks, neighbor gaps or attainable gains are supplied or guaranteed. Use established session context (call get_user_session only if needed), then get_league_info for the specified league if this chat has not already loaded it, so team names and league context are already established. For multi-league comparisons, call once per league. For historical finish questions, call get_ancient_history first to discover seasons, then call this tool per season for verified outcomes. Read-only. Current date is 2026-11-02.

get_standings

Get league transaction activity: adds, drops, waivers, and trades. Completed activity is league-wide unless team_id is provided. For "my moves," pass the selected league's user team ID from get_user_session; session context alone does not filter completed activity. Use get_league_info when team and owner names are needed. Rows are newest first and capped by count; before claiming completeness, check window, limitations, warning, truncated (ESPN only), and dropped_invalid_timestamp_count (ESPN and Yahoo). ESPN week selects a matchup period, and its structured source covers failed bids, failed waiver claims with ESPN's failure_reason, withdrawn waiver claims and trade proposals (status canceled, from any team in the league, filed in the period they were made), standalone drops, and the trade lifecycle; a fallback can limit those types. Sleeper week selects a matchup week. Yahoo completed activity defaults to Flaim's rolling 30-day timestamp lookup. For older Yahoo completed activity only, pass both start_date and end_date as inclusive UTC calendar days, covering at most 366 days; use the Yahoo league_id for the requested season, since a range does not cross league seasons, and do not combine it with week, waiver, or pending_trade. Yahoo explicit ranges use one no-count collection response and filter locally, with a 2 MiB bounded read; limitations.upstream_completeness_unverified is always true because Yahoo does not guarantee that response is complete history. Default Yahoo team-filtered requests fetch one page of up to 100 league transactions before filtering; limitations.upstream_bound_reached means older matching rows inside the default window may be missing, and raising count will not recover them. Yahoo type=waiver and type=pending_trade return the authenticated user's own pending items with no timestamp window; team_id only narrows those items. Yahoo pending rows can omit timestamp and date until Yahoo stamps them. Read-only. Current date is 2026-11-02.

get_transactions

Opens the Flaim home: a full-page view of the user's connected current-season fantasy leagues (sport, league name, and team name) with starter questions. It is a UI entrypoint the user opens from the ChatGPT sidebar, hidden from the model on hosts that support MCP Apps. For league questions or the user's league list, use get_user_session instead. Read-only: it reads the same Flaim league records and saved defaults as get_user_session, and the asks the user kept, plus which Flaim home features are turned on for them, for the page to show (the asks are not part of this result's text), and changes nothing.

open_flaim_home