Skip to main content
Canonical tool name: 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 to participantId; 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.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_roster when the host already knows the right scope and needs this job directly.

Common mistakes

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