sleeper-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SLEEPER_API_BASE_URL | No | API base URL | https://api.sleeper.app/v1 |
| SLEEPER_HTTP_TIMEOUT | No | HTTP timeout (seconds) | 30 |
| SLEEPER_STATE_CACHE_TTL | No | In-memory draft-state TTL (seconds) | 30 |
| SLEEPER_PLAYER_CACHE_TTL | No | Player cache TTL (seconds) | 86400 |
| SLEEPER_PLAYER_CACHE_PATH | No | Player cache file location (defaults to platform cache dir) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_leagueA | Fetch a Sleeper league's settings. Returns the league name, season, status, scoring settings (non-zero values only), starting lineup positions, bench/IR sizes and the league's draft_id. Args: league_id: The Sleeper league ID (numeric string). |
| get_rostersB | Fetch all rosters in a league with players resolved to names. Each team lists its starters (with slot assignments) and bench. Args: league_id: The Sleeper league ID (numeric string). |
| get_draftB | Fetch a Sleeper draft's metadata (type, status, rounds, team count). Args: draft_id: The Sleeper draft ID (numeric string). |
| get_draft_picksA | Fetch every pick in a draft, joined with player names and positions. Args: draft_id: The Sleeper draft ID (numeric string). |
| search_playersA | Search the cached NFL player database by name, team or position. Matching is fuzzy and case-insensitive (e.g. "josh allen", "Allen", "BUF", "QB"). Returns compact records with player_id, name, position, team and status. Args: query: Name fragment, team abbreviation, or position. limit: Maximum number of results (default 10). |
| get_playerA | Look up a single player by Sleeper player ID. Args: player_id: The Sleeper player ID (numeric string). |
| get_draft_stateA | Fetch the full normalized draft board for a Sleeper draft. This is the primary tool for live-draft assistance. It combines the league settings (scoring, starting lineup), the draft metadata, the team on the clock, recent picks, every roster with slot assignments, all drafted player IDs and position counts into one compact payload. Args: draft_id: The Sleeper draft ID (numeric string). |
| refresh_playersA | Force a refresh of the cached NFL player database from Sleeper. Normally unnecessary: the cache is valid for 24 hours and refreshed automatically when stale. Use after major roster moves or injuries if you suspect the cached data is wrong. Returns: Cache metadata: file path, fetch time, player count. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools target distinct resources and actions, and descriptions clarify the intended use of get_draft_state as a composite live-draft tool versus get_draft and get_draft_picks. There is some overlap because get_draft_state bundles draft metadata, recent picks, and drafted player IDs, so an agent may need to decide when the narrower get_draft/get_draft_picks tools are preferable.
All tool names follow a consistent snake_case verb_noun pattern: get_league, get_rosters, get_draft, get_draft_picks, search_players, get_player, get_draft_state, refresh_players. The convention is predictable throughout, with clear resource-oriented names.
Eight tools is well-scoped for a Sleeper fantasy football league/draft helper. Each tool has a clear role, and the set avoids unnecessary duplication or excessive surface area.
The surface covers the core fantasy football league and draft workflows: league settings, rosters, draft metadata, draft picks, player search/lookup, a live draft state aggregate, and cache refresh. Minor gaps remain around related league data such as matchups, standings, transactions, or user league discovery, but the primary draft-assistance purpose is well covered.