Skip to main content
Glama
dylancharris

ESPN Fantasy Basketball MCP Server

by dylancharris

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ESPN_S2NoESPN authentication cookie for private leagues (optional for public leagues)
ESPN_SWIDNoESPN SWID cookie for private leagues (optional for public leagues)
ESPN_YEARNoSeason year (optional, defaults to current year)
ESPN_TEAM_IDNoYour team ID in the league (optional, used by several tools)
ESPN_LEAGUE_IDYesESPN Fantasy Basketball League ID (required)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_league_teamsA

Get all teams in an ESPN Fantasy Basketball league.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    List of team dictionaries with id, name, location, record, etc.
get_team_rosterA

Get roster for a specific team in an ESPN Fantasy Basketball league.

Args:
    team_id: Team ID to get roster for (optional, uses ESPN_TEAM_ID env var)
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    scoring_period: Specific scoring period (optional)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with team roster including all players and their positions
get_free_agentsA

Get free agents/waiver wire players from an ESPN Fantasy Basketball league.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    size: Number of players to return (max 50, default 50)
    position_id: Filter by position ID (optional)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    List of available free agent player dictionaries
get_matchupsA

Get matchups/schedule for an ESPN Fantasy Basketball league.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    scoring_period: Specific scoring period to get matchups for (optional)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    List of matchup dictionaries with home/away teams and scores
get_nba_scheduleA

Get NBA schedule for a specific date.

Args:
    date: Date in YYYY-MM-DD format (optional, defaults to today)

Returns:
    List of NBA game dictionaries with teams, times, and details
get_draft_statusA

Get current draft status including all picks and progress.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with draft status, picks, and current state
should_i_bidA

Get recommendation on whether to bid for the current player being nominated.

Args:
    current_player_id: ID of player currently being nominated
    team_id: Your team ID (optional, uses ESPN_TEAM_ID env var)
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with bid recommendation, suggested amount, and reasoning
who_should_i_target_nextA

Get recommendation on which player to target/nominate next.

Args:
    team_id: Your team ID (optional, uses ESPN_TEAM_ID env var)
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with player recommendation and reasoning
analyze_my_draft_strategyA

Analyze your current draft strategy and spending patterns.

Args:
    team_id: Your team ID (optional, uses ESPN_TEAM_ID env var)
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with punt strategy analysis, spending summary, and recommendations
get_available_playersA

Get top available players for the draft with auction values.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    limit: Number of players to return (default 50)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    List of available player dictionaries with auction values and rankings
get_player_statsA

Get comprehensive player statistics for specified timeframe.

Args:
    player_id: ESPN player ID
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    timeframe: Time period - "season", "projections", "last_7", "last_30"
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with comprehensive player statistics across all categories
compare_playersA

Compare multiple players across statistical categories.

Args:
    player_ids: List of ESPN player IDs to compare
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    categories: List of categories to compare (optional, defaults to 9-cat)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with detailed player comparison and winner by category
analyze_trade_proposalA

Analyze a trade proposal using comprehensive statistical analysis.

Args:
    your_player_ids: List of player IDs you would trade away
    their_player_ids: List of player IDs you would receive
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    Dictionary with trade analysis, recommendation, and category impact
get_trending_playersA

Get players trending up or down in adds/drops for waiver wire intelligence.

Args:
    league_id: ESPN Fantasy Basketball league ID (optional, uses ESPN_LEAGUE_ID env var)
    year: Season year (e.g., 2025) (optional, uses ESPN_YEAR env var or defaults to 2025)
    direction: Trending direction - "up" or "down"
    limit: Number of players to return (default 20)
    espn_s2: ESPN authentication cookie for private leagues (optional, uses ESPN_S2 env var)
    swid: ESPN SWID cookie for private leagues (optional, uses ESPN_SWID env var)

Returns:
    List of trending player dictionaries with add/drop percentages and reasons

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dylancharris/espn-fantasy-basketball-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server