Retrieve a Sleeper user's profile by their username or user ID.

Args:

• identifier (string): The username (e.g. "john_doe") or numeric user ID (e.g. "12345678")

Returns: User profile including user_id, username, display_name, and avatar.

Examples:

• "Get user info for username 'sleeperuser'"

• "Look up user ID 123456789"

Get all fantasy leagues a user is in for a given sport and season.

Args:

• user_id (string): The Sleeper user ID (use sleeper_get_user to look up by username)

• sport (string): Sport to filter by (default: "nfl")

• season (string): Season year (e.g. "2024", "2025")

Returns: List of leagues including league name, ID, status, roster count, and scoring type.

Examples:

• "What leagues is user 123456 in for the 2024 season?"

• "Show all NFL leagues for user ID 987654321"

Fetch detailed information about a specific Sleeper fantasy league.

Args:

• league_id (string): The Sleeper league ID

Returns: Full league details: name, status, settings, scoring settings, roster positions, and more.

Examples:

• "Get details for league 123456789"

• "What are the scoring settings for this league?"

Get all rosters in a Sleeper fantasy league, including players, starters, and standings.

Args:

• league_id (string): The Sleeper league ID

Returns: All rosters with owner IDs, player lists, and win/loss records.

Examples:

• "Show me all rosters in league 123456"

• "What players does roster 3 have?"

Get all users (managers) in a Sleeper fantasy league with their team names and metadata.

Args:

• league_id (string): The Sleeper league ID

Returns: List of users with user IDs, display names, team names, and avatar IDs.

Examples:

• "Who are the managers in league 123456?"

• "List all teams in this league"

Get all matchups for a specific week in a Sleeper fantasy league.

Args:

• league_id (string): The Sleeper league ID

• week (number): NFL week number (1-18 for regular season)

Returns: All matchups for the week: roster IDs, points, starters, and player scores.

Examples:

• "What are the matchups for week 5 in league 123456?"

• "Show me all scores for week 12"

Get the playoff winners bracket (championship bracket) for a Sleeper fantasy league.

Args:

• league_id (string): The Sleeper league ID

Returns: Bracket structure showing playoff matchups, rounds, and results.

Examples:

• "Show me the playoff bracket for league 123456"

• "Who won the championship in this league?"

Get the consolation/toilet bowl (losers bracket) for a Sleeper fantasy league.

Args:

• league_id (string): The Sleeper league ID

Returns: Losers bracket structure showing consolation matchups and results.

Examples:

• "Show me the toilet bowl bracket for league 123456"

• "Who came in last place?"

Get all transactions (trades, waiver claims, free agent adds/drops) for a specific round/week in a league.

Args:

• league_id (string): The Sleeper league ID

• round (number): The transaction round (corresponds to NFL week number)

Returns: List of transactions with type (trade/waiver/free_agent), adds, drops, traded picks, and status.

Examples:

• "What trades happened in week 8 in league 123456?"

• "Show all waiver claims for round 3"

Get all traded draft picks in a Sleeper fantasy league (across all seasons).

Args:

• league_id (string): The Sleeper league ID

Returns: All traded picks with season, round, original owner, and current owner.

Examples:

• "What draft picks have been traded in league 123456?"

• "Which future picks does roster 3 own?"

Get all drafts a user has participated in for a given sport and season.

Args:

• user_id (string): Sleeper user ID

• sport (string): Sport (default: "nfl")

• season (string): Season year (e.g. "2024")

Returns: List of drafts with draft ID, type, status, and league ID.

Examples:

• "What drafts did user 123456 do in 2024?"

• "Show all NFL drafts for this user"

Get all drafts that have taken place in a Sleeper fantasy league.

Args:

• league_id (string): The Sleeper league ID

Returns: All drafts for the league with type, status, rounds, and timing.

Examples:

• "What drafts have happened in league 123456?"

• "Get the draft history for this league"

Get detailed information about a specific Sleeper fantasy draft.

Args:

• draft_id (string): The Sleeper draft ID

Returns: Full draft details: type, status, rounds, slot-to-roster mapping, draft order, settings.

Examples:

• "Show details for draft 987654321"

• "What type of draft is this and how many rounds?"

Get all picks made in a specific Sleeper fantasy draft, in order.

Args:

• draft_id (string): The Sleeper draft ID

• round_filter (number, optional): Filter results to a specific round only

Returns: All picks in pick order: round, pick number, player, position, team, and who picked them.

Examples:

• "Show all picks from draft 987654321"

• "What were the first-round picks?"

• "Who did roster 5 draft?"

Get all picks that were traded within a specific Sleeper draft.

Args:

• draft_id (string): The Sleeper draft ID

Returns: All traded picks: round, original owner roster, and current owner roster.

Examples:

• "What picks were traded in draft 987654321?"

• "Show pick trades from this draft"

Fetch the complete NFL player database from Sleeper (~5MB). Returns all player metadata. NOTE: This is a large dataset. Use filters to narrow results. Sleeper recommends caching this data and only fetching once per day.

Args:

• position_filter (string, optional): Filter by position (e.g. "QB", "RB", "WR", "TE", "K", "DEF")

• team_filter (string, optional): Filter by NFL team abbreviation (e.g. "KC", "SF", "DAL")

• active_only (boolean): Only return active players (default: true)

• search (string, optional): Filter by player name (case-insensitive substring match)

• limit (number): Max players to return (default: 50, max: 200)

• offset (number): Pagination offset (default: 0)

Returns: Paginated list of players with id, name, position, team, status.

Examples:

• "List all active QBs"

• "Find players on the Kansas City Chiefs"

• "Search for players named 'Patrick'"

Get trending NFL players on Sleeper based on recent add or drop activity.

Args:

• type (string): "add" for most added players, "drop" for most dropped players

• lookback_hours (number): Hours to look back for trend data (default: 24, max: 168)

• limit (number): Number of trending players to return (default: 25, max: 200)

Returns: List of player IDs with their add/drop counts, sorted by activity volume.

Examples:

• "Who are the most added players this week?"

• "Which players are being dropped the most today?"

• "Show me trending adds over the last 48 hours"

Retrieve the current NFL season state including the active week, season type, and season dates. Useful for knowing what week it is, whether we're in preseason/regular/postseason, and which season year is active.

Returns: Current week, season type (pre/regular/post), season year, season start date, display week.

Examples:

• "What week is it in the NFL?"

• "Is the NFL season currently active?"

• "What is the current NFL season year?"