Documentation Index
Fetch the complete documentation index at: https://docs.etonecarg.com/llms.txt
Use this file to discover all available pages before exploring further.
Sports MCP Server 1.4.1 exposes a 24-tool catalog built around product jobs and explicit source ownership:
- GSD is the deep sports truth layer.
- The dedicated availability contract is the where-to-watch layer.
- On Programs and On SportsEvents are the program-first connectivity layer.
- GSD Metadata is limited to bounded enrichments like media and editorial.
Use this page when you know the product job but not yet the exact tool.
Start by product job
| If the product needs | Start with | Why |
|---|
| Fuzzy resolution and scoping | resolve_entities | Resolve the right competition, series, participant, venue, or program before deeper calls. |
| Competition-first schedule truth | list_schedule | Stay in GSD when the question is about the sports calendar rather than watchability. |
| Watchable schedule or live slate | list_watchable_schedule, list_live_slate | Lead with the dedicated availability contract for grounded where-to-watch answers, then fall back to sports truth only when availability is not provisioned. |
| One event with optional watchability | get_event_summary, get_event_center | Start small for deep truth, then bundle only when the experience needs it. |
| Competition dashboard | get_competition_hub | Use one hybrid hub when the product needs structure, standings, schedule, and optional availability together. |
| Tour or motorsport hub | get_series_hub | Use one series bundle when the product needs tour context, leaderboard refs, and bounded event rows together. |
| Phase or session results | get_phase_results | Deepen from a known phase when the question is about qualifying, rounds, heats, or other staged slices. |
| Program linkage or program-first flows | list_programs_for_entity, get_program_context | Keep raw evidence and normalized program context separate. |
Operating rules
- Start with the smallest tool that can safely answer the user’s job.
- Keep provider refs in their original namespace.
- Keep schedule, live, and watchability flows bounded.
- Treat watchability answers and sports-truth answers as different product surfaces unless a hybrid bundle is truly justified.
Find the right entity, scope, and bounded schedule window before the host deepens into sports truth or watchability.
| Tool | What it does | Data source(s) |
|---|
resolve_entities | Resolve fuzzy sports language into bounded candidates with provider refs, crosswalk confidence, and disambiguation options. | GSD Lookup primary |
list_schedule | Return the competitive deep-sports schedule for a bounded sport, competition, competition season, series, series season, or participant scope. | GSD Lookup primary |
list_watchable_schedule | Return bounded schedule rows enriched with grounded watchability semantics when available, otherwise return truthful evidence-backed fallback rows with explicit limitations. | Dedicated availability primary when provisioned, otherwise bounded sports-truth rows plus explicit fallback watchability evidence |
list_live_slate | Return what is live or imminently live from GSD sports truth, with optional watchability overlay when the availability contract is provisioned. | GSD Lookup primary, dedicated availability overlay optional |
get_competition_structure | Return normalized competition structure and hierarchy for a league or competition season. | GSD Lookup primary |
| Tool | What it does | Data source(s) |
|---|
get_event_summary | Return the minimum single-event sports-truth object needed to answer what the event is and what is happening in it at summary depth. | GSD Lookup primary, On sports-event lookup optional when the caller already has On refs |
get_event_lineups | Return lineups and officials for one event. | GSD Lookup |
get_event_timeline | Return the action stream or timeline for one event. | GSD Lookup |
get_event_stats | Return raw event stats plus normalized team and person stat groups with canonical metric keys. | GSD Lookup |
get_phase_results | Return ordered phase or session results for qualifying, rounds, heats, groups, and similar staged competition slices. | GSD Lookup |
get_odds | Return event odds when available. | GSD Lookup |
get_standings | Return raw standings plus normalized table rows and group metadata for a competition or competition season. | GSD Lookup |
get_rankings | Return the richest non-empty leaderboard rows for a competition or series scope, plus selection metadata. | GSD Lookup |
get_participant_profile | Return team, person, or university profile data with normalized refs and optional season context. | GSD Lookup primary, On Universities enrichment optional |
get_venue_profile | Return venue identity, geography, timezone, and normalized refs. | On Sports Venues primary, GSD enrichment optional |
get_roster | Return roster data for a team inside one competition context. | GSD Lookup |
| Tool | What it does | Data source(s) |
|---|
list_programs_for_entity | Return compact raw evidence linking a sports entity to programs. | Dedicated availability primary when provisioned, otherwise fallback event/program evidence with explicit linkage limitations |
list_entities_for_program | Return compact raw evidence linking a program back to sports entities. | On Programs primary, On SportsEvents secondary |
get_watch_availability | Return the normalized where-to-watch answer for a sports entity in a bounded window, with proven or evidence-only watchability semantics. | Dedicated availability primary when provisioned, otherwise evidence-only watchability fallback |
get_program_context | Return the normalized sports context for a program. | On Programs primary, On SportsEvents secondary, SportsEventCurrent only for known linked watch rows |
| Tool | What it does | Data source(s) |
|---|
get_competition_hub | Return structure, schedule, standings, rankings, and optional watchable rail for one competition scope. | GSD Lookup primary, availability overlay optional |
get_series_hub | Return one compact series bundle with series seasons, bounded event rows, leaderboard refs, and phase refs for tours and motorsports. | GSD Lookup primary |
get_event_center | Return the main one-call event recap bundle with summary, optional lineups, optional timeline, optional stats, optional odds, optional watchability, optional media, and optional editorial. | GSD Lookup primary, availability optional, GSD Metadata media/editorial optional |
| Tool | What it does | Data source(s) |
|---|
get_media_assets | Return bounded imagery and asset context for sports entities or programs. | GSD and On entity/program assets |
Comparison guidance
Sports MCP Server 1.4.1 does not expose a public compare tool. Compare seasons, teams, players, or events by calling the smallest relevant tools multiple times:
- get_competition_hub for competition-over-competition comparisons
- get_event_center for event-over-event comparisons
- get_participant_profile, get_event_stats, and get_standings for roster or performance comparisons
Next steps
