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: list_entities_for_program Family: Program Connectivity and Watchability Tools

What this tool is best at

Return compact raw evidence linking a program back to sports entities.

Choose this tool when

  • the host starts from a program and wants the raw sports graph before it normalizes context.
  • Source ownership: On Programs primary, On SportsEvents secondary

Use something smaller or different when

  • the product wants the normalized one-call sports context for a program.

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 from a guide row or connectivity response. Use it for program-first context and reverse-linkage workflows.

Optional inputs in the public contract

InputWhat it means
limitMaximum number of rows to return. Keep it small for low-token UX and larger only when the UI truly needs a browse list.
languageOptional BCP 47 language hint such as en-US. Use it when the host needs translated provider output.

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 compact raw evidence linking a program back to sports entities.

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": "list_entities_for_program",
    "arguments": {
      "programId": "PROGRAM_ID"
    }
  }
}

Previous-step tools

Next-step tools

Alternative tools

  • No common alternatives.

Prompt patterns this tool fits

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

Common mistakes

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