{
  "markdown": "# Flaim Fantasy\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![MCP Tools](https://img.shields.io/badge/MCP_Tools-11-green.svg)](https://api.flaim.app/mcp)\n[![Chrome Web Store](https://img.shields.io/badge/Chrome_Extension-v1.5.2-yellow.svg)](https://chromewebstore.google.com/detail/flaim-espn-fantasy-connec/mbnokejgglkfgkeeenolgdpcnfakpbkn)\n\nConnect 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.\n\nAnalysis 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.\n\n## How It Works\n\nThe **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.\n\n## Get Started\n\n1. **Create your Flaim account** at [flaim.app](https://flaim.app).\n2. **Connect your fantasy leagues** — ESPN via [Chrome extension](https://chromewebstore.google.com/detail/flaim-espn-fantasy-connec/mbnokejgglkfgkeeenolgdpcnfakpbkn), Yahoo via Yahoo sign-in, or Sleeper by username. Flaim discovers supported leagues and shows them in [Your Leagues](https://flaim.app/leagues).\n3. **Connect your AI app:** Open Flaim Fantasy in [ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_69a8f78087e081919e52cacacf00ff36) or [Claude](https://claude.ai/directory/connectors/f1a5b6a4-1f5b-470c-af23-71fc7ab13754), or follow the optional Perplexity custom-connector path in the [connection docs](docs/CONNECTOR-DOCS.md). Public setup docs live at [flaim.app/docs](https://flaim.app/docs).\n\nYou 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.\n\n## The Skill\n\nThe 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.\n\n**Install for Claude Code (or any Agent Skills-compatible tool):**\n\nPlace the skill in your project's `.agents/skills/` directory (cross-platform convention) or in `~/.agents/skills/` for global use:\n\n```bash\n# Clone or copy the skill directory\ncp -r flaim/.agents/skills/flaim-fantasy ~/.agents/skills/flaim-fantasy\n```\n\nThe AI will detect and activate the skill automatically when you ask fantasy questions.\n\n## MCP Tools\n\n| Tool | What it does |\n|------|-------------|\n| `get_user_session` | Your leagues across all platforms |\n| `refresh_leagues` | Re-discover connected leagues and update Flaim's league records |\n| `get_ancient_history` | Past seasons and historical leagues outside the current season |\n| `get_league_info` | Baseline league context: settings, scoring, roster config, teams/owners |\n| `get_draft` | Confirmed draft results and provider-grounded draft-pick ownership |\n| `get_roster` | Team roster with player stats |\n| `get_matchups` | Weekly matchups and scores |\n| `get_standings` | League standings and rankings |\n| `get_free_agents` | Available players with a normalized envelope; ESPN/Yahoo include platform-wide ownership percentages, Sleeper returns identities only |\n| `get_players` | Player lookup; ESPN and Yahoo can add league ownership, Sleeper ownership is unavailable |\n| `get_transactions` | Recent adds, drops, waivers, and trades |\n\nAll tools connect through a single MCP endpoint: `https://api.flaim.app/mcp`\n\n## Supported Platforms\n\n| Platform | Sports | Auth |\n|----------|--------|------|\n| **ESPN** | Football, Baseball, Basketball, Hockey | Chrome extension |\n| **Yahoo** | Football, Baseball, Basketball, Hockey | OAuth 2.0 |\n| **Sleeper** | Football, Basketball | Username (public API) |\n\n## Architecture\n\n```\nChrome Extension → flaim.app → Auth Worker → Supabase\n                      ↓\nChatGPT / Claude / manual MCP clients → Fantasy MCP Gateway → ESPN/Yahoo/Sleeper Clients → Platform APIs\n```\n\n- **Web App (Next.js on Vercel)** — landing/site pages, public live demo, OAuth, league management\n- **MCP Gateway (Cloudflare Workers)** — unified endpoint for all platforms and sports\n- **Platform Clients (Cloudflare Workers)** — ESPN, Yahoo, Sleeper API normalization\n- **Auth Worker (Cloudflare)** — token validation, rate limiting, credential storage\n- **Supabase** — user data, OAuth tokens, credentials\n\n## About\n\nSolo 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.\n\n## Development\n\n```bash\ngit clone https://github.com/jdguggs10/flaim.git\ncd flaim\ncorepack pnpm install\ncp web/.env.example web/.env.local  # add keys\ncorepack pnpm run dev\n```\n\nRoot, web, and workers use `pnpm` via Corepack. The Chrome extension is intentionally npm-isolated under `extension/` with its own lockfile and release flow.\n\n| Document | Description |\n|----------|-------------|\n| [Architecture](docs/ARCHITECTURE.md) | System design, deployment, troubleshooting |\n| [Changelog](docs/CHANGELOG.md) | Release history |\n| [Connection Docs](docs/CONNECTOR-DOCS.md) | ChatGPT and Claude links plus optional custom-connector guidance (public version: [flaim.app/docs](https://flaim.app/docs)) |\n| [Web App](web/README.md) | Next.js routes, components, environment |\n| [Workers](workers/README.md) | Cloudflare Workers, MCP tools, ESPN API |\n| [Extension](extension/README.md) | Chrome extension build, Sync Host, CWS |\n\n## Getting Help\n\nBest-effort support — I'll respond when I can.\n\n- [GitHub Issues](https://github.com/jdguggs10/flaim/issues)\n- [GitHub Discussions](https://github.com/jdguggs10/flaim/discussions)\n\n## License\n\nMIT License — see [LICENSE](LICENSE).\n",
  "bytes": 6014,
  "sha": "42567fc587bb8bf0299b182c67f9f87f4d39b4f2d56618775676bb5c0228b1eb",
  "repo_slug": "jdguggs10/flaim",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jdguggs10_flaim_cf3a915c/readme"
}