app.flaim/mcp — Model Context Protocol Server for Flaim Fantasy

The app.flaim/mcp server provides read-only fantasy analysis for ESPN, Yahoo, and Sleeper leagues using the Model Context Protocol (MCP). It enables analysis in ChatGPT or Claude grounded in a user’s actual league data, with tooling exposed for integration.

🛠️ Key Features

Read-only access to fantasy leagues
Supports ESPN, Yahoo, and Sleeper leagues
MCP tool interface (10 tools)
Topics include model-context-protocol and cloudflare-workers

🚀 Use Cases

Run fantasy analysis in ChatGPT or Claude
Use league-specific context for ESPN, Yahoo, and Sleeper
Reference and explore available MCP tools for sports analysis

⚡ Developer Benefits

Model Context Protocol server for a fantasy-sports workflow
Designed for developer consumption via MCP tools (10)
Integration alignment with Next.js and custom connectors

⚠️ Limitations

Explicitly read-only analysis (no write/edit implied) for connected leagues
Custom connector support is noted, but details are truncated in the excerpt

Flaim Fantasy

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.

How It Works

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.

Get Started

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 Skill

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: the plugin bundles the skills and the MCP server.

bash

claude plugin marketplace add jdguggs10/flaim
claude plugin install flaim-fantasy@flaim

Then run /mcp in Claude Code and choose the Flaim server to sign in. To add only the MCP server, run claude mcp add --transport http flaim https://api.flaim.app/mcp.

Other Agent Skills-compatible tools: place the skill in your project's .agents/skills/ directory or in ~/.agents/skills/ for global use. Claude Code reads .claude/skills/ instead.

bash

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
`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

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

code

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

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

bash

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 dev

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
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

Getting Help

Best-effort support — I'll respond when I can.

License

MIT License — see LICENSE.

platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	number	required	Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).

platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	integer	optional	Season start year. Omit for the current sport season; use the season_year returned by get_user_session for this league or a past draft. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).
draft_id	string	optional	Optional Sleeper draft ID. Omit to retrieve the league's associated draft; pass only an ID previously returned by Flaim.
round	integer	optional	Optional positive draft round. Returns only completed selections and ownership rows from this round.
team_id	string	optional	Optional provider team ID. Filters completed selections by historical selecting team and ownership rows by current owner.

platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	number	required	Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).

platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	number	required	Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).
week	integer	optional	Week number (optional, must be ≥ 1, defaults to current week)
team_id	string	optional	Required with detail: "players" to select one matchup; do not provide for summary mode.
detail	string	optional	Opt-in compact player detail for one selected ESPN football matchup, season_year 2018 or later only; requires week and team_id.

platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	number	required	Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).
team_id	string	optional	Team ID for the target roster. Recommended for all platforms; required on Yahoo and for historical Sleeper rosters. If omitted, platform behavior varies and may not resolve to the user's team.
week	number	optional	Historical weekly roster snapshot (positive integer). Football on all platforms, plus Sleeper basketball (matchup week). Not valid for ESPN/Yahoo daily sports — use as_of_date there. Omit for the current roster; pass at most one of week or as_of_date.
as_of_date	string	optional	Historical calendar-day roster snapshot in YYYY-MM-DD format. ESPN and Yahoo baseball, basketball, and hockey only — football and Sleeper use week. Omit for the current roster; pass at most one of week or as_of_date.

Flaim Fantasy

app.flaim/mcp — Model Context Protocol Server for Flaim Fantasy

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_user_session

refresh_leagues

get_ancient_history

get_league_info

get_draft

get_standings

get_matchups

get_roster

get_free_agents

get_players

get_transactions

Flaim Fantasy

How It Works

Get Started

The Skill

MCP Tools

Supported Platforms

Architecture

About

Development

Getting Help

License

Install

Remote endpoint

Related servers

query	string	required	Player name search string (minimum 2 characters)
platform	string	required	Fantasy platform (e.g., "espn", "yahoo", "sleeper")
sport	string	required	Sport type (e.g., "football", "baseball")
league_id	string	required	League ID (get from get_user_session)
season_year	number	required	Season start year — use the season_year returned by get_user_session for this league; only pass an older year when the user explicitly asks about a past season. Basketball and hockey use the start year of a cross-year season (2024 = the 2024-25 season); football and baseball use the single season year (2025 = the 2025 season).
position	string	optional	Filter by position (e.g., "QB", "RB", "SP", "C"). Default: ALL
count	number	optional	Maximum number of players to return (default: 10, max: 25)