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

What this tool is best at

Return the richest non-empty leaderboard rows for a competition or series scope, plus selection metadata.

Choose this tool when

  • the host needs leaderboards, driver standings, golf leaderboards, or category rankings rather than a single standings table.
  • Source ownership: GSD Lookup

Use something smaller or different when

  • Do not use it to replace standings, one-event stats, or phase/session results.

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 rankings payload from the selected scope or ranking ref.
  • Normalized rows, rowCount, additive selectedRef, selectedRefId, selectedRefType, and rowsSourcePath fields.
  • Deterministic selection of the richest non-empty leaderboard collection instead of trusting the first ref.

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

Common mistakes

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