ESPN Fantasy Server

Tests PyPI Python License: MIT

MCP (Model Context Protocol) server providing access to ESPN Fantasy Baseball data, for use with Claude Code and other MCP clients.

Features

• Read league settings, standings, and team information
• View rosters with player details and lineup positions
• Look up players by name with fuzzy matching
• Browse and add free agents, submit waiver claims
• Modify lineups
• Propose, accept, decline, and cancel trades

Quick Start

1. Get ESPN Cookies

To access private leagues, you need ESPN authentication cookies:

1. Log in to ESPN Fantasy Baseball
2. Open browser DevTools → Application → Cookies → https://fantasy.espn.com
3. Copy espn_s2 (long string) and SWID (format: {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX})

2. Add to Claude Code

claude mcp add --scope user --transport stdio espn-fantasy \
  --env ESPN_S2=your_espn_s2_cookie \
  --env ESPN_SWID={your_espn_swid_cookie} \
  --env ESPN_LEAGUE_ID=your_league_id \
  --env ESPN_TEAM_ID=your_team_id \
  --env ESPN_SEASON_YEAR=2026 \
  -- uvx espn-fantasy-mcp

Keep the curly braces in the SWID value. uvx handles installation automatically — no separate install step needed.

3. Verify

Restart Claude Code or run /mcp and confirm "espn-fantasy" appears in the server list. Then try: "Show me my fantasy baseball league settings"

Documentation

• Tool Reference — all available tools and parameters
• Configuration — scopes, manual config, troubleshooting

Local Development

git clone https://github.com/i-am-david-weinstein/espn-fantasy-mcp.git
cd espn-fantasy-mcp
pip install -e ".[dev]"
pytest

To use a local install with Claude Code, replace the uvx ... portion of the claude mcp add command with python3 -m espn_fantasy_mcp.

Contributing

Contributions welcome — open an issue or submit a pull request.

License

MIT

Acknowledgments

• Built with MCP Python SDK
• Uses espn-api