Available Players
get_free_agents
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 return compact fields by default. For ESPN football inventory requests asking for scoring or injury details, set include_inventory_details true on every offset page. These are season totals and averages, not weekly projections; an absent injury status means unknown, not healthy. 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. 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.
Schema valid · SHA-256 1617354693bd…
View input schema
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"espn",
"yahoo",
"sleeper"
],
"description": "Fantasy platform — \"espn\", \"yahoo\", or \"sleeper\""
},
"sport": {
"type": "string",
"enum": [
"football",
"baseball",
"basketball",
"hockey"
],
"description": "Sport type (e.g., \"football\", \"baseball\")"
},
"league_id": {
"type": "string",
"description": "League ID (get from get_user_session)"
},
"season_year": {
"type": "number",
"description": "Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season)."
},
"position": {
"description": "Filter by position (e.g., \"QB\", \"RB\", \"SP\", \"C\"). Default: ALL",
"type": "string"
},
"count": {
"description": "Maximum players in this response (max: 100). For requests up to 100, pass the requested number exactly. For larger inventory requests, use at most 100 per offset page and reduce the final page to the remaining requested rows. Omit only when no number was requested (default: 25).",
"type": "number"
},
"offset": {
"description": "Opt in to inventory paging at this zero-based offset. Omit for the ordinary ranked list; use returned pagination.nextOffset to continue. Inventory pages are live best-effort, not a snapshot.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"include_inventory_details": {
"description": "ESPN football inventory pages (explicit offset) only: include league-scored actual season points and points per game, projected season points (not weekly projections), and recognized injury status. Ignored elsewhere; ordinary ranked ESPN lists already carry these fields. Missing injury status means unknown, not healthy.",
"type": "boolean"
}
},
"required": [
"platform",
"sport",
"league_id",
"season_year"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}