Sleeper MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
sleeper-mcp
Rust CLI + MCP server for Sleeper fantasy sports. Two binaries built from one codebase: sleeper (terminal) and sleeper-mcp (stdio MCP server for Claude/Goose).
Build
cargo build --release
# binaries at target/release/sleeper and target/release/sleeper-mcpRequires: Rust 1.76+, no external system deps (SQLite is bundled via sqlx).
Related MCP server: Yahoo Fantasy MCP
Configuration
export SLEEPER_DATA_DIR=/path/to/cache # default: ./cacheTwo SQLite databases are created automatically under SLEEPER_DATA_DIR:
http_cache.db— SHA256-keyed HTTP response cache with conditional GET supportstats.db— permanent weekly player stats store (completed weeks never re-fetched)
CLI (sleeper)
sleeper <COMMAND>
Commands:
user Get a Sleeper user by username or ID
leagues List all leagues for a user/season
league Get league details
nfl-state Current NFL season state (week, type)
standings League standings sorted by wins/points
rosters All rosters in a league
matchups Matchup overview for a specific week
start-sit Start/sit recommendations for a roster
waivers Waiver wire recommendations (trending adds not yet rostered)
trending Trending players across all Sleeper leagues
trade Analyze a trade by player IDs
transactions Recent transactions for a league week
search Search NFL players by name/position
stats Player stats for a specific week
available Unrostered players ranked by season fantasy points
roster Roster details with player names, positions, injury status
needs Roster needs analysis: strengths, weaknesses, injury risks
dynasty Dynasty tier report: cornerstone/keeper/trade/cut classification
dynasty-scout Young unrostered players sorted by age — dynasty waiver targetsCommon invocations
# Season state
sleeper nfl-state
# Your league standings
sleeper standings --league-id 1124822842475569152
# Your roster (tstapler = roster_id 11)
sleeper roster --league-id 1124822842475569152 --roster-id 11
# Dynasty tier report for your roster
sleeper dynasty --league-id 1124822842475569152 --roster-id 11
# Find young unrostered players to target on waivers (dynasty)
sleeper dynasty-scout --league-id 1124822842475569152 --max-age 25 --limit 30
# Available unrostered RBs ranked by season points
sleeper available --league-id 1124822842475569152 --position RB
# Waiver recommendations (trending adds not on your rosters)
sleeper waivers --league-id 1124822842475569152
# Analyze a trade (player IDs from search)
sleeper trade --giving 4046 --receiving 6794 7564MCP Server (sleeper-mcp)
The MCP server exposes 19 tools over stdio, consumed by Claude Code (or any MCP client).
Claude Code setup
.mcp.json in the repo root points to the release binary:
{
"mcpServers": {
"sleeper": {
"command": "/path/to/sleeper-mcp/target/release/sleeper-mcp",
"args": [],
"env": {
"SLEEPER_DATA_DIR": "/path/to/sleeper-mcp/cache"
}
}
}
}After cargo build --release, restart Claude Code and the sleeper_* tools appear automatically.
MCP Tools
Tool | Description |
| User by username or ID |
| All leagues for a user/season |
| League details |
| Current week, season type |
| Standings sorted by wins/points |
| All rosters |
| Matchup overview for a week |
| Start/sit by projected points |
| Trending adds not yet rostered |
| Trending adds/drops platform-wide |
| Trade analysis by player IDs |
| Transactions for a league week |
| Player search by name/position |
| Stats for a specific week |
| All drafts for a league |
| All picks for a specific draft |
| Roster with player names and injury status |
| Positional strengths, weaknesses, priorities |
| Dynasty tier classification for a roster |
| Young unrostered targets (dynasty waivers) |
Dynasty Workflow
This is a dynasty league (Big Blue 2, 12-team Half-PPR, league_id=1124822842475569152). Run this workflow each offseason:
1. Tier your roster
sleeper dynasty --league-id 1124822842475569152 --roster-id 11Dynasty tiers are position-aware:
Tier | Label | QB | RB | WR/TE/IDP |
1 | Cornerstone | ≤26 | ≤24 | ≤25 |
2 | Keeper | 27–33 | 25–27 | 26–29 |
3 | Trade candidate | 34–36 | 28–30 | 30–33 |
4 | Cut / move on | 37+ | 31+ | 34+ |
2. Scout waiver targets
# All positions, age ≤ 25
sleeper dynasty-scout --league-id 1124822842475569152 --max-age 25
# WRs only
sleeper dynasty-scout --league-id 1124822842475569152 --position WR --max-age 263. Check availability
sleeper available --league-id 1124822842475569152 --position RB4. Evaluate trades
Use analyze_trade (MCP) or sleeper trade (CLI) with the player IDs from search results.
2026 Rookie Draft Prep
Season status (May 2026): 2025 dynasty season is complete. tstapler finished 12th (last place) with a 9–19 record, 1396.86 pts. The 2026 rookie draft has not yet been created in Sleeper but will open before the NFL season.
Draft slot: tstapler likely holds pick 1.01 (last-place finish in a 12-team league gets the first pick). Verify once the draft is created:
sleeper leagues --user-id 999021676069273600 --season 2026
# then get the draft_id and check:
sleeper drafts --league-id 11248228424755691522026 Dynasty Rookie Rankings (post-NFL Draft consensus, May 2026)
Tier 1 — Take at 1.01–1.04
Rank | Player | Pos | Team | Notes |
1 | Jeremiyah Love | RB | TBD | Unanimous 1.01 in 1QB leagues (97% of drafts). First consensus RB1 since Jonathan Taylor 2020. |
2 | Carnell Tate | WR | Tennessee Titans | Cam Ward's WR1. Top target share, immediate starter. |
3 | Jordyn Tyson | WR | New Orleans Saints | 8th overall pick. Chris Olave leaves after 2026 → could be outright WR1 by 2027. |
4 | Makai Lemon | WR | Philadelphia Eagles | Elite supporting cast. Some experts rank above Tate by August. |
Tier 2 — Strong value (1.05–1.09)
Rank | Player | Pos | Team | Notes |
5 | Seth McGowan | RB | TBD | Three-down potential. Experts significantly above market ADP. |
6 | Kaelon Black | RB | TBD | Breakout candidate / high-quality handcuff. |
7 | Emmett Johnson | RB | Kansas City Chiefs | Clear RB2 behind starter; massive injury-replacement value in KC offense. |
Tier 3 — Round 2 targets
Rank | Player | Pos | Notes |
8 | Malachi Fields | WR | 6-5, 218 lbs, 38" vertical. Elite athletic profile, longer development. |
9 | Eli Raridon | TE | New England Patriots. Round 3 pick. Heir to Hunter Henry; attached to Drake Maye long-term. |
10 | Drew Allar | QB (SF) | Pittsburgh Steelers. Round 3. Strong arm + mobility. Experts 10 ADP spots above market. |
Class summary: WR is the deepest position. RB has Love at the top but falls off sharply. TE class is weak. In a 1QB half-PPR league: take Love at 1.01, then target Tyson or Tate at 1.03–1.04, then load up on WR depth in round 2.
Fernando Mendoza (QB, Raiders) — Superflex note
If your league were Superflex, Mendoza would compete for 1.01. In 1QB, he's a non-factor — skip.
Architecture
src/
lib.rs module re-exports
main.rs sleeper CLI (clap derive)
bin/sleeper_mcp.rs MCP server entry (rmcp stdio)
models.rs serde structs for all Sleeper API types
config.rs Config (SLEEPER_DATA_DIR or ./cache)
error.rs thiserror Error enum + Result<T>
client.rs SleeperClient: reqwest + SQLite cache + rate limiter
cache.rs HttpCache: SHA256-keyed SQLite response cache
rate_limit.rs RateLimiter: goroutine actor (tokio::spawn + mpsc)
db.rs StatsDb: permanent weekly stats (SQLite)
analysis.rs AnalysisService: standings, matchups, trade, dynasty
cli.rs 19 CLI commands (indicatif + console colors)
mcp.rs 19 MCP tools (rmcp #[tool] macros)Concurrency: All parallel API calls use tokio::spawn → JoinHandle. The rate limiter is a goroutine actor: callers send oneshot reply channels via an mpsc inbox; the actor grants tokens and replies. Arc<SleeperClient> is cloned cheaply into each task.
Key IDs
Item | Value |
User ID | 999021676069273600 |
Username | tstapler |
Primary league | Big Blue 2 |
League ID | 1124822842475569152 |
Roster ID | 11 |
Format | 12-team Half-PPR dynasty |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceThis Model Context Protocol server provides access to the Sleeper Fantasy Football API, enabling agents to fetch data about users, leagues, drafts, rosters, matchups, and player information without requiring an API key.7-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides read-only access to Yahoo Fantasy Sports data, enabling AI assistants to query league standings, player stats, matchups, and rosters.6MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for NFL fantasy football retrieval, providing access to NFL stats and Sleeper league data through retrieval-oriented tools.-
- AlicenseAqualityDmaintenanceA read-only MCP server that supplies live context from Sleeper fantasy-football leagues, including rosters, trade analysis, draft picks, and league settings via Sleeper's public API.11MIT