Back to Browse

Flaim MCP Server

Developer ToolsModerate5.8MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Read-only fantasy analysis for ESPN, Yahoo, and Sleeper leagues via MCP

About

Read-only fantasy analysis for ESPN, Yahoo, and Sleeper leagues via MCP

Remote endpoints: streamable-http: https://api.flaim.app/mcp

Security Report

5.8
Moderate5.8Moderate Risk

This is a well-designed fantasy sports MCP server that connects to ESPN, Yahoo, and Sleeper APIs. The code demonstrates good security practices including proper authentication handling via Clerk, secure credential management, and appropriate permissions scoped to fantasy sports functionality. Minor findings relate to error handling patterns and dependency management, but do not significantly impact security. Supply chain analysis found 6 known vulnerabilities in dependencies.

4 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Flaim Fantasy

License: MIT MCP Tools Chrome Web Store

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.

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

  1. Create your Flaim account at flaim.app.
  2. 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.
  3. 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 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-fantasy

The AI will detect and activate the skill automatically when you ask fantasy questions.

MCP Tools

ToolWhat it does
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
get_standingsLeague standings and rankings
get_free_agentsAvailable players with a normalized envelope; ESPN/Yahoo include platform-wide ownership percentages, Sleeper returns identities only
get_playersPlayer lookup; ESPN and Yahoo can add league ownership, Sleeper ownership is unavailable
get_transactionsRecent adds, drops, waivers, and trades

All tools connect through a single MCP endpoint: https://api.flaim.app/mcp

Supported Platforms

PlatformSportsAuth
ESPNFootball, Baseball, Basketball, HockeyChrome extension
YahooFootball, Baseball, Basketball, HockeyOAuth 2.0
SleeperFootball, BasketballUsername (public API)

Architecture

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

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.

DocumentDescription
ArchitectureSystem design, deployment, troubleshooting
ChangelogRelease history
Connection DocsChatGPT and Claude links plus optional custom-connector guidance (public version: flaim.app/docs)
Web AppNext.js routes, components, environment
WorkersCloudflare Workers, MCP tools, ESPN API
ExtensionChrome extension build, Sync Host, CWS

Getting Help

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

License

MIT License — see LICENSE.

Reviews

No reviews yet

Be the first to review this server!