get_roster
Family: Deep Sports Truth Tools
What this tool is best at
Return roster data for a team inside one competition context.Choose this tool when
- the host needs the season-context roster and not just a single-event lineup.
- Source ownership: GSD Lookup
Use something smaller or different when
- Do not use it for people stats, lineups, or general team identity questions.
Inputs you need
Plain-English prerequisites
competitionId / competitionSeasonId: Provide one competition context in addition toparticipantId; the roster contract is season- or competition-specific.
Required inputs in the public contract
Optional inputs in the public contract
Sequencing guidance
Response highlights
- Return roster data for a team inside one competition context.
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_rosterwhen the host already knows the right scope and needs this job directly.
Common mistakes
- Calling
get_rosterbefore the host has the right provider refs or bounded window. - Using
get_rosterwhen a smaller sibling tool would answer the question more directly.