Skip to content
Back to search

fantasy-football-mcp-public

Yahoo Fantasy Football MCP server for Claude Desktop - Advanced lineup optimization, draft assistance, and league management. Built using Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/derekrbreese--fantasy-football-mcp-public/badge.svg)](/listings/derekrbreese--fantasy-football-mcp-public)

HTML

<a href="/listings/derekrbreese--fantasy-football-mcp-public"><img src="/api/listings/derekrbreese--fantasy-football-mcp-public/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
cd fantasy-football-mcp-public
pip install -r requirements.txt

Copy `.env.example` to `.env` and provide your Yahoo developer credentials. Do not commit `.env`, Yahoo token JSON files, OAuth state, refresh tokens, or other authentication artifacts.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 147 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Fantasy Football MCP Server
  2. A personal, single-user Model Context Protocol (MCP) server for Yahoo Fantasy Football. It exposes league, roster, matchup, waiver-wire, draft, and lineup-analysis data to AI clients while keeping the underlying fantasy data source separate from the model.
  3. ## Current status
  4. This project is built and run as a **single-user app**: you supply your own Yahoo developer credentials and tokens, and the server serves your leagues to your MCP client. It is not intended to be deployed by someone else as a shared, multi-user service.
  5. Experimental hosted, multi-user development lives on the [`multi-user-app` branch](https://github.com/derekrbreese/fantasy-football-mcp-public/tree/multi-user-app). See its [roadmap](https://github.com/derekrbreese/fantasy-football-mcp-public/blob/multi-user-app/docs/MULTI_USER_ROADMAP.md) for planned work toward a possible ChatGPT app. That branch is not a ready-to-deploy shared service; use `main` for personal use.
  6. Note that Yahoo Fantasy Sports API access now requires manual approval from Yahoo, and Yahoo currently provides read access only. Write actions such as adding/dropping players or changing lineups are therefore not part of the tool surface.
  7. ## Core capabilities
  8. - Multi-league Yahoo fantasy football discovery
  9. - League settings and standings
  10. - Team rosters and weekly matchups
  11. - Free-agent and waiver-wire research
  12. - Team comparisons
  13. - Draft rankings, recommendations, and draft-state analysis
  14. - Lineup optimization
  15. - Optional external player-context/enrichment integrations
  16. ## MCP tools
  17. The main FastMCP server currently exposes:
  18. - `ff_get_leagues`
  19. - `ff_get_league_info`
  20. - `ff_get_standings`
  21. - `ff_get_roster`
  22. - `ff_get_matchup`
  23. - `ff_get_players`
  24. - `ff_compare_teams`
  25. - `ff_build_lineup`
  26. - `ff_get_draft_results`
  27. - `ff_get_waiver_wire`
  28. - `ff_get_draft_rankings`
  29. - `ff_get_draft_recommendation`
  30. - `ff_analyze_draft_state`
  31. - `ff_analyze_reddit_sentiment`
  32. The server also contains maintenance tools used for local operation and troubleshooting.
  33. ## Installation
  34. ```bash
  35. git clone https://github.com/derekrbreese/fantasy-football-mcp-public.git
  36. cd fantasy-football-mcp-public
  37. pip install -r requirements.txt
  38. ```
  39. Copy `.env.example` to `.env` and provide your Yahoo developer credentials. Do not commit `.env`, Yahoo token JSON files, OAuth state, refresh tokens, or other authentication artifacts.
  40. ## Yahoo API access
  41. Create the Yahoo developer application as a **Web Application** ("Traditional web app"), not a native/installed app — only web apps are issued the client secret this server needs. See [INSTALLATION.md](INSTALLATION.md) for the full steps.
  42. Creating a Yahoo developer application is no longer sufficient by itself to use the Fantasy Sports API. Apply for Fantasy API access through Yahoo's developer access process and associate the approval with your existing client ID.
  43. Yahoo's current access model is read-only. This project therefore treats league-management recommendations separately from transaction execution.
  44. ## Authentication
  45. The server reads your Yahoo credentials from environment variables:
  46. ```env
  47. YAHOO_CLIENT_ID=...
  48. YAHOO_CLIENT_SECRET=...
  49. YAHOO_ACCESS_TOKEN=...
  50. YAHOO_REFRESH_TOKEN=...
  51. YAHOO_GUID=...
  52. ```
  53. This single-user mode is the supported way to run the app.
  54. ## Running the MCP server
  55. FastMCP HTTP server:
  56. ```bash
  57. python fastmcp_server.py
  58. ```
  59. By default the server listens on port 8000 locally. Cloud platforms can set `PORT`.
  60. Traditional stdio MCP entry point:
  61. ```bash
  62. python fantasy_football_multi_league.py
  63. ```
  64. Docker:
  65. ```bash
  66. docker build -t fantasy-football-mcp .
  67. docker run --env-file .env -p 8080:8080 fantasy-football-mcp
  68. ```
  69. Authentication files and token JSON files are explicitly excluded from the Docker build context.
  70. ## Testing
  71. ```bash
  72. pytest
  73. ```
  74. Credential-isolation tests cover request-scoped token handling and user-namespaced cache keys.
  75. ## Security notes
  76. Even as a single-user app, keep credentials out of the repository:
  77. - Never commit Yahoo access or refresh tokens.
  78. - Never bake your tokens into a container image.
  79. - Keep your Yahoo client secret server-side.
  80. - Rotate any credential that has ever been committed to a public Git history.
  81. If a secret was previously committed, deleting the current file is not sufficient by itself: revoke/rotate the credential and, when appropriate, rewrite the repository history.
  82. ## Project structure
  83. ```text
  84. fantasy-football-mcp-public/
  85. ├── fastmcp_server.py
  86. ├── fantasy_football_multi_league.py
  87. ├── lineup_optimizer.py
  88. ├── matchup_analyzer.py
  89. ├── position_normalizer.py
  90. ├── src/
  91. │ ├── api/
  92. │ │ ├── yahoo_client.py
  93. │ │ └── yahoo_credentials.py
  94. │ ├── agents/
  95. │ ├── handlers/
  96. │ ├── models/
  97. │ ├── services/
  98. │ └── strategies/
  99. ├── tests/
  100. ├── utils/
  101. ├── Dockerfile
  102. └── requirements.txt
  103. ```
  104. ## License
  105. See `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.