Args:
        team_id: FPL team ID (required)
        gameweek: Gameweek number (defaults to current gameweek)
        
    Returns:
        Detailed team information including player details, captain, and value
    

    Args:
        gameweek: Gameweek number (defaults to current gameweek)
        
    Returns:
        Detailed team information including player details, captain, and value
        
    Note:
        This uses your authenticated team ID from the FPL credentials.
        To get another team's details, use get_team and provide a team_id.
    

    Args:
        team_id: FPL team ID to look up

    Returns:
        Manager information including history, name, team details, and leagues
    

    Unlike get_my_team, this uses the authenticated my-team endpoint, so
    it reflects pending changes and per-player purchase/selling prices.

    Returns:
        Current squad with prices, available chips, and transfer status
    

    Returns:
        Authentication status and basic team information
    

    Use this when authenticated FPL tools fail with an invalid/expired refresh
    token error. Ask the user to fetch a fresh token first: log in at
    https://fantasy.premierleague.com, open the DevTools Console (F12), run

        copy(JSON.parse(localStorage.getItem(Object.keys(localStorage).find(k=>k.startsWith('oidc.user:')))).refresh_token)

    (typing 'allow pasting' first if Chrome refuses), and paste the clipboard
    contents here. Copying the whole 'oidc.user:...' JSON value from DevTools ->
    Application -> Local storage works too.

    Args:
        refresh_token: The copied oidc.user JSON value (or just its
            refresh_token field)
        team_id: FPL team ID; omit to keep the currently stored one

    Returns:
        Whether the new token was stored and validated against the FPL API
    

    Args:
        team_id: FPL team ID (defaults to authenticated user)

    Returns:
        Manager info with leagues and performance stats
    

    Args:
        team_id: FPL team ID to look up
        limit: Maximum number of transfers to return (most recent first)

    Returns:
        Transfer history grouped by gameweek
    

    Args:
        league_id: ID of the league to fetch
        
    Returns:
        League information with standings and team details
    

    Returns visualization-optimized data for various types of league analysis.
    
    Args:
        league_id: ID of the league to analyze
        analysis_type: Type of analysis to perform:
            - "overview": General league overview (default)
            - "historical": Historical performance analysis
            - "team_composition": Team composition analysis
            - "decisions": Captain and transfer decision analysis
            - "fixtures": Fixture difficulty comparison
        start_gw: Starting gameweek (defaults to 1 or use "current-N" format)
        end_gw: Ending gameweek (defaults to current)
        
    Returns:
        Rich analytics data structured for visualization
    

    Args:
        player_id: FPL player ID (if provided, takes precedence over player_name)
        player_name: Player name to search for (used if player_id not provided)
        start_gameweek: Starting gameweek for filtering player history
        end_gameweek: Ending gameweek for filtering player history
        include_history: Whether to include gameweek-by-gameweek history
        include_fixtures: Whether to include upcoming fixtures

    Returns:
        Comprehensive player information including stats and history
    

    Args:
        query: Player name or partial name to search for
        position: Optional position filter (GKP, DEF, MID, FWD)
        team: Optional team name filter
        limit: Maximum number of results to return

    Returns:
        List of matching players with details
    

    Args:
        direction: Optional filter, "risers" or "fallers" (default: both)
        limit: Maximum number of players per direction

    Returns:
        Price risers and fallers with ownership and transfer momentum
    

    Returns:
        Detailed information about gameweek timing, including exact status
    

    Args:
        num_gameweeks: Number of upcoming gameweeks to check (default: 5)

    Returns:
        Information about blank gameweeks and affected teams
    

    Args:
        num_gameweeks: Number of upcoming gameweeks to check (default: 5)

    Returns:
        Information about double gameweeks and affected teams
    

    Args:
        player_name: Player name to search for
        num_fixtures: Number of upcoming fixtures to analyze (default: 5)

    Returns:
        Analysis of player's upcoming fixtures with difficulty ratings
    

    Args:
        entity_type: Type of entity to analyze ("player", "team", or "position")
        entity_name: Name of the specific entity
        num_gameweeks: Number of gameweeks to look ahead
        include_blanks: Whether to include blank gameweek info
        include_doubles: Whether to include double gameweek info

    Returns:
        Fixture analysis with difficulty ratings and summary
    

    Args:
        position: Player position (e.g., "midfielders", "defenders")
        team: Team name filter
        min_price: Minimum player price in millions
        max_price: Maximum player price in millions
        min_points: Minimum total points
        min_ownership: Minimum ownership percentage
        max_ownership: Maximum ownership percentage
        form_threshold: Minimum form rating
        include_gameweeks: Whether to include gameweek-by-gameweek data
        num_gameweeks: Number of recent gameweeks to include
        sort_by: Metric to sort results by (default: points; bootstrap
            names like total_points/goals_scored are accepted as aliases)
        sort_order: Sort direction ("asc" or "desc")
        limit: Maximum number of players to return

    Returns:
        Filtered player data with summary statistics
    

    Args:
        player_names: List of player names to compare (2-5 players recommended)
        metrics: List of metrics to compare (bootstrap names like
            total_points/goals_scored are accepted as aliases)
        include_gameweeks: Whether to include gameweek-by-gameweek comparison
        num_gameweeks: Number of recent gameweeks to include in comparison
        include_fixture_analysis: Whether to include fixture analysis including blanks and doubles

    Returns:
        Detailed comparison of players across the specified metrics
    

    Args:
        gameweek_id: Gameweek to fetch (defaults to the current gameweek)
        player_ids: Optional list of FPL player IDs to restrict the result to
        limit: Maximum number of players to return when player_ids is not given

    Returns:
        Live scores sorted by points, plus bonus-processing status
    

    Args:
        gameweek_id: Gameweek to fetch (defaults to the current gameweek)

    Returns:
        The dream team with player names, teams, positions, and points
    

    Combines FPL's own expected points (ep_next), form, points per game,
    and upcoming fixture difficulty into a transparent captain score.

    Args:
        team_id: FPL team ID (defaults to your authenticated team)
        gameweek_id: Gameweek whose squad to analyze (defaults to current)

    Returns:
        Squad ranked by captain score with per-component breakdown