Fantasy Platform Setup

Flaim connects to ESPN via Chrome extension, Yahoo via OAuth, and Sleeper via username — all from /leagues.

Last updated March 2026

Connect your fantasy platforms in /leagues before adding Flaim to your AI assistant. Each platform connects differently, but the goal is the same: get your leagues visible in Flaim so your AI can use them.

Before you start

  • Sign in to Flaim and open /leagues.
  • Use the account that actually owns or participates in the leagues you want.
  • Supported sports: football, baseball, basketball, and hockey (ESPN and Yahoo). Sleeper supports football and basketball.

ESPN

ESPN is the highest-friction setup because ESPN does not offer a public fantasy API. The Chrome extension is the cleanest path. Manual cookie entry exists as a fallback. Your ESPN credentials are never shared with AI providers.

  1. Open /leagues and choose ESPN.
  2. Preferred: install the Flaim Chrome extension, sign in to fantasy.espn.com in that browser profile, then trigger Sync from the extension.
  3. Fallback: use the manual credential path in the ESPN card and paste your SWID and ESPN_S2 values.
  4. If Flaim asks for league IDs, add the private leagues you care about and run verification again.
  5. Wait until your ESPN leagues show up before moving on to AI setup.

ESPN troubleshooting

  • Sync succeeds but no leagues show up: make sure you are logged into the correct ESPN account and try the sync again.
  • Private league still missing: add the league ID manually from the ESPN flow in /leagues.
  • Credentials expire or become invalid later: rerun extension sync or replace the manual cookies.

Yahoo

Yahoo is the simplest private-platform setup. Start OAuth from /leagues, approve access, and wait for league discovery to finish.

  1. Open /leagues and choose Yahoo.
  2. Start Yahoo authentication and approve Flaim's access request.
  3. Return to Flaim and wait for discovery to finish. Auth success does not mean your leagues are ready yet.
  4. Confirm that the Yahoo section shows leagues you can use.

Yahoo troubleshooting

  • Auth completed but Flaim still looks disconnected: retry from /leagues and make sure the popup or redirect fully finishes.
  • Auth worked but zero leagues appear: confirm the Yahoo account has supported active leagues and reconnect.
  • Yahoo worked before and stopped: reconnect to refresh access.

Sleeper

Sleeper uses a public API, so there is no extension and no OAuth. The important part is using your exact username (not your display name) and knowing that Flaim supports football and basketball on Sleeper.

  1. Open /leagues and choose Sleeper.
  2. Enter your exact username and submit.
  3. Wait for discovery to finish and confirm leagues show up in Flaim.

Sleeper troubleshooting

  • Flaim says user not found: verify the exact username (not display name) and try again.
  • Connected but no leagues appear: confirm the account has football or basketball leagues.
  • Older leagues are missing: start by testing a current league first. Historical coverage through Sleeper's history chain may take time.

How to know it worked

  • Your platform connection in /leagues shows leagues you can use, not just a pending state.
  • You can identify the league you want to analyze first.
  • After connecting your AI, a fresh chat can answer “What leagues do I have?” without an auth error.

What happens next

Once your leagues are visible in Flaim, add Flaim to your AI assistant with https://api.flaim.app/mcp. Start a new chat and ask about your roster, matchup, or standings. If you use multiple leagues, name the one you want in your first prompt.