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

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

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

Use this family when the workflow fits this source-ownership boundary. Move to the tool page once you know the exact job and scope.

## Sequencing habits

* Keep raw connectivity evidence separate from normalized watchability answers.
* Use bounded windows anywhere current watchability matters.

## Decision guide

| Tool                                                                                       | What it helps with                                                                                                                        | Primary 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                          |

## Tool-by-tool guidance

### [`list_programs_for_entity`](/sports-mcp-server/tool-reference/list_programs_for_entity)

* Job: Return compact raw evidence linking a sports entity to programs.
* Source ownership: Dedicated availability primary when provisioned, otherwise fallback event/program evidence with explicit linkage limitations
* Use it when: the host needs the raw graph before it normalizes watchability.
* Do not use it when: the product wants a polished where-to-watch answer; use `get_watch_availability` instead.

### [`list_entities_for_program`](/sports-mcp-server/tool-reference/list_entities_for_program)

* Job: Return compact raw evidence linking a program back to sports entities.
* Source ownership: On Programs primary, On SportsEvents secondary
* Use it when: the host starts from a program and wants the raw sports graph before it normalizes context.
* Do not use it when: the product wants the normalized one-call sports context for a program.

### [`get_watch_availability`](/sports-mcp-server/tool-reference/get_watch_availability)

* Job: Return the normalized where-to-watch answer for a sports entity in a bounded window, with proven or evidence-only watchability semantics.
* Source ownership: Dedicated availability primary when provisioned, otherwise evidence-only watchability fallback
* Use it when: the host needs a direct answer to where, whether, or on what service/channel the user can watch a sports entity.
* Do not use it when: Do not use it as a substitute for deep sports detail or as a raw linkage-inspection tool when QA needs the underlying evidence graph instead.

### [`get_program_context`](/sports-mcp-server/tool-reference/get_program_context)

* Job: Return the normalized sports context for a program.
* Source ownership: On Programs primary, On SportsEvents secondary, SportsEventCurrent only for known linked watch rows
* Use it when: the host starts from a program and needs the attached sports meaning, event, participants, venue, and live state.
* Do not use it when: the product starts from a sports entity or only needs raw linkage rows.

## Next steps

* Use [Tool Catalog](/sports-mcp-server/tools/tool-catalog) when you want the full 1.4.1 surface in one place.
* 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 tool order.
* Use [Prompt-to-Tool Mapping](/sports-mcp-server/prompt-to-tool-mapping) when you want a proven low-token workflow for a real user prompt.