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

What this tool is best at

Return raw standings plus normalized table rows and group metadata for a competition or competition season.

Choose this tool when

  • Use it for table, ladder, playoff-picture, and current-rank questions.
  • Source ownership: GSD Lookup

Use something smaller or different when

  • Do not use it for watchability, event detail, or generic ranking flows that are classification-based instead of table-based.

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

  • None.

Optional inputs in the public contract

Sequencing guidance

Response highlights

  • Raw standings payload from the selected source.
  • Normalized rows, rowCount, groups, sourceMode, and rowsSourcePath fields for direct consumption.
  • Fallback table extraction from classification or overall refs when the direct standings payload is structurally empty.

Response shape

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_standings when the host already knows the right scope and needs this job directly.

Common mistakes

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