Flaim Fantasy

Created By
jdguggs103 months ago
Connect ESPN, Yahoo, and Sleeper fantasy leagues to AI assistants via MCP. Read-only tools for standings, rosters, matchups, free agents, and transactions across football, baseball, basketball, and hockey.
Overview

Flaim Fantasy

License: MIT MCP Tools Chrome Web Store

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

  1. Sign up at flaim.app
  2. Connect your platforms — ESPN via Chrome extension, Yahoo via OAuth, Sleeper by username
  3. Leagues auto-discovered — all your leagues and past seasons are found automatically
  4. Pick a default league for AI conversations
  5. Install the skill — copy .agents/skills/flaim-fantasy/ into your project or home directory (see The Skill below)
  6. Add Flaim to your AI — use the MCP URL in Claude, ChatGPT, or Gemini CLI
  7. 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

ToolWhat it does
get_user_sessionYour leagues across all platforms
get_ancient_historyHistorical leagues and seasons (2+ years old)
get_league_infoLeague settings and members
get_rosterTeam roster with player stats
get_matchupsWeekly matchups and scores
get_standingsLeague standings and rankings
get_free_agentsAvailable free agents sorted by ownership
get_playersPlayer lookup with ownership context
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 or manual cookies
YahooFootball, Baseball, Basketball, HockeyOAuth 2.0
SleeperFootball, Baseball, Basketball, HockeyUsername (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
DocumentDescription
ArchitectureSystem design, deployment, troubleshooting
ChangelogRelease history
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.

Project Info
Created At
3 months ago
Updated At
3 months ago
Author Name
jdguggs10
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Tavily Mcp
@tavily-ai

JavaScript
a year ago
AI Work Market — USDC settlement rails for AI labor on Base Mainnet)
@Dario (DME)

AI Work Market is a USDC escrow protocol on Base Mainnet, designed for autonomous AI agents to find work, post jobs, and settle payments without humans in the loop. This MCP server exposes 10 tools: **Escrow lifecycle** - `create_intent_quote` — get calldata + gas estimate for funding a new escrow intent - `submit_proof_quote` — get calldata for the seller to submit a proof URI - `release_funds_quote` — get calldata for the buyer to release payment (or claim/refund) **x402 single-call binding** - `x402_consume` — replaces the 5-step x402 flow with one HMAC-signed POST that returns a delivery URL **Onboarding & discovery** - `agent_onboard` — generate a signed agent card with marketplace attestation - `agent_search` — tf-idf search over the live agent catalog - `agent_reputation` — server-side reputation from on-chain Released/Refunded/Disputed events **Live state** - `system_status` — live on-chain state (nextIntentId, accumulatedFees, contract balance, owner) - `escrow_rules` — contract semantics, lifecycle, call guides, failure modes - `events_subscribe` — SSE stream of new on-chain intent events All endpoints are serverless (Vercel) and return their schema on GET. No browser, no wallet UI required for an agent to integrate. The protocol takes a 1% commission on every settlement; the rest goes to the seller. The full AgentCard is at `/.well-known/agent-card.json` (A2A-compatible). The OpenAPI 3.0.3 spec is at `/.well-known/openapi.json` with `components.securitySchemes` (none, hmacX402). `robots.txt` allows GPTBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Applebot-Extended, CCBot, Amazonbot.

a day ago