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_watch_availability
Family: Program Connectivity and Watchability Tools
Return the normalized where-to-watch answer for a sports entity in a bounded window, with proven or evidence-only watchability semantics.
- the host needs a direct answer to where, whether, or on what service/channel the user can watch a sports entity.
- Source ownership: Dedicated availability primary when provisioned, otherwise evidence-only watchability fallback
Use something smaller or different 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.
Plain-English prerequisites
- This tool does not require a prerequisite ID beyond the scoped inputs shown below.
| Input | What it means |
|---|
entityId | Resolved entity ref for the sports object the user wants to watch. |
entityType | Entity kind for entityId. Keep it aligned with the ref you preserved. |
timeFrom | Bounded window start for the watchability lookup. Match it to the user’s actual browse window. |
timeTo | Bounded window end for the watchability lookup. |
| Input | What it means |
|---|
language | Optional BCP 47 language hint such as en-US. Use it when the host needs translated provider output. |
Sequencing guidance
| Needed ID or scope | Call this first | Then use |
|---|
| scope | Tool Catalog | Start from the smallest tool that can safely anchor the workflow, then deepen only if the user asks for more. |
Response highlights
data.options[] is the normalized watchability answer when channels or services can be grounded.data.eventEvidence[] carries fallback event evidence when the server cannot prove channel or service linkage.data.linkageStatus and data.availabilityMode tell the host whether the answer is proven, unresolved, or unavailable.
Response shape
| Field | What it means |
|---|
data.entityId / data.entityType | Echo of the requested sports entity scope. |
data.options[] | Normalized watch options when dedicated availability can prove them. |
data.eventEvidence[] | Fallback event evidence rows when the answer cannot be proven. |
data.linkageStatus | Terminal trust state: proven, unresolved, or provider_unavailable. |
data.availabilityMode | Operating mode: dedicated, on_evidence, or none. |
meta.limitations[] | Explanation of why the answer is proven, unresolved, or unavailable. |
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
Recommended request
Expanded request
{
"jsonrpc": "2.0",
"id": "tool-call-1",
"method": "tools/call",
"params": {
"name": "get_watch_availability",
"arguments": {
"entityId": "EVENT_ID",
"entityType": "event",
"timeFrom": "2026-04-08T18:00:00Z",
"timeTo": "2026-04-08T23:00:00Z"
}
}
}
{
"jsonrpc": "2.0",
"id": "tool-call-1",
"method": "tools/call",
"params": {
"name": "get_watch_availability",
"arguments": {
"entityId": "TEAM_ID",
"entityType": "participant",
"timeFrom": "2026-04-08T00:00:00Z",
"timeTo": "2026-04-09T00:00:00Z"
}
}
}
- Use
get_watch_availability when the host already knows the right scope and needs this job directly.
Common mistakes
- Expecting channels or services to appear when the response is in evidence-only fallback mode.
- Treating fallback event evidence as if it were proven where-to-watch availability.
