sleeper-mcp

🤖 An MCP tool server exposing the Sleeper fantasy sports API, enabling AI models and agents to manage and query fantasy leagues.

Features

With this server running, an AI can perform actions on your behalf, such as:

• 📊 Get Information: Fetch detailed data about users, leagues, rosters, and traded picks.

• 🏈 Analyze Players: Search players by name, position, or team, resolve player IDs to names, or see who is currently trending (being added or dropped the most).

• 🗓️ Check League Activity: View weekly matchups, transactions, and the current state of the NFL season.

• 🏆 Follow the Playoffs: Retrieve the winner's and loser's brackets for a league.

• 📝 Manage Drafts: Access information about past and upcoming drafts, including picks and draft boards.

Setup

Build the server app:

npm install
npm run build

Claude Code picks up the checked-in .mcp.json automatically when started from the repo root (approve it once when prompted). Build first — build/ is not committed.

For other MCP clients, configure the server manually:

{
    "mcpServers": {
        "sleeper-mcp": {
            "command": "node",
            "args": ["/path/to/repo/build/index.js"],
            "env": {
                "SLEEPER_MCP_CACHE_DIR": "/path/to/cache/dir"
            }
        }
    }
}

Your own account (optional)

Drop a .sleeper-mcp.json in the repo root with your own Sleeper identifiers and an assistant can answer "how does my roster look?" without asking you for IDs every time:

cp .sleeper-mcp.example.json .sleeper-mcp.json

{
    "username": "your-sleeper-username",
    "user_id": "000000000000000000",
    "league_id": "000000000000000000"
}