get_program_context
Family: Program Connectivity and Watchability Tools
What this tool is best at
Return the normalized sports context for a program.Choose this tool when
- the host starts from a program and needs the attached sports meaning, event, participants, venue, and live state.
- Source ownership: On Programs primary, On SportsEvents secondary, SportsEventCurrent only for known linked watch rows
Use something smaller or different when
- the product starts from a sports entity or only needs raw linkage rows.
Inputs you need
Plain-English prerequisites
- This tool does not require a prerequisite ID beyond the scoped inputs shown below.
Required inputs in the public contract
Optional inputs in the public contract
Notes on optional inputs
- If
timeFromandtimeToare omitted, the tool still returns program metadata and linked entities; only the bounded live-status overlay remains best-effort and compact.
Sequencing guidance
Response highlights
- Return the normalized sports context for a program.
Response shape
Reuse next
- Reuse provider refs returned by this tool to avoid resolving the same entity again.
- Read
meta.agentHints.recommendedNextToolsandmeta.agentHints.disambiguationOptionsas non-binding host hints.
Example requests
Related tools
Previous-step tools
Next-step tools
Alternative tools
- No common alternatives.
Prompt patterns this tool fits
- Use
get_program_contextwhen the host already knows the right scope and needs this job directly.
Common mistakes
- Calling
get_program_contextbefore the host has the right provider refs or bounded window. - Using
get_program_contextwhen a smaller sibling tool would answer the question more directly.