sleeper-mcp
This server provides read-only access to Sleeper NFL fantasy football data via MCP tools, covering users, leagues, rosters, matchups, transactions, drafts, player info, and NFL state.
Look up a user by username or user_id and retrieve their leagues for a specified season.
Get league details, rosters, users, traded picks, and drafts for a league.
Fetch weekly matchups and transactions (trades, waivers, free-agent adds/drops).
Get the current NFL season, week, and season type.
Get trending players based on add/drop activity, with configurable lookback and limit.
Resolve up to 100 player/defense IDs into names, teams, positions, and injury status, with caching and optional forced refresh.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sleeper-mcp Show me my Sleeper leagues for the 2024 season"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sleeper-mcp
MCP server exposing the read-only Sleeper NFL fantasy football API. The server uses stdio transport and supports Node.js 24 or newer.
Setup
npm ci
npm run buildRun the Vitest suite with:
npm testRun the build, Oxlint, Oxfmt, and Vitest checks with:
npm run checkApply automatic formatting with npm run format. The compiled MCP entrypoint is build/index.js.
Related MCP server: Sleeper MCP Server
Tools
Tool | Description |
| Look up one user by exactly one of |
| Get a user's NFL leagues for an explicit four-digit |
| Get details for one |
| Get league rosters and annotate player IDs when player data is available |
| Get public user and team metadata in a league |
| Get weekly matchups and annotate player IDs when available |
| Get trades, waivers, and free-agent transactions by round |
| Get traded picks, including future picks |
| Get the current NFL season, week, and season type |
| Get league drafts, newest first according to Sleeper |
| Get draft picks and any metadata supplied by Sleeper |
| Get recent add/drop trends with player names when available |
| Resolve up to 100 player or defense IDs into player metadata |
Successful tools return both text content and structured content. Invalid arguments, rate limits, timeouts, network failures, unexpected primary API response shapes, and oversized primary responses are returned as MCP tool errors. Optional player-name enrichment can degrade to a warning when the primary tool result is still available.
Use with MCP hosts
For local development, replace the path with this checkout's absolute path to build/index.js:
{
"mcpServers": {
"sleeper": {
"command": "node",
"args": ["C:\\path\\to\\sleeper-mcp\\build\\index.js"]
}
}
}For the published package, pin the desired version:
{
"mcpServers": {
"sleeper": {
"command": "npx",
"args": ["-y", "@luccabessa/sleeper-mcp@VERSION"]
}
}
}The server waits for MCP protocol traffic on stdin/stdout. Diagnostics are written only to stderr so stdout remains protocol-safe.
Player cache
Roster, matchup, and trending enrichment lazily loads the full NFL player database on first use.
Successful player data is cached in memory for 24 hours.
Concurrent cache misses share one request.
A failed refresh retains the last successful data and emits an explicit warning.
resolve_playersacceptsforce_refresh, but repeated forced refreshes are limited to once every five minutes.resolve_playersdeduplicates IDs and accepts at most 100 IDs per call.
Sleeper API usage
This server exposes only the NFL endpoints currently implemented by Sleeper's public read-only API.
No authentication is required.
Stay under Sleeper's general limit of 1,000 requests per minute.
The Sleeper API is free for non-commercial use; commercial use requires separate licensing.
Attribute Sleeper when redistributing or displaying trending-player data.
Refer to the official Sleeper API documentation for upstream endpoint behavior.
Available Tools
13 toolsget_draft_picksGet Draft PicksB
Get all picks in a draft. Player metadata (name, position, team) is included per pick.
Inputs: draft_id (required).
get_draftsGet DraftsB
Get all drafts for a league, sorted most recent to earliest.
Inputs: league_id (required).
get_leagueGet LeagueA
Get a specific league's details by league ID.
Inputs: league_id (required).
get_leaguesGet Leagues for UserB
Get all leagues a user belongs to for a given season.
Inputs: user_id (required), season.
get_matchupsGet MatchupsA
Get all matchups in a league for a given week. Teams sharing a matchup_id face each other. Player IDs are annotated with names.
Inputs: week (required), league_id (required).
get_nfl_stateGet NFL StateA
Get the current NFL season, week, and season type (pre/regular/post).
Inputs: no named parameters.
get_rostersGet RostersA
Get all rosters in a league. Player IDs are annotated with player names (which may not load if the player cache is warm).
Inputs: league_id (required).
get_traded_picksGet Traded PicksA
Get all traded draft picks in a league, including future picks.
Inputs: league_id (required).
get_transactionsGet TransactionsA
Get all transactions (trades, waivers, free agent adds/drops) for a league in a given week (round).
Inputs: round (required), league_id (required).
get_trending_playersGet Trending PlayersB
Get players trending based on add/drop activity.
Inputs: type, limit, lookback_hours.
get_userGet UserA
Look up a Sleeper user by username or user_id. Usernames can change over time, so store user_id for future lookups.
Inputs: user_id, username.
get_users_in_leagueGet Users in LeagueA
Get all users (and their display names/team names) in a league.
Inputs: league_id (required).
resolve_playersResolve PlayersA
Resolve a list of Sleeper player IDs (e.g. from rosters or matchups) into player names, teams, positions, and injury status.
Inputs: player_ids (required), force_refresh.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct resource/action: user lookup, leagues, rosters, matchups, transactions, drafts, and player resolution. Even similar-sounding tools like get_leagues vs get_league are clearly separated by scope (user-specific vs by ID). No overlapping purposes.
All tools follow a consistent verb_noun pattern in snake_case (get_* except resolve_players, which is still a clear verb_noun). The pattern is uniform and predictable across the entire set, making it easy for an agent to infer behavior.
13 tools is well within the ideal 3-15 range. Each tool serves a specific data retrieval need for the Sleeper fantasy football domain, and the set is neither sparse nor bloated.
The tool surface covers the core read-only workflows: user/league discovery, roster and matchup retrieval, transactions, drafts, and player resolution. The tools chain together cleanly (e.g., get_drafts feeds get_draft_picks, get_nfl_state provides week context for get_matchups), with no obvious dead ends or missing critical operations.
Related MCP Connectors
Fantasy football for any AI agent: draft board, start/sit, waivers, your Sleeper league. Free.
Fantasy analysis for your ESPN, Yahoo, and Sleeper leagues. Reads your leagues, never changes them.
NFL/NBA/MLB/NHL/PGA + DFS and prediction-market data. Browse free; query with a free API key.
Fantasy football across all your leagues: Yahoo, ESPN, Sleeper. Who to root for, waivers, scores.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI models to manage and query fantasy sports leagues through the Sleeper API, supporting tasks like player lookups, league activity, and draft management.79 npmMIT
- FlicenseAqualityDmaintenanceEnables natural language interaction with Sleeper Fantasy Football API data, allowing queries about leagues, players, matchups, draft results, and trade analysis.1325-
- AlicenseAqualityDmaintenanceProvides read-only access to the Sleeper Fantasy Sports API for league info, rosters, matchups, drafts, transactions, and player data.1879 npm1MIT
- FlicenseAqualityDmaintenanceEnables read-only access to Sleeper fantasy sports data, including users, leagues, rosters, matchups, transactions, drafts, players, trending activity, playoff brackets, traded picks, and sport state via MCP tools.18-