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
rankingspayload from the selected scope or ranking ref. - Normalized
rows,rowCount, additiveselectedRef,selectedRefId,selectedRefType, androwsSourcePathfields. - 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.recommendedNextToolsandmeta.agentHints.disambiguationOptionsas non-binding host hints.
Example requests
Related tools
Previous-step tools
Next-step tools
Alternative tools
- No common alternatives.
Prompt patterns this tool fits
- Use
get_rankingswhen the host already knows the right scope and needs this job directly.
Common mistakes
- Calling
get_rankingsbefore the host has the right provider refs or bounded window. - Using
get_rankingswhen a smaller sibling tool would answer the question more directly.