get_matchups
Fetch ESPN Fantasy Basketball matchups and scores for any league, season, and scoring period, with home and away teams listed.
Instructions
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
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_matchups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| swid | No | ||
| year | No | ||
| espn_s2 | No | ||
| league_id | No | ||
| scoring_period | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |