Connect your ESPN, Yahoo, and Sleeper leagues, then use Flaim Fantasy in ChatGPT or Claude for read-only analysis grounded in your real league. Advanced users can also add Flaim manually as a custom connector in compatible AI platforms.
Analysis tools are read-only by design. No trades, no drops, no roster changes — just advice. League refresh can update Flaim's connected-league records so newly available seasons show up.
The Flaim skill teaches your AI assistant how to behave like a fantasy analyst — which data to pull, how to interpret it, and how to turn it into useful advice. The MCP tools feed it your actual league data. Together, they give a general-purpose AI enough structure to answer like it knows your specific league.
- Create your Flaim account at flaim.app.
- Connect your fantasy leagues — ESPN via Chrome extension, Yahoo via Yahoo sign-in, or Sleeper by username. Flaim discovers supported leagues and shows them in Your Leagues.
- Connect your AI app: Open Flaim Fantasy in ChatGPT or Claude, or follow the optional Perplexity custom-connector path in the connection docs. Public setup docs live at flaim.app/docs.
You are done. Ask questions such as "Who should I start this week?" or "What's on the waiver wire?" Defaults and additional league management are optional after setup.
The Flaim skill teaches your AI assistant how to behave like a fantasy analyst — when to use which tools, how to interpret league data, and how to turn that context into useful advice.
Install for Claude Code (or any Agent Skills-compatible tool):
Place the skill in your project's .agents/skills/ directory (cross-platform convention) or in ~/.agents/skills/ for global use:
# Clone or copy the skill directory
cp -r flaim/.agents/skills/flaim-fantasy ~/.agents/skills/flaim-fantasyThe AI will detect and activate the skill automatically when you ask fantasy questions.
| Tool | What it does |
|---|---|
get_user_session |
Your leagues across all platforms |
refresh_leagues |
Re-discover connected leagues and update Flaim's league records |
get_ancient_history |
Past seasons and historical leagues outside the current season |
get_league_info |
Baseline league context: settings, scoring, roster config, teams/owners |
get_roster |
Team roster with player stats |
get_matchups |
Weekly matchups and scores |
get_standings |
League standings and rankings |
get_free_agents |
Available players with a normalized envelope; ESPN/Yahoo include platform-wide ownership percentages, Sleeper returns identities only |
get_players |
Player lookup; ESPN and Yahoo can add league ownership, Sleeper ownership is unavailable |
get_transactions |
Recent adds, drops, waivers, and trades |
All tools connect through a single MCP endpoint: https://api.flaim.app/mcp
| Platform | Sports | Auth |
|---|---|---|
| ESPN | Football, Baseball, Basketball, Hockey | Chrome extension |
| Yahoo | Football, Baseball, Basketball, Hockey | OAuth 2.0 |
| Sleeper | Football, Basketball | Username (public API) |
Chrome Extension → flaim.app → Auth Worker → Supabase
↓
ChatGPT / Claude / manual MCP clients → Fantasy MCP Gateway → ESPN/Yahoo/Sleeper Clients → Platform APIs
- Web App (Next.js on Vercel) — landing/site pages, public live demo, OAuth, league management
- MCP Gateway (Cloudflare Workers) — unified endpoint for all platforms and sports
- Platform Clients (Cloudflare Workers) — ESPN, Yahoo, Sleeper API normalization
- Auth Worker (Cloudflare) — token validation, rate limiting, credential storage
- Supabase — user data, OAuth tokens, credentials
Solo indie project — built with care, maintained for the long term. No VC funding, no growth pressure, just a useful tool for fantasy sports fans who use AI.
git clone https://github.com/jdguggs10/flaim.git
cd flaim
corepack pnpm install
cp web/.env.example web/.env.local # add keys
corepack pnpm run devRoot, web, and workers use pnpm via Corepack. The Chrome extension is intentionally npm-isolated under extension/ with its own lockfile and release flow.
| Document | Description |
|---|---|
| Architecture | System design, deployment, troubleshooting |
| Changelog | Release history |
| Connection Docs | ChatGPT and Claude links plus optional custom-connector guidance (public version: flaim.app/docs) |
| Web App | Next.js routes, components, environment |
| Workers | Cloudflare Workers, MCP tools, ESPN API |
| Extension | Chrome extension build, Sync Host, CWS |
Best-effort support — I'll respond when I can.
MIT License — see LICENSE.