> ## 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. # List Live Slate > Return what is live or imminently live from GSD sports truth, with watchability overlays only when availability is grounded. Canonical tool name: `list_live_slate` Family: [Resolution and Scope Tools](/sports-mcp-server/tools/resolution-and-scope-tools) ## What this tool is best at Return what is live or imminently live from GSD sports truth, with optional watchability overlay when the availability contract is provisioned. ## Choose this tool when * Use it for what-is-on-now, live slates, and watchability-first entry points. * Source ownership: GSD Lookup primary, dedicated availability overlay optional ## Use something smaller or different when * Do not use it to answer standings, historic season questions, or non-bounded schedule browse flows. ## 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 | Input | What it means | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `timeFrom` | Bounded window start. Use an ISO date or timestamp that matches the user’s browse moment or watchability horizon. Some tools require this field as part of the public contract. | | `timeTo` | Bounded window end. Keep it tight enough that the request still represents one real product moment. Some tools require this field as part of the public contract. | ### Optional inputs in the public contract | Input | What it means | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `sportId` | Resolved sport ref for a sport-wide live slate. | | `competitionId` | Resolved competition ref when the live slate should stay inside one competition. | | `competitionSeasonId` | Provider ref for one competition season. Use it when the host needs a season-specific table, ranking, structure, or roster context. | | `seriesId` | Resolved series ref for a tour-wide or motorsport live slate. | | `seriesSeasonId` | Provider ref for one series season. Use it when the host needs one tour season instead of the broader series. | | `participantId` | Resolved participant ref when the live slate is anchored to one team or participant. | | `limit` | Maximum number of rows to return. Keep it small for low-token UX and larger only when the UI truly needs a browse list. | | `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](/sports-mcp-server/tools/tool-catalog) | Start from the smallest tool that can safely anchor the workflow, then deepen only if the user asks for more. | ## Response highlights * Return what is live or imminently live from GSD sports truth, with optional watchability overlay when the availability contract is provisioned. ## 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 ```json JSON-RPC theme={null} { "jsonrpc": "2.0", "id": "tool-call-1", "method": "tools/call", "params": { "name": "list_live_slate", "arguments": { "sportId": "SPORT_ID", "timeFrom": "2026-04-08T18:00:00Z", "timeTo": "2026-04-08T23:00:00Z" } } } ``` ```bash curl theme={null} curl "https://sports-mcp-server.etonecarg.com/" \ -X POST \ -H "Authorization: Bearer $SPORTS_MCP_API_KEY" \ -H "Accept: application/json, text/event-stream" \ -H "Content-Type: application/json" \ -H "mcp-protocol-version: 2025-03-26" \ -d '{ "jsonrpc": "2.0", "id": "tool-call-1", "method": "tools/call", "params": { "name": "list_live_slate", "arguments": { "sportId": "SPORT_ID", "timeFrom": "2026-04-08T18:00:00Z", "timeTo": "2026-04-08T23:00:00Z" } } }' ``` ```ts TypeScript theme={null} const payload = { "jsonrpc": "2.0", "id": "tool-call-1", "method": "tools/call", "params": { "name": "list_live_slate", "arguments": { "sportId": "SPORT_ID", "timeFrom": "2026-04-08T18:00:00Z", "timeTo": "2026-04-08T23:00:00Z" } } }; const response = await fetch("https://sports-mcp-server.etonecarg.com/", { method: "POST", headers: { Authorization: `Bearer ${process.env.SPORTS_MCP_API_KEY!}`, Accept: "application/json, text/event-stream", "Content-Type": "application/json", "mcp-protocol-version": "2025-03-26", }, body: JSON.stringify(payload), }); const data = await response.json(); console.log(JSON.stringify(data, null, 2)); ``` ```python Python theme={null} import json import os import requests payload = { "jsonrpc": "2.0", "id": "tool-call-1", "method": "tools/call", "params": { "name": "list_live_slate", "arguments": { "sportId": "SPORT_ID", "timeFrom": "2026-04-08T18:00:00Z", "timeTo": "2026-04-08T23:00:00Z" } } } response = requests.post( "https://sports-mcp-server.etonecarg.com/", headers={ "Authorization": f"Bearer {os.environ['SPORTS_MCP_API_KEY']}", "Accept": "application/json, text/event-stream", "Content-Type": "application/json", "mcp-protocol-version": "2025-03-26", }, json=payload, timeout=30, ) response.raise_for_status() print(json.dumps(response.json(), indent=2)) ``` ## Related tools ### Previous-step tools * [`resolve_entities`](/sports-mcp-server/tool-reference/resolve_entities) * [`list_watchable_schedule`](/sports-mcp-server/tool-reference/list_watchable_schedule) ### Next-step tools * [`get_watch_availability`](/sports-mcp-server/tool-reference/get_watch_availability) * [`get_event_center`](/sports-mcp-server/tool-reference/get_event_center) ### Alternative tools * No common alternatives. ## Prompt patterns this tool fits * Use `list_live_slate` when the host already knows the right scope and needs this job directly. ## Common mistakes * Calling `list_live_slate` before the host has the right provider refs or bounded window. * Using `list_live_slate` when a smaller sibling tool would answer the question more directly.