Flaim Fantasy Sports AI Connector
Connect ESPN & Yahoo fantasy leagues to Claude, ChatGPT, and Gemini via MCP
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
%5D(LICENSE%22%7D){kind=link}
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Capabilities & Tool Schemas (10)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Flaim Fantasy Sports AI Connector.
get_user_sessionYour leagues across all platforms
refresh_leaguesRe-discover connected leagues and update Flaim's league records
get_ancient_historyPast seasons and historical leagues outside the current season
get_league_infoBaseline league context: settings, scoring, roster config, teams/owners
get_rosterTeam roster with player stats
get_matchupsWeekly matchups and scores
Documentation Overview
Flaim Fantasy
Connect your ESPN, Yahoo, and Sleeper leagues, then use Flaim Fantasy in ChatGPT 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.
How It Works
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.
Get Started
- Sign up at flaim.app
- Connect your platforms — ESPN via Chrome extension, Yahoo via OAuth, Sleeper by username
- Leagues discovered — Flaim finds supported leagues where possible; confirm and manage them at flaim.app/leagues
- Pick a default league for AI conversations
- Use Flaim in AI — open Flaim Fantasy in ChatGPT, or use the optional custom-connector URL with a compatible AI platform (see Connector Setup)
- Optional: install the skill — recommended for agent-skill tools; copy
.agents/skills/flaim-fantasy/into your project or home directory (see The Skill below) - 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 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:
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 |
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
Supported Platforms
| Platform | Sports | Auth |
|---|---|---|
| ESPN | Football, Baseball, Basketball, Hockey | Chrome extension |
| Yahoo | Football, Baseball, Basketball, Hockey | OAuth 2.0 |
| Sleeper | Football, Basketball | Username (public API) |
Architecture
- 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
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
Root, 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 |
| Connector Setup | Official ChatGPT setup plus optional custom-connector guidance |
| 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.
Related MCP Servers
Frequently Asked Questions about Flaim Fantasy Sports AI Connector
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/flaim-fantasy-sports-ai-connector)HTML Embed
<a href="https://allmcps.com/mcp/flaim-fantasy-sports-ai-connector"><img src="https://allmcps.com/api/badge/flaim-fantasy-sports-ai-connector?style=directory" alt="Flaim Fantasy Sports AI Connector on AllMCPs" /></a>Technical Specs & Signals
CategoryCommunication
53Quality signal: Good · 53/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools24/30
Adoption & activity6/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge.
Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.