Flaim - Fantasy Sports AI Connector
Connect ESPN & Yahoo fantasy leagues to Claude, ChatGPT, and Gemini via MCP
Ask AI about Flaim - Fantasy Sports AI Connector
Powered by Claude Β· Grounded in docs
I know everything about Flaim - Fantasy Sports AI Connector. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Flaim Fantasy
Bring your fantasy league into ChatGPT, Claude, and Gemini CLI β with expert analyst guidance built in. Flaim combines a fantasy analyst skill with live ESPN, Yahoo, and Sleeper data via MCP so you get real advice, not just raw stats.
Read-only. No trades, no drops, no roster changes β just analysis.
How It Works
The Flaim skill teaches your AI assistant how to be an expert fantasy analyst β when to pull which data, how to interpret it, and how to give actionable advice. The MCP tools feed it your actual league data. Together, they turn a general-purpose AI into a fantasy expert that knows your specific team.
Get Started
- Sign up at flaim.app
- Connect your platforms β ESPN via Chrome extension, Yahoo via OAuth, Sleeper by username
- Leagues auto-discovered β all your leagues and past seasons are found automatically
- Pick a default league for AI conversations
- Install the skill β copy
.agents/skills/flaim-fantasy/into your project or home directory (see The Skill below) - Add Flaim to your AI β use the MCP URL in Claude, ChatGPT, or Gemini CLI
- Ask questions β "Who should I start this week?", "What's on the waiver wire?", etc.
The Skill
The Flaim skill teaches your AI assistant how to be an expert fantasy analyst β when to use which tools, how to interpret league data, and how to give actionable 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-fantasy
The AI will detect and activate the skill automatically when you ask fantasy questions.
MCP Tools
| Tool | What it does |
|---|---|
get_user_session | Your leagues across all platforms |
get_ancient_history | Historical leagues and seasons (2+ years old) |
get_league_info | League settings and members |
get_roster | Team roster with player stats |
get_matchups | Weekly matchups and scores |
get_standings | League standings and rankings |
get_free_agents | Available free agents sorted by ownership |
get_players | Player lookup with ownership context |
get_transactions | Recent adds, drops, waivers, and trades |
All tools connect through a single MCP endpoint: https://api.flaim.app/mcp
Supported Platforms
| Platform | Sports | Auth |
|---|---|---|
| ESPN | Football, Baseball, Basketball, Hockey | Chrome extension or manual cookies |
| Yahoo | Football, Baseball, Basketball, Hockey | OAuth 2.0 |
| Sleeper | Football, Basketball | Username (public API) |
Architecture
Chrome Extension β flaim.app β Auth Worker β Supabase
β
Claude/ChatGPT/Gemini CLI β Fantasy MCP Gateway β ESPN/Yahoo/Sleeper Clients β Platform APIs
- Web App (Next.js on Vercel) β dashboard, 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
About
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.
Development
git clone https://github.com/jdguggs10/flaim.git
cd flaim && npm install
cp web/.env.example web/.env.local # add keys
npm run dev
| Document | Description |
|---|---|
| Architecture | System design, deployment, troubleshooting |
| Changelog | Release history |
| Web App | Next.js routes, components, environment |
| Workers | Cloudflare Workers, MCP tools, ESPN API |
| Extension | Chrome extension build, Sync Host, CWS |
Getting Help
Best-effort support β I'll respond when I can.
License
MIT License β see LICENSE.
