Developer Documentation

Fantasy Football MCP
AI-Powered Analytics

Connect AI assistants to comprehensive fantasy football data through our Model Context Protocol server. Access real-time player analytics, trade evaluation, matchup analysis, and season projections powered by Laravel's robust data layer and Sleeper API integration.

Quickstart

Claude & Cursor Setup

Connect your AI assistant to fantasy football data in three simple steps

1

Close your client (Claude Desktop or Cursor)

2

Create or edit the config file:

  • ~/Library/Application Support/Claude/claude_desktop_config.json
  • ~/.cursor/mcp.json
3

Add this server using the configuration examples below

Claude Desktop Configuration
{
  "mcpServers": {
    "fantasy-football-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://www.sleeperdraft.com/mcp"
      ]
    }
  }
}
Cursor Configuration
{
  "mcpServers": {
    "fantasy-football-mcp": {
      "transport": {
        "type": "http",
        "url": "https://www.sleeperdraft.com/mcp"
      }
    }
  }
}

Restart your client. In Cursor, manage servers in Settings → MCP; in Claude, the server appears under MCP servers.

Features

MCP Overview

  • Trade Evaluation: AI-powered trade analysis with stat comparisons and confidence recommendations
  • Matchup Analysis: enriched matchups with win probabilities and player projections
  • Player Analytics: comprehensive stats, projections, and volatility metrics for all players
  • Trending Data: real-time player adds/drops and market intelligence
  • League Integration: free agent tracking and roster management for your leagues
  • GPT Actions Ready: optimized endpoints for seamless OpenAI Custom GPT integration
API Reference

Available Tools

Fantasy Football Tools

  • evaluate-trade AI-powered trade analysis with stat comparisons and confidence recommendations
  • fetch-matchups Get enriched matchups with win probabilities and player projections
  • fetch-player Comprehensive player data including stats, projections, and performance analysis
  • fetch-players Paginated player list with filtering and league integration
  • fetch-trending-players Real-time trending data based on adds/drops in the last 24 hours
  • fetch-user-leagues Get all leagues for a user by username or user ID
Examples

Usage Examples

Direct API calls for custom integrations

Evaluate a Fantasy Trade
POST /api/mcp/tools/evaluate-trade
{
  "receiving": [
    {"search": "Josh Allen"},
    {"search": "Travis Kelce"}
  ],
  "sending": [
    {"search": "Patrick Mahomes"},
    {"search": "Tyreek Hill"}
  ]
}
Get League Matchups
POST /api/mcp/tools/fetch-matchups
{
  "league_id": "123456789012345678",
  "week": 5
}
Get Player Details
POST /api/mcp/tools/fetch-player
{
  "search": "Christian McCaffrey"
}
Get Trending Players
POST /api/mcp/tools/fetch-trending-players
{
  "type": "add"
}
Endpoints

API Endpoints

Live MCP Endpoint
https://www.sleeperdraft.com/mcp
Available Tools
evaluate-trade, fetch-matchups, fetch-player, fetch-players, fetch-trending-players, fetch-user-leagues
https://www.sleeperdraft.com/api/mcp/tools
OpenAPI Spec
https://www.sleeperdraft.com/api/openapi.yaml