espn-fantasy-rffl-analysis by thorsenk - MCP Server

ESPN Fantasy Football MCP Server & RFFL Historical Analysis

Overview

This project contains two main components:

1. ESPN Fantasy Football MCP Server

An MCP (Model Context Protocol) server that allows LLMs like Claude to interact with the ESPN Fantasy Football API. It provides tools for accessing league data, team rosters, player statistics, and more through a standardized interface. It can work with both public and private ESPN Leagues.

2. RFFL Historical Data Analysis

A comprehensive analysis of the RFFL (Reddit Fantasy Football League) spanning 23 seasons (2002-2025), including detailed season breakdowns, statistical analysis, and championship tracking. This data analysis was completed as a comprehensive historical documentation project.

MCP Server Features (Tools)

Authentication: Securely store ESPN credentials for the current session (for private leagues)
League Info: Get basic information about fantasy football leagues
Team Rosters: View current team rosters and player details
Player Stats: Find and display stats for specific players
League Standings: View current team rankings and performance metrics
Matchup Information: Get details about weekly matchups

RFFL Data Analysis Files

The following files contain comprehensive historical analysis:

Core Data Files

RFFL_DATA_VAULT.md - Central repository of league history and championship records
RFFL_NORMALIZED_DATA.md - Standardized data format documentation
old-system_rffl_historical-data-entires.csv - Original historical data source

Season Documentation

RFFL_2024_SEASON.md - Complete 2024 season analysis
RFFL_2011_SEASON.md - Complete 2011 season analysis
RFFL_2012_SEASON.md - Complete 2012 season analysis
RFFL_SEASON_BY_SEASON.md - Multi-season comparative analysis
RFFL_SEASON_TEMPLATE.md - Template for future season documentation

Analysis Reports

RFFL_DEEP_TRENDS_ANALYSIS.md - Advanced statistical trends and patterns
RFFL_LEAGUE_METADATA_ANALYSIS.md - League structure and evolution analysis
RFFL_LEAGUE_SETTINGS_EVOLUTION.md - How league rules changed over time
RFFL_DRAFT_ANALYSIS.md - Draft performance and strategy analysis
RFFL_2024_DRAFT_ANALYSIS.md - Detailed 2024 draft breakdown
RFFL_2024_FACT_SHEET.md - Key 2024 season statistics

Technical Documentation

ESPN_VS_CSV_COMPARISON.md - Data source comparison and validation
CURSOR_SETUP_GUIDE.md - Development environment setup

Key Findings from RFFL Analysis

Kyle's Championship Legacy: 5 championships across 23 seasons (2002, 2009, 2011, 2014, 2024) - 22% championship rate
League Competitive Balance: Multiple owners with sustained success over decades
Evolution: League has grown in sophistication from $1,800 to $7,200+ prize pools
Data Quality: ESPN API data from 2011+ provides rich statistical analysis opportunities

Installation (MCP Server)

Prerequisites

Python 3.10 or higher
uv package manager
Claude Desktop for the best experience

Usage with Claude Desktop

Update the Claude Desktop config:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Include reference to the MCP server

{
"mcpServers": {
  "espn-fantasy-football": {
    "command": "uv",
    "args": [
      "--directory",
      "/absolute/path/to/directory",
      "run",
      "espn_fantasy_server.py"
      ]
    }
  }
}

Restart Claude Desktop

Project Status

COMPLETED - This project has been fully developed and documented. The MCP server is functional for ESPN Fantasy Football API integration, and the RFFL historical analysis provides a comprehensive 23-season documentation of league history, trends, and statistics.

Acknowledgements

cwendt94/espn-api for the excellent Python wrapper around the ESPN Fantasy API
RFFL participants for 23 seasons of competitive fantasy football providing rich historical data