> ## 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.

# Tool Catalog

> Browse the Sports MCP Server 1.4.1 contract by job, family, and source ownership.

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`](/sports-mcp-server/tool-reference/resolve_entities)                                                                                                 | Resolve the right competition, series, participant, venue, or program before deeper calls.                                                                   |
| Competition-first schedule truth       | [`list_schedule`](/sports-mcp-server/tool-reference/list_schedule)                                                                                                       | Stay in GSD when the question is about the sports calendar rather than watchability.                                                                         |
| Watchable schedule or live slate       | [`list_watchable_schedule`](/sports-mcp-server/tool-reference/list_watchable_schedule), [`list_live_slate`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/get_event_summary), [`get_event_center`](/sports-mcp-server/tool-reference/get_event_center)                     | Start small for deep truth, then bundle only when the experience needs it.                                                                                   |
| Competition dashboard                  | [`get_competition_hub`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/list_programs_for_entity), [`get_program_context`](/sports-mcp-server/tool-reference/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.

## Browse every tool by family

## Resolution and Scope Tools

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`](/sports-mcp-server/tool-reference/resolve_entities)                   | Resolve fuzzy sports language into bounded candidates with provider refs, crosswalk confidence, and disambiguation options.                                                   | GSD Lookup primary                                                                                                                |
| [`list_schedule`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/get_competition_structure) | Return normalized competition structure and hierarchy for a league or competition season.                                                                                     | GSD Lookup primary                                                                                                                |

## Deep Sports Truth Tools

Use GSD-first tools for standings, structure, stats, actions, lineups, odds, rosters, and profiles.

| Tool                                                                                   | What it does                                                                                                                         | Data source(s)                                                                          |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| [`get_event_summary`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/get_event_lineups)             | Return lineups and officials for one event.                                                                                          | GSD Lookup                                                                              |
| [`get_event_timeline`](/sports-mcp-server/tool-reference/get_event_timeline)           | Return the action stream or timeline for one event.                                                                                  | GSD Lookup                                                                              |
| [`get_event_stats`](/sports-mcp-server/tool-reference/get_event_stats)                 | Return raw event stats plus normalized team and person stat groups with canonical metric keys.                                       | GSD Lookup                                                                              |
| [`get_phase_results`](/sports-mcp-server/tool-reference/get_phase_results)             | Return ordered phase or session results for qualifying, rounds, heats, groups, and similar staged competition slices.                | GSD Lookup                                                                              |
| [`get_odds`](/sports-mcp-server/tool-reference/get_odds)                               | Return event odds when available.                                                                                                    | GSD Lookup                                                                              |
| [`get_standings`](/sports-mcp-server/tool-reference/get_standings)                     | Return raw standings plus normalized table rows and group metadata for a competition or competition season.                          | GSD Lookup                                                                              |
| [`get_rankings`](/sports-mcp-server/tool-reference/get_rankings)                       | Return the richest non-empty leaderboard rows for a competition or series scope, plus selection metadata.                            | GSD Lookup                                                                              |
| [`get_participant_profile`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/get_venue_profile)             | Return venue identity, geography, timezone, and normalized refs.                                                                     | On Sports Venues primary, GSD enrichment optional                                       |
| [`get_roster`](/sports-mcp-server/tool-reference/get_roster)                           | Return roster data for a team inside one competition context.                                                                        | GSD Lookup                                                                              |

## Program Connectivity and Watchability Tools

Move between sports entities and programs, then return grounded where-to-watch answers when the supported availability contract is provisioned.

| Tool                                                                                       | What it does                                                                                                                              | Data source(s)                                                                                                               |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| [`list_programs_for_entity`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/list_entities_for_program) | Return compact raw evidence linking a program back to sports entities.                                                                    | On Programs primary, On SportsEvents secondary                                                                               |
| [`get_watch_availability`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/get_program_context)             | Return the normalized sports context for a program.                                                                                       | On Programs primary, On SportsEvents secondary, SportsEventCurrent only for known linked watch rows                          |

## Hybrid Bundle Tools

Use composed tools when the product needs both deep sports truth and program-aware availability in one answer.

| Tool                                                                           | What it does                                                                                                                                                                                 | Data source(s)                                                                   |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [`get_competition_hub`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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`](/sports-mcp-server/tool-reference/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 |

## Media and Assets Tools

Fetch imagery and bounded media context without exposing raw metadata-update endpoints directly.

| Tool                                                                     | What it does                                                              | Data source(s)                   |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------- | -------------------------------- |
| [`get_media_assets`](/sports-mcp-server/tool-reference/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

* Use [ID Acquisition and Tool Sequencing](/sports-mcp-server/tools/id-acquisition-and-tool-sequencing) when the host still needs provider refs or a safer step order.
* Use [Prompt-to-Tool Mapping](/sports-mcp-server/prompt-to-tool-mapping) for low-token workflows built around real user prompts.
