Sleeper MCP Server
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 Server Show my matchups and scores for this week."
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 API and MCP server
Sleeper has a public read-only API and no official MCP server. Cotlet.dev offers a hosted MCP connection to your signed-in Sleeper account with 13 tools, including six write operations for lineups, waivers, trades and league chat.
What you can ask
Bench starters who are ruled out in every league.
Place a FAAB waiver bid after checking the available free agents.
Show my matchups and scores for this week.
Draft the weekly league recap for my chat.
Answer open trade offers after I approve the changes.
Related MCP server: SleepBot
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Sleeper tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
{"mcpServers":{"sleeper":{"command":"uvx","args":["sleeper-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}Or with Docker:
docker build -t sleeper-mcp .
docker run -i --rm -e COTLET_API_KEY sleeper-mcpTools: sleeper_guide, sleeper_status, sleeper_open, sleeper_read, sleeper_click, sleeper_type, sleeper_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. From PyPI:
pip install sleeper-mcp # or run it once: uvx sleeper-mcp connect
sleeper-mcp connectOr straight from this repo:
export COTLET_API_KEY="your-key"
python3 sleeper_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 sleeper_agent.py status # is Sleeper ready in your Cotlet.dev account
python3 sleeper_agent.py guide # Sleeper screens and sign-in link
python3 sleeper_agent.py read # open Sleeper, read the page, close the browser
python3 sleeper_agent.py tools # list Cotlet.dev tools
python3 sleeper_agent.py serve # start the stdio MCP server (same as no argument)Questions from Sleeper users
Does Sleeper have an MCP server or an API?
Sleeper has a public read-only API and no official MCP server. Cotlet.dev offers 13 hosted tools over MCP and REST, including writes that ask for approval.
Which account do I connect?
Connect your own Sleeper account in its Cotlet Cloud Browser, sign in yourself and enable it for agents.
Which actions ask for approval?
Lineup changes, waiver bids, trades and league chat messages require your approval before they are sent.
Is this affiliated with Sleeper?
No. Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by Sleeper.
Find it on
Also works with
Start free: https://cotlet.dev/signup?app=sleeper&utm_source=github&utm_medium=readme&utm_campaign=sleeper
Available Tools
7 toolssleeper_clickB
Click a numbered element on the current Sleeper page.
Inputs: element (required).
sleeper_closeA
Close the Sleeper browser session when the work is done, so credits stop running.
Inputs: no named parameters.
sleeper_guideA
How to work in Sleeper (leagues, lineups, waivers and trades): its screens and the sign-in link. Call this first.
Inputs: task.
sleeper_openA
Open a Sleeper page in your signed-in Cloud Browser (default https://sleeper.app) to work with leagues, lineups, waivers and trades.
Inputs: url.
sleeper_readA
Read the current Sleeper page: its text and numbered buttons, links and fields.
Inputs: element.
sleeper_statusB
Check that your Cotlet.dev account and Sleeper are ready: account, credits and Sleeper connection.
Inputs: no named parameters.
sleeper_typeC
Type text into a numbered field on the current Sleeper page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct action: open/close session, read page, click element, type text, check status, read guide. The browser-automation verbs are unambiguous and there is essentially no overlap between click, type, and read.
All seven tools share the sleeper_ prefix followed by a single clear verb (open, close, read, click, type, status, guide). The pattern is uniform and highly predictable.
Seven tools is well-scoped for a browser automation server, with each tool earning its place across the session lifecycle. Nothing feels padded or bloated.
The set covers a coherent session lifecycle: guide, status, open, read, click, type, close. Minor gaps exist for common browser interactions like scrolling, navigation/back, or waiting on dynamic content, but core workflows are fully supported.
Related MCP Connectors
Fantasy football for any AI agent: draft board, start/sit, waivers, your Sleeper league. Free.
NFL analytics tools for AI agents: stats, fantasy, injuries, schedules, and advanced analysis.
Fantasy analysis for your ESPN, Yahoo, and Sleeper leagues. Reads your leagues, never changes them.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI models to manage and query fantasy sports leagues through the Sleeper API, supporting tasks like player lookups, league activity, and draft management.MIT
- AlicenseNot gradedqualityBmaintenanceConnects Claude to Sleeper fantasy football leagues, providing read-only tools for rosters, matchups, standings, transactions, player search, and trending players, with multi-league support.MIT
- AlicenseBqualityBmaintenanceEnables reading Sleeper fantasy football rosters, matchups, standings, news, chat, and pick'em entries, with optional write actions for setting lineups, claiming waivers, and proposing trades.392MIT
- FlicenseAqualityCmaintenanceEnables access to Sleeper fantasy football data, including users, leagues, rosters, matchups, transactions, drafts, and player information.139 npm-