Skip to main content
Glama
Sleeper MCP Server

Sleeper MCP Server

by tstapler

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-mcp

Requires: 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: ./cache

Two SQLite databases are created automatically under SLEEPER_DATA_DIR:

  • http_cache.db — SHA256-keyed HTTP response cache with conditional GET support

  • stats.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 targets

Common 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 7564

MCP 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

get_user

User by username or ID

get_user_leagues

All leagues for a user/season

get_league

League details

get_nfl_state

Current week, season type

get_league_standings

Standings sorted by wins/points

get_league_rosters

All rosters

get_matchups

Matchup overview for a week

get_start_sit_recommendations

Start/sit by projected points

get_waiver_recommendations

Trending adds not yet rostered

get_trending_players

Trending adds/drops platform-wide

analyze_trade

Trade analysis by player IDs

get_recent_transactions

Transactions for a league week

search_players

Player search by name/position

get_player_stats

Stats for a specific week

get_league_drafts

All drafts for a league

get_draft_picks

All picks for a specific draft

get_roster_with_names

Roster with player names and injury status

analyze_roster_needs

Positional strengths, weaknesses, priorities

dynasty_report

Dynasty tier classification for a roster

dynasty_scout

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 11

Dynasty 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 26

3. Check availability

sleeper available --league-id 1124822842475569152 --position RB

4. 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 1124822842475569152

2026 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…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      This 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      6
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server for NFL fantasy football retrieval, providing access to NFL stats and Sleeper league data through retrieval-oriented tools.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      11
      MIT