Skip to main content
Canonical tool name: get_event_timeline Family: Deep Sports Truth Tools

What this tool is best at

Return the action stream or timeline for one event.

Choose this tool when

  • the product needs scoring actions, incidents, laps, plays, or turning points.
  • Source ownership: GSD Lookup

Use something smaller or different when

  • Do not use it for lineups, aggregate stats, or watchability.

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

Sequencing guidance

Response highlights

  • Return the action stream or timeline for one event.

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

Previous-step tools

Next-step tools

Alternative tools

  • No common alternatives.

Prompt patterns this tool fits

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

Common mistakes

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