sleeper-mcp
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 What's the current NFL week and 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
An MCP (Model Context Protocol) server for the Sleeper Fantasy Sports API. Gives Claude, Cursor, VS Code Copilot, and any other MCP-compatible AI client read access to Sleeper's public API — no API key required.
What you can do
Ask your AI assistant things like:
"What leagues am I in this season?" (give it your Sleeper username)
"Show me the standings and rosters for my league"
"Who won the championship bracket?"
"What trades happened this week?"
"Which players are being added the most right now?"
"Show me all first-round draft picks from my 2024 draft"
Related MCP server: sleeper-mcp
Available Tools
Tool | Description |
| Look up a user's profile by username or user ID |
| Current NFL week, season type, and season year |
| All leagues a user is in for a given sport/season |
| Full league details including scoring and roster settings |
| All rosters with win/loss records and player lists |
| All managers in a league with their team names |
| Weekly matchup scores for any week |
| Playoff championship bracket |
| Consolation / toilet bowl bracket |
| Trades, waiver claims, and FA adds/drops by week |
| All traded draft picks in a league |
| All drafts a user participated in |
| All drafts for a league |
| Full draft details (type, order, slot mapping) |
| Every pick in a draft with player and position info |
| Picks that were traded within a draft |
| Full NFL player database with filtering by position, team, or name |
| Most-added or most-dropped players over a time window |
Prerequisites
A Sleeper account is helpful but not required (the API is fully public)
Installation
git clone https://github.com/yooitsgreg/sleeper-mcp.git
cd sleeper-mcp
# pick your package manager:
npm install # or: pnpm install / yarn / bun installThe install triggers a prepare hook that compiles TypeScript to dist/. No separate build step needed.
Configuration
Pick the section for your AI client.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"sleeper": {
"command": "node",
"args": ["/absolute/path/to/sleeper-mcp/dist/index.js"]
}
}
}Claude Code (CLI)
Edit ~/.claude/claude.json:
{
"mcpServers": {
"sleeper": {
"command": "node",
"args": ["/absolute/path/to/sleeper-mcp/dist/index.js"]
}
}
}VS Code (GitHub Copilot / MCP extension)
Create or edit .vscode/mcp.json in your workspace:
{
"servers": {
"sleeper": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/sleeper-mcp/dist/index.js"]
}
}
}Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"sleeper": {
"command": "node",
"args": ["/absolute/path/to/sleeper-mcp/dist/index.js"]
}
}
}After editing the config, restart your AI client.
Development
npm run dev # watch mode (tsx), recompiles on save
npm run build # compile TypeScript → dist/
npm run clean # remove dist/Project structure
src/
├── index.ts # Entry point — wires up McpServer + StdioServerTransport
├── constants.ts # API base URL, timeouts, character limits
├── types.ts # TypeScript interfaces for all Sleeper API responses
├── services/
│ └── sleeperClient.ts # Shared axios client and error handler
└── tools/
├── users.ts # sleeper_get_user
├── leagues.ts # All league tools (9 tools)
├── drafts.ts # All draft tools (5 tools)
├── players.ts # sleeper_get_nfl_players, sleeper_get_trending_players
└── state.ts # sleeper_get_nfl_stateNotes
No authentication required — Sleeper's API is free and public.
Rate limit — Sleeper asks that you stay under 1,000 requests/minute.
sleeper_get_nfl_playersfetches ~5 MB of data. Use theposition_filter,team_filter, orsearchparameters to keep responses manageable. Sleeper recommends caching this data and only refreshing once per day.All tools are read-only — this server never writes to Sleeper.
License
MIT
Available Tools
18 toolssleeper_get_draftGet Draft DetailsARead-onlyIdempotent
Get detailed information about a specific Sleeper fantasy draft.
Args:
draft_id (string): The Sleeper draft ID
Returns: Full draft details: type, status, rounds, slot-to-roster mapping, draft order, settings.
Examples:
"Show details for draft 987654321"
"What type of draft is this and how many rounds?"
Inputs: draft_id (required).
sleeper_get_draft_picksGet Draft PicksARead-onlyIdempotent
Get all picks made in a specific Sleeper fantasy draft, in order.
Args:
draft_id (string): The Sleeper draft ID
round_filter (number, optional): Filter results to a specific round only
Returns: All picks in pick order: round, pick number, player, position, team, and who picked them.
Examples:
"Show all picks from draft 987654321"
"What were the first-round picks?"
"Who did roster 5 draft?"
Inputs: draft_id (required), round_filter.
sleeper_get_draft_traded_picksGet Draft Traded PicksARead-onlyIdempotent
Get all picks that were traded within a specific Sleeper draft.
Args:
draft_id (string): The Sleeper draft ID
Returns: All traded picks: round, original owner roster, and current owner roster.
Examples:
"What picks were traded in draft 987654321?"
"Show pick trades from this draft"
Inputs: draft_id (required).
sleeper_get_leagueGet League DetailsARead-onlyIdempotent
Fetch detailed information about a specific Sleeper fantasy league.
Args:
league_id (string): The Sleeper league ID
Returns: Full league details: name, status, settings, scoring settings, roster positions, and more.
Examples:
"Get details for league 123456789"
"What are the scoring settings for this league?"
Inputs: league_id (required).
sleeper_get_league_draftsGet League DraftsARead-onlyIdempotent
Get all drafts that have taken place in a Sleeper fantasy league.
Args:
league_id (string): The Sleeper league ID
Returns: All drafts for the league with type, status, rounds, and timing.
Examples:
"What drafts have happened in league 123456?"
"Get the draft history for this league"
Inputs: league_id (required).
sleeper_get_league_losers_bracketGet League Losers BracketARead-onlyIdempotent
Get the consolation/toilet bowl (losers bracket) for a Sleeper fantasy league.
Args:
league_id (string): The Sleeper league ID
Returns: Losers bracket structure showing consolation matchups and results.
Examples:
"Show me the toilet bowl bracket for league 123456"
"Who came in last place?"
Inputs: league_id (required).
sleeper_get_league_matchupsGet League MatchupsARead-onlyIdempotent
Get all matchups for a specific week in a Sleeper fantasy league.
Args:
league_id (string): The Sleeper league ID
week (number): NFL week number (1-18 for regular season)
Returns: All matchups for the week: roster IDs, points, starters, and player scores.
Examples:
"What are the matchups for week 5 in league 123456?"
"Show me all scores for week 12"
Inputs: week (required), league_id (required).
sleeper_get_league_rostersGet League RostersARead-onlyIdempotent
Get all rosters in a Sleeper fantasy league, including players, starters, and standings.
Args:
league_id (string): The Sleeper league ID
Returns: All rosters with owner IDs, player lists, and win/loss records.
Examples:
"Show me all rosters in league 123456"
"What players does roster 3 have?"
Inputs: league_id (required).
sleeper_get_league_traded_picksGet League Traded PicksARead-onlyIdempotent
Get all traded draft picks in a Sleeper fantasy league (across all seasons).
Args:
league_id (string): The Sleeper league ID
Returns: All traded picks with season, round, original owner, and current owner.
Examples:
"What draft picks have been traded in league 123456?"
"Which future picks does roster 3 own?"
Inputs: league_id (required).
sleeper_get_league_transactionsGet League TransactionsARead-onlyIdempotent
Get all transactions (trades, waiver claims, free agent adds/drops) for a specific round/week in a league.
Args:
league_id (string): The Sleeper league ID
round (number): The transaction round (corresponds to NFL week number)
Returns: List of transactions with type (trade/waiver/free_agent), adds, drops, traded picks, and status.
Examples:
"What trades happened in week 8 in league 123456?"
"Show all waiver claims for round 3"
Inputs: round (required), league_id (required).
sleeper_get_league_usersGet League UsersARead-onlyIdempotent
Get all users (managers) in a Sleeper fantasy league with their team names and metadata.
Args:
league_id (string): The Sleeper league ID
Returns: List of users with user IDs, display names, team names, and avatar IDs.
Examples:
"Who are the managers in league 123456?"
"List all teams in this league"
Inputs: league_id (required).
sleeper_get_league_winners_bracketGet League Winners BracketARead-onlyIdempotent
Get the playoff winners bracket (championship bracket) for a Sleeper fantasy league.
Args:
league_id (string): The Sleeper league ID
Returns: Bracket structure showing playoff matchups, rounds, and results.
Examples:
"Show me the playoff bracket for league 123456"
"Who won the championship in this league?"
Inputs: league_id (required).
sleeper_get_nfl_playersGet All NFL PlayersARead-onlyIdempotent
Fetch the complete NFL player database from Sleeper (~5MB). Returns all player metadata. NOTE: This is a large dataset. Use filters to narrow results. Sleeper recommends caching this data and only fetching once per day.
Args:
position_filter (string, optional): Filter by position (e.g. "QB", "RB", "WR", "TE", "K", "DEF")
team_filter (string, optional): Filter by NFL team abbreviation (e.g. "KC", "SF", "DAL")
active_only (boolean): Only return active players (default: true)
search (string, optional): Filter by player name (case-insensitive substring match)
limit (number): Max players to return (default: 50, max: 200)
offset (number): Pagination offset (default: 0)
Returns: Paginated list of players with id, name, position, team, status.
Examples:
"List all active QBs"
"Find players on the Kansas City Chiefs"
"Search for players named 'Patrick'"
Inputs: limit, offset, search, active_only, +2 more.
sleeper_get_nfl_stateGet NFL StateARead-onlyIdempotent
Retrieve the current NFL season state including the active week, season type, and season dates. Useful for knowing what week it is, whether we're in preseason/regular/postseason, and which season year is active.
Returns: Current week, season type (pre/regular/post), season year, season start date, display week.
Examples:
"What week is it in the NFL?"
"Is the NFL season currently active?"
"What is the current NFL season year?"
Inputs: no named parameters.
sleeper_get_trending_playersGet Trending NFL PlayersARead-only
Get trending NFL players on Sleeper based on recent add or drop activity.
Args:
type (string): "add" for most added players, "drop" for most dropped players
lookback_hours (number): Hours to look back for trend data (default: 24, max: 168)
limit (number): Number of trending players to return (default: 25, max: 200)
Returns: List of player IDs with their add/drop counts, sorted by activity volume.
Examples:
"Who are the most added players this week?"
"Which players are being dropped the most today?"
"Show me trending adds over the last 48 hours"
Inputs: type (required), limit, lookback_hours.
sleeper_get_userGet Sleeper UserARead-onlyIdempotent
Retrieve a Sleeper user's profile by their username or user ID.
Args:
identifier (string): The username (e.g. "john_doe") or numeric user ID (e.g. "12345678")
Returns: User profile including user_id, username, display_name, and avatar.
Examples:
"Get user info for username 'sleeperuser'"
"Look up user ID 123456789"
Inputs: identifier (required).
sleeper_get_user_draftsGet User's DraftsARead-onlyIdempotent
Get all drafts a user has participated in for a given sport and season.
Args:
user_id (string): Sleeper user ID
sport (string): Sport (default: "nfl")
season (string): Season year (e.g. "2024")
Returns: List of drafts with draft ID, type, status, and league ID.
Examples:
"What drafts did user 123456 do in 2024?"
"Show all NFL drafts for this user"
Inputs: season (required), user_id (required), sport.
sleeper_get_user_leaguesGet User's LeaguesARead-onlyIdempotent
Get all fantasy leagues a user is in for a given sport and season.
Args:
user_id (string): The Sleeper user ID (use sleeper_get_user to look up by username)
sport (string): Sport to filter by (default: "nfl")
season (string): Season year (e.g. "2024", "2025")
Returns: List of leagues including league name, ID, status, roster count, and scoring type.
Examples:
"What leagues is user 123456 in for the 2024 season?"
"Show all NFL leagues for user ID 987654321"
Inputs: season (required), user_id (required), sport.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Each tool has a clearly distinct purpose, covering different aspects of Sleeper fantasy football such as user, league, draft, player, and league operations. There is no ambiguity or overlap between tool functionalities.
All tool names follow a consistent 'sleeper_get_<resource>' pattern using snake_case. The naming is uniform and predictable, with clear hierarchy for sub-resources like 'sleeper_get_draft_picks'.
With 18 tools, the server is well-scoped for its purpose. It covers a broad but focused set of functionalities for Sleeper fantasy football, without being overwhelming or too sparse.
The tool set provides comprehensive coverage of core Sleeper fantasy football operations: user management, league details, rosters, matchups, transactions, brackets, drafts, and NFL player data. No obvious gaps exist for typical use cases.
Maintenance
Related MCP Connectors
NFL/NBA/MLB/NHL/PGA + DFS and prediction-market data. Browse free; query with a free API key.
Fantasy analysis for your ESPN, Yahoo, and Sleeper leagues. Reads your leagues, never changes them.
Provides access to live sports data and analytics from BALLDONTLIE: The Sports API
Read-only PDGA disc golf data — players, events, courses and season statistics.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to Sleeper fantasy football leagues, enabling team snapshots, available players, matchups, trade context, and league history through standardized MCP tools.MIT
- 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-
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server that provides access to public Sleeper NFL fantasy data, including leagues, rosters, matchups, waivers, drafts, and player information. It enables AI clients to retrieve fantasy football details without requiring authentication or account modifications.-
- FlicenseNot gradedqualityCmaintenanceProvides read-only access to Sleeper fantasy football data including user info, leagues, rosters, matchups, and NFL state through MCP tools.-