Flaim Fantasy, at flaim.app, is an app in ChatGPT and a connector in Claude that reads your real ESPN, Yahoo, and Sleeper fantasy leagues so you can ask about your actual team. 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 is an analyst playbook: how to reason about a start/sit call, a waiver claim, a trade, a keeper, or a matchup preview, and what context to gather in what order. The MCP tools feed it your actual league data and carry their own mechanics (parameters, response fields, platform differences) in their descriptions. 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 is the judgment layer. It covers what Flaim is and cannot do, how to gather league context in order, and a playbook per decision type: start/sit, waivers and pickups, trades, keepers and dynasty, matchup previews, draft picks, season history, and multi-league comparisons. Tool mechanics stay in the tool descriptions and the server instructions, which every MCP client reads live, so the skill does not restate them.
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_draft |
Confirmed draft results and provider-grounded draft-pick ownership |
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 when available, Sleeper evaluates league ownership against current rosters outside live drafts |
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.