Sleeper API MCP for fantasy football data retrieval
18 tools with complete JSON Schema definitions and consistent naming (verb_noun pattern). All tools are READ_ONLY and properly described. However, descriptions are generic (avg ~60 chars, well below the 194-char baseline for A+ tools) and lack context about when to use each tool vs. similar ones. Parameter descriptions are minimal. Output schemas are not documented. No error handling guidance. Missing idempotent/readOnly annotations. Tool composition is reasonable but lacks chaining hints (e.g., getUserLeagues returns league_id, which feeds getLeagueInfo, but this dependency is not documented).
Fetches information about all players for a specific sport
Fetches information about a specific draft
Fetches all picks in a draft
Fetches all traded picks in a draft
Fetches all drafts for a league
Fetches information about a specific league
Fetches the playoff losers bracket for a league
Descriptions are too generic and lack LLM-optimized context. Most descriptions are 30-60 chars (well below 194-char baseline). They state WHAT the tool does but not WHEN to use it or how it differs from similar tools (e.g., getLeagueInfo vs getLeagueRosters vs getLeagueUsers all fetch league data but serve different purposes, this is not explained).
Output schemas are not documented. Tools return data from the Sleeper API but the response structure is not specified. LLMs cannot plan downstream tool calls or extract required fields (e.g., does getUserLeagues return league_id? league_name? both?) without seeing the schema.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | <=2025-11-25 | v2 |
Fetches matchups in a league for a specific week
Fetches all rosters in a league
Fetches all traded picks in a league
Fetches transactions in a league for a specific week
Fetches all users in a league
Fetches the playoff winners bracket for a league
Fetches the current NFL state
Fetches trending players based on add/drop activity
Fetches all drafts for a user for a specific sport and season
Fetches user information by username or user_id
Fetches all leagues for a user for a specified sport and season
No tool annotations (readOnlyHint, idempotentHint). All 18 tools are READ_ONLY but this is not declared in the tool definition. Modern MCP clients use annotations to optimize caching and retry logic.
No error handling guidance. Tools do not document what happens on invalid input (e.g., invalid league_id, non-existent user_id). LLMs receive raw API errors with no recovery hints.
Tool chaining dependencies not documented. getUserLeagues returns league_id, which is required by getLeagueInfo, getLeagueRosters, etc. These relationships should be stated in descriptions to guide multi-step planning.