Skip to main content

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.

Canonical tool name: 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

InputWhat it means
programIdProgram identifier for the selected guide row or program tile.

​
Optional inputs in the public contract

InputWhat it means
timeFromOptional bounded window start for the program-context lookup. Use it when live-status overlays should be constrained to a specific window.
timeToOptional bounded window end for the program-context lookup. If you provide one time edge, provide both.
languageOptional BCP 47 language hint such as en-US. Use it when the host needs translated provider output.

​
Notes on optional inputs

  • If timeFrom and timeTo are omitted, the tool still returns program metadata and linked entities; only the bounded live-status overlay remains best-effort and compact.

​
Sequencing guidance

Needed ID or scopeCall this firstThen use
scopeTool CatalogStart from the smallest tool that can safely anchor the workflow, then deepen only if the user asks for more.

​
Response highlights

  • Return the normalized sports context for a program.

​
Response shape

FieldWhat it means
data.programPrimary program record selected for the requested program ID.
data.programRows[]All matched or closely related program rows returned by the lookup.
data.entities[]Linked sports entities derived from the program graph.
data.liveStatuses[]Compact freshness overlays for the top linked current or next events.

​
Reuse next

  • Reuse provider refs returned by this tool to avoid resolving the same entity again.
  • Read meta.agentHints.recommendedNextTools and meta.agentHints.disambiguationOptions as non-binding host hints.

​
Example requests

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_program_context",
    "arguments": {
      "programId": "PROGRAM_ID",
      "timeFrom": "2026-04-08T18:00:00Z",
      "timeTo": "2026-04-08T23:00:00Z"
    }
  }
}

​
Previous-step tools

​
Next-step tools

​
Alternative tools

  • No common alternatives.

​
Prompt patterns this tool fits

  • Use get_program_context when the host already knows the right scope and needs this job directly.

​
Common mistakes

  • Calling get_program_context before the host has the right provider refs or bounded window.
  • Using get_program_context when a smaller sibling tool would answer the question more directly.