Sleeper Scraper MCP

🚀 Sleeper API MCP

This Model Context Protocol (MCP) server offers access to the Sleeper Fantasy Football API, allowing agents to retrieve data on users, leagues, drafts, rosters, matchups, and player information from the Sleeper platform.

🚀 Quick Start

Prerequisites

Ensure you have pip installed to install the necessary dependencies.

Setup Steps

1. Install the requests library using the following command:

pip install requests

2. Place this MCP in a directory named mcp_sleeper.
3. Configure Cursor with the following snippet in .cursor/mcp.json:

{
  "mcpServers": {
    "sleeper": {
      "command": "python server.py"
    }
  }
}

4. Start the MCP using the command:

cursor run-mcp sleeper

✨ Features

• Access user information and their associated leagues.
• Retrieve detailed information about leagues, rosters, and users.
• Obtain matchup details and playoff brackets.
• View transactions and traded picks.
• Access draft information and all picks in a draft.
• Fetch comprehensive player data and information on trending players.
• No API key is required as the Sleeper API is read - only.

📦 Installation

Requirements

pip install requests

Configuration

1. Directory Placement: Place the MCP in a directory named mcp_sleeper.
2. Cursor Configuration: Add the following to your .cursor/mcp.json file:

{
  "mcpServers": {
    "sleeper": {
      "command": "python server.py"
    }
  }
}

3. Start the MCP:

cursor run-mcp sleeper

💻 Usage Examples

Basic Usage

Here's how an agent can use this MCP to retrieve data from Sleeper:

# Get user information
user_info = getUserInfo({"username_or_user_id": "sleeper_username"})

# Get user's leagues for the 2023 NFL season
leagues = getUserLeagues({"user_id": user_info["user_id"], "sport": "nfl", "season": "2023"})

# Get information about a specific league
league_info = getLeagueInfo({"league_id": leagues[0]["league_id"]})

# Get rosters for a league
rosters = getLeagueRosters({"league_id": league_info["league_id"]})

# Get matchups for a specific week
matchups = getLeagueMatchups({"league_id": league_info["league_id"], "week": 1})

# Get trending players
trending_players = getTrendingPlayers({"sport": "nfl", "type": "add", "lookback_hours": 24, "limit": 10})

📚 Documentation

API Methods

The MCP provides the following tools:

User Data

• getUserInfo: Fetch user information by username or user_id.
• getUserLeagues: Fetch all leagues for a user for a specified sport and season.
• getUserDrafts: Fetch all drafts for a user for a specific sport and season.

League Data

• getLeagueInfo: Fetch information about a specific league.
• getLeagueRosters: Fetch all rosters in a league.
• getLeagueUsers: Fetch all users in a league.
• getLeagueMatchups: Fetch matchups in a league for a specific week.
• getLeagueWinnersBracket: Fetch the playoff winners bracket for a league.
• getLeagueLosersBracket: Fetch the playoff losers bracket for a league.
• getLeagueTransactions: Fetch transactions in a league for a specific week.
• getLeagueTradedPicks: Fetch all traded picks in a league.
• getLeagueDrafts: Fetch all drafts for a league.

Draft Data

• getDraftInfo: Fetch information about a specific draft.
• getDraftPicks: Fetch all picks in a draft.
• getDraftTradedPicks: Fetch all traded picks in a draft.

Player Data

• getAllPlayers: Fetch information about all players for a specific sport.
• getTrendingPlayers: Fetch trending players based on add/drop activity.

State Data

• getNFLState: Fetch the current NFL state.

🔧 Technical Details

Rate Limiting

Please be aware of the rate at which you make API calls. According to Sleeper's documentation, you should keep your API calls under 1000 per minute to avoid being IP - blocked.

📄 License

This README does not provide license information.

Further Reading

• Sleeper API Documentation
• Model Context Protocol
• MCP with LLMs