Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

Flaim Fantasy

REMOTE · API.FLAIM.APP · SCANNED AUG 3

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

Available components

+8 this week 68 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security78
Transport & Reachability100
Schema Quality & AI Usability37
  • 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Fail
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 4117 tokens (~343/item across 12 items; 10 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
  • Supports UI / widget rendering.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · api.flaim.app

# add to Claude Code
claude mcp add --transport http app-flaim-mcp https://api.flaim.app/mcp
# ~/.codex/config.toml
[mcp_servers.app-flaim-mcp]
url = "https://api.flaim.app/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "app-flaim-mcp": {
      "type": "remote",
      "url": "https://api.flaim.app/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add app-flaim-mcp --url https://api.flaim.app/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  app-flaim-mcp:
    url: "https://api.flaim.app/mcp"
// mcp.json
{
  "mcpServers": {
    "app-flaim-mcp": {
      "type": "http",
      "url": "https://api.flaim.app/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +1
    • Tool “get_free_agents” rewrote its description, which is the text the model reads security
    • Tool “get_transactions” rewrote its description, which is the text the model reads security
    • Tool “get_standings” rewrote its description, which is the text the model reads security
    • Tool “get_roster” rewrote its description, which is the text the model reads security
    • Tool “get_players” rewrote its description, which is the text the model reads security
    • Tool “get_matchups” rewrote its description, which is the text the model reads security
    • Tool “get_league_info” rewrote its description, which is the text the model reads security
  • 2 Aug 26 0
    • Tool “get_league_info” rewrote its description, which is the text the model reads security
    • Tool “get_transactions” rewrote its description, which is the text the model reads security
    • Tool “get_standings” rewrote its description, which is the text the model reads security
    • Tool “get_roster” rewrote its description, which is the text the model reads security
    • Tool “get_players” rewrote its description, which is the text the model reads security
    • Tool “get_matchups” rewrote its description, which is the text the model reads security
    • Tool “get_free_agents” rewrote its description, which is the text the model reads security
  • 1 Aug 26 +1
    • Tool “get_standings” rewrote its description, which is the text the model reads security
    • Tool “get_transactions” rewrote its description, which is the text the model reads security
    • Tool “get_free_agents” rewrote its description, which is the text the model reads security
    • Tool “get_league_info” rewrote its description, which is the text the model reads security
    • Tool “get_matchups” rewrote its description, which is the text the model reads security
    • Tool “get_players” rewrote its description, which is the text the model reads security
    • Tool “get_roster” rewrote its description, which is the text the model reads security
  • 31 Jul 26 +5
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 29 Jul 26 0
    • Tool “get_standings” rewrote its description, which is the text the model reads security
    • Tool “get_roster” rewrote its description, which is the text the model reads security
    • Tool “get_players” rewrote its description, which is the text the model reads security
    • Tool “get_matchups” rewrote its description, which is the text the model reads security
    • Tool “get_free_agents” rewrote its description, which is the text the model reads security
    • Tool “get_league_info” rewrote its description, which is the text the model reads security
    • Tool “get_transactions” rewrote its description, which is the text the model reads security
  • 28 Jul 26 +1
    • Tool “get_matchups” rewrote its description, which is the text the model reads security
    • Tool “get_free_agents” rewrote its description, which is the text the model reads security
    • Tool “get_transactions” rewrote its description, which is the text the model reads security
    • Tool “get_players” rewrote its description, which is the text the model reads security
    • Tool “get_league_info” rewrote its description, which is the text the model reads security
    • Tool “get_standings” rewrote its description, which is the text the model reads security
    • Tool “get_roster” rewrote its description, which is the text the model reads security
  • 27 Jul 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://api.flaim.app/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=flaim.app CN=WE1,O=Google Trust Services,C=US 27 Jun 2026 25 Sept 2026 ECDSA 256 ECDSA-SHA256 94acea9e61d84b0c135a2c1f2d31b11a
SANs: flaim.app, *.flaim.app
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b
DNSSEC insecure

Validation of api.flaim.app. Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
app. present 23684 8 Verified
flaim.app. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication Enforced and verified

The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.

Result Enforced and verified
Enforced On tool calls
HTTP status 200

WWW-Authenticate challenge Bearer realm="fantasy-mcp", resource="https://api.flaim.app/mcp", resource_metadata="https://api.flaim.app/.well-known/oauth-protected-resource"

Bearer realm="fantasy-mcp", resource="https://api.flaim.app/mcp", resource_metadata="https://api.flaim.app/.well-known/oauth-protected-resource"

Protected resource metadata

Document https://api.flaim.app/.well-known/oauth-protected-resource
Retrieved Yes
Resource https://api.flaim.app/mcp
Authorisation server https://api.flaim.app
Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://api.flaim.app/mcp Verified 200
http (plaintext) http://api.flaim.app/mcp Inconclusive 405
MCP tools — 10 exposed · ~3,344 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
get_ancient_history ~87

Use this only after get_user_session, and only when the user is clearly asking about a non-current season or an inactive league. This is the historical branch: it returns past seasons and historical leagues outside the current season view. Use for last season, older seasons, inactive leagues, or historical performance. Read-only.

NameTypeReqDescription
platformstringOptional: filter to specific platform
NameTypeReqDescription
oldLeaguesarrayyes
oldSeasonsFromActiveLeaguesobjectyes
successbooleanyes
thresholdYearnumberyes
totalOldLeaguesnumberyes
totalOldSeasonsnumberyes
warningsarray

No examples provided.

get_free_agents ~517

Get players available to acquire in the specified fantasy league, optionally filtered by position. This is fantasy-league availability, not professional-contract status. ESPN percentOwned/percentStarted are the percentages of all ESPN leagues where the player is rostered/started, not the share of rostered teams that start him. Yahoo percentOwned, when present, is Yahoo-wide; none is ownership within the selected league, and Sleeper provides no percentage. Label every reported percentage as an ESPN-wide roster/start rate or Yahoo-wide market rate. If a rate is missing, write "[Provider] market ownership rate: not provided"; do not repeat response field names or null values, call get_players, or offer a lookup. team/proTeam is the real-life club (FA means the provider lists no current pro team). Only ESPN status/waiverProcessDate represents fantasy acquisition state here. Call Yahoo/Sleeper rows "available players," never specifically free agents or waivers, and do not promise an immediate add. A returned player is already confirmed available in that league. For a returned list or field explanation, end after the requested facts—never add an "if you want" offer, qualitative ranking, recommendation, role, health, trend, or outlook. Translate ESPN status codes silently into plain language; never print raw codes such as FREEAGENT or WAIVERS. Use current web evidence before adding analysis or pickup recommendations. Follow get_user_session then get_league_info for the selected league; fan out once per league for comparisons. Use get_roster for a separate player-ownership question. Requires authentication on ESPN/Yahoo; Sleeper uses the public API. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
countnumberMaximum number of players to return (max: 100). Pass the user-requested number exactly; omit only when no number was requested (default: 25).
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform — "espn", "yahoo", or "sleeper"
positionstringFilter by position (e.g., "QB", "RB", "SP", "C"). Default: ALL
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_league_info ~245

For a selected active league, call this immediately after get_user_session and before the requested standings, matchup, roster, free-agent, player, or transaction tool. Skip it only when answering from session data alone or branching to get_ancient_history. This provides the baseline league context for analysis: league name, settings, scoring type, roster configuration, and team/owner context, plus schedule or season-window metadata when the platform provides it. When fanning out across multiple leagues, call this once per league. The exact team fields vary by platform but all include ownerName. Use values from get_user_session. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_matchups ~209

Get matchups/scoreboard for a specific week or the current week. Best used after get_user_session and after get_league_info for the specified league so the model already knows the league's team names, owner/team mapping, and league context before interpreting the matchup. For multi-league comparisons, call once per league. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
weekintegerWeek number (optional, must be ≥ 1, defaults to current week)
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_players ~353

Search for player identity by name. Always returns identity fields, but ownership context varies by platform. ESPN and Yahoo return market/global ownership and can also populate league ownership fields when credentials and league context are available. Sleeper returns identity plus ownership_scope="unavailable" with market_percent_owned=null. For a selected active league, call this after get_user_session and get_league_info so league-specific ownership and team names can be resolved. League ownership fields: league_status ("ROSTERED" = on a team, "FREE_AGENT" = available, null = unavailable), league_team_name (fantasy team name if rostered), league_owner_name (team owner if rostered). When those league fields are absent, null, or unavailable, fall back to get_roster to verify manually. Use values from get_user_session. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
countnumberMaximum number of players to return (default: 10, max: 25)
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
positionstringFilter by position (e.g., "QB", "RB", "SP", "C"). Default: ALL
querystringyesPlayer name search string (minimum 2 characters)
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_roster ~520

Get roster details for a specific team — current by default, historical on request. Exact payload varies by platform: ESPN and Yahoo return player entries with lineup/position context, while Sleeper returns starters, bench, reserve, taxi, and record metadata for the selected roster. Historical snapshots: pass week for football (all platforms) and Sleeper basketball (matchup week), or as_of_date (YYYY-MM-DD) for ESPN/Yahoo baseball, basketball, and hockey — never both; an invalid selector returns a corrective error naming the right one. Every response includes a snapshot block identifying what was returned (current vs week vs date); historical responses may add limitation flags (acquisitionMetadataAvailable, reserveAndTaxiClassificationAvailable) when provider history omits those details. For "roster during matchup week N" questions in daily sports, ask the user for a specific date rather than guessing — one matchup spans several daily rosters. Best used after get_user_session and after get_league_info for the specified league so the model already knows the league's team names, owner/team mapping, league settings, and roster context before interpreting this roster. Requires authentication except on Sleeper's public API. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
as_of_datestringHistorical 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 we…
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
team_idstringTeam 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.
weeknumberHistorical 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 cur…
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_standings ~438

Get season standings and outcome snapshot; includes verified season-outcome fields when available. Returns team records, rankings, and points summaries. The rank field is a standings sort position (1 = best): on ESPN and Sleeper it is computed by Flaim from win percentage; on Yahoo it is passed through from Yahoo's own standings API. It is NOT a verified postseason finish. For verified postseason outcome, use finalRank and championshipWon instead. Also returns seasonPhase (regular_season/playoffs_in_progress/season_complete), seasonComplete, and per-team outcome fields: finalRank, championshipWon, playoffOutcome, outcomeConfidence, madePlayoffs, playoffSeed. Outcome fields are null when not verifiable — do not infer championship from rank or team name. outcomeConfidence is 'explicit' when the platform reports final ranks, or 'derived' when the champion and runner-up were determined from the final winners-bracket matchup (ESPN historical seasons may omit final ranks); a tied championship game is resolved using the league's playoff tie rule (ESPN's default advances the higher seed). Note: playoffOutcome returns 'in_progress' on Sleeper for teams in active playoffs; ESPN and Yahoo return null for that state. ESPN may also include projected-rank fields. Best used after get_user_session and after get_league_info for the specified league so team names and league context are already established. For multi-league comparisons, call once per league. For historical finish questions, call get_ancient_history first to discover seasons, then call this tool per season for verified outcomes. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_transactions ~528

Get recent league transactions including adds, drops, waivers, and trades. Best used after get_user_session and usually after get_league_info so the model already knows the league's team names and owner/team mapping before summarizing activity. Each normalized transaction includes a date field (YYYY-MM-DD), type, status, week, and optional team_ids. When presenting results, organize by time period (today, yesterday, this week, older) AND by team within each period so the user can see both when moves happened and what each team did. Week handling is platform-specific: ESPN/Sleeper use week windows (default current + previous week), while Yahoo uses a recent 14-day timestamp window and ignores explicit week. Type support is also platform-specific: Sleeper supports add/drop/trade/waiver; Yahoo supports add/drop/trade plus pending waiver/pending_trade views for the authenticated user's own items; ESPN also supports failed_bid and trade lifecycle types (trade_proposal, trade_decline, trade_veto, trade_uphold). ESPN uses mTransactions2 for structured transaction data, and accepted trade player details are supplemented from the activity feed. ESPN responses include a "teams" map (team ID → display name) to resolve the numeric team_ids on each transaction, while Yahoo and Sleeper generally rely on get_league_info for team-name resolution. Use values from get_user_session. Read-only. Current date is 2026-08-03.

NameTypeReqDescription
countnumberMaximum transactions to return (default: 25, max: 100)
league_idstringyesLeague ID (get from get_user_session)
platformstringyesFantasy platform (e.g., "espn", "yahoo", "sleeper")
season_yearnumberyesSeason 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
sportstringyesSport type (e.g., "football", "baseball")
typestringOptional transaction type filter. Platform support varies: Sleeper supports add/drop/trade/waiver; Yahoo supports add/drop/trade plus waiver/pending_trade for the authenticated user's own pending ite…
weekintegerWeek/scoring-period number (optional, 0 = preseason). ESPN/Sleeper support explicit week; Yahoo ignores week and uses a recent 14-day timestamp window
NameTypeReqDescription
dataobjectyesPlatform envelope. Field availability varies by platform (ESPN, Yahoo, Sleeper); absent fields are not provided by that platform.
successbooleanyes

No examples provided.

get_user_session ~291

Use this alone for user-specific connection, league, or account-status questions, and use it as the first data tool when a request needs the user's connected fantasy league data. Do not call for Flaim capability, permission, or generic setup how-to questions, and do not call for generic coding, scraping, weather, travel, betting, sports news, or other requests that do not need connected league data. For a normal selected-league request, call this once before any other data tool. For an explicit refresh request, call refresh_leagues first and then call this tool after success; call it again even if it ran earlier in the chat. Returns the user's full league landscape: allLeagues (all active leagues), defaultLeagues (per-sport defaults), and defaultLeague (populated only when a single league exists or defaultSport matches). For vague singular prompts, use defaultLeague when present; otherwise use the relevant sport entry in defaultLeagues. For explicit plural or comparative prompts (each, all, compare, across leagues/platforms), enumerate every matching league in allLeagues and call the target tool once per league. For a selected active league, call get_league_info next before the requested league-specific data tool. Skip get_league_info only when answering from session data alone or branching to get_ancient_history. season_year always represents the start year of the season. Read-only.

Input schema present but exposes no named parameters.

NameTypeReqDescription
allLeaguesarrayyes
currentDatestringyes
currentSeasonsobjectyes
defaultLeagueyes
defaultLeaguesobjectyes
defaultSportstring|nullyes
instructionsstringyes
leaguesBySportobjectyes
successbooleanyes
timezonestringyes
totalLeaguesFoundnumberyes
warningsarray

No examples provided.

refresh_leagues ~156

Refresh connected fantasy leagues by asking Flaim to rediscover leagues through connected ESPN, Yahoo, and Sleeper accounts. Use only when the user explicitly asks to refresh or after the user presses the widget refresh button. This is non-destructive, but repeated refreshes can update Flaim registry timestamps and provider metadata; it does not change provider lineups or rosters, add or drop players, submit waiver claims or trades, or modify league settings. If this call succeeds, call get_user_session again to show the updated league list. If it fails, follow the error retry guidance and any retry_after value; do not retry in a loop.

NameTypeReqDescription
platformsarrayOptional platforms to refresh. Omit to refresh every connected platform.
NameTypeReqDescription
requestedPlatformsarray
resultsobjectPer-platform refresh outcome keyed by platform name
successbooleanyes

No examples provided.