Skip to main content
Glama
sleeper-mcp

sleeper-mcp

by yooitsgreg

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

sleeper_get_user

Look up a user's profile by username or user ID

sleeper_get_nfl_state

Current NFL week, season type, and season year

sleeper_get_user_leagues

All leagues a user is in for a given sport/season

sleeper_get_league

Full league details including scoring and roster settings

sleeper_get_league_rosters

All rosters with win/loss records and player lists

sleeper_get_league_users

All managers in a league with their team names

sleeper_get_league_matchups

Weekly matchup scores for any week

sleeper_get_league_winners_bracket

Playoff championship bracket

sleeper_get_league_losers_bracket

Consolation / toilet bowl bracket

sleeper_get_league_transactions

Trades, waiver claims, and FA adds/drops by week

sleeper_get_league_traded_picks

All traded draft picks in a league

sleeper_get_user_drafts

All drafts a user participated in

sleeper_get_league_drafts

All drafts for a league

sleeper_get_draft

Full draft details (type, order, slot mapping)

sleeper_get_draft_picks

Every pick in a draft with player and position info

sleeper_get_draft_traded_picks

Picks that were traded within a draft

sleeper_get_nfl_players

Full NFL player database with filtering by position, team, or name

sleeper_get_trending_players

Most-added or most-dropped players over a time window

Prerequisites

  • Node.js 18+ — download — OR — Bun — download

  • 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 install

The 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_state

Notes

  • 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_players fetches ~5 MB of data. Use the position_filter, team_filter, or search parameters 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 tools
sleeper_get_draftGet Draft DetailsA
Read-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 PicksA
Read-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 PicksA
Read-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 DetailsA
Read-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 DraftsA
Read-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 BracketA
Read-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 MatchupsA
Read-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 RostersA
Read-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 PicksA
Read-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 TransactionsA
Read-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 UsersA
Read-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 BracketA
Read-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 PlayersA
Read-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 StateA
Read-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_userGet Sleeper UserA
Read-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 DraftsA
Read-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 LeaguesA
Read-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

    A4.3/5.0

    Scored across 18 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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'.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides read-only access to Sleeper fantasy football leagues, enabling team snapshots, available players, matchups, trade context, and league history through standardized MCP tools.
      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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-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.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Provides read-only access to Sleeper fantasy football data including user info, leagues, rosters, matchups, and NFL state through MCP tools.
      -