Skip to main content
Glama
sleeper-mcp

sleeper-mcp

by LuccaBessa

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 build

Run the Vitest suite with:

npm test

Run the build, Oxlint, Oxfmt, and Vitest checks with:

npm run check

Apply automatic formatting with npm run format. The compiled MCP entrypoint is build/index.js.

Related MCP server: Sleeper MCP Server

Tools

Tool

Description

get_user

Look up one user by exactly one of username or user_id

get_leagues

Get a user's NFL leagues for an explicit four-digit season

get_league

Get details for one league_id

get_rosters

Get league rosters and annotate player IDs when player data is available

get_users_in_league

Get public user and team metadata in a league

get_matchups

Get weekly matchups and annotate player IDs when available

get_transactions

Get trades, waivers, and free-agent transactions by round

get_traded_picks

Get traded picks, including future picks

get_nfl_state

Get the current NFL season, week, and season type

get_drafts

Get league drafts, newest first according to Sleeper

get_draft_picks

Get draft picks and any metadata supplied by Sleeper

get_trending_players

Get recent add/drop trends with player names when available

resolve_players

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_players accepts force_refresh, but repeated forced refreshes are limited to once every five minutes.

  • resolve_players deduplicates 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 tools
get_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_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

    A4/5.0

    Scored across 13 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI models to manage and query fantasy sports leagues through the Sleeper API, supporting tasks like player lookups, league activity, and draft management.
      79 npm
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables natural language interaction with Sleeper Fantasy Football API data, allowing queries about leagues, players, matchups, draft results, and trade analysis.
      13
      25
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides read-only access to the Sleeper Fantasy Sports API for league info, rosters, matchups, drafts, transactions, and player data.
      18
      79 npm
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables 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
      -