list_teams
Retrieve and filter teams from TeamRetro using pagination. Specify team IDs or tags to narrow results and manage large datasets efficiently.
Instructions
List teams from TeamRetro with filtering and pagination
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | number | |
| offset | No | number | |
| teamIds | No | string,string,... | |
| teamTags | No | string,string,... |
Implementation Reference
- src/features/teams/service.ts:12-26 (handler)Core handler function `listTeams` in TeamsService that constructs query parameters from input and fetches the list of teams from the `/v1/teams` API endpoint.async listTeams(params?: { offset?: number; limit?: number; teamTags?: string; teamIds?: string; }): Promise<ListApiResponse<Team>> { const searchString = createSearchParams({ offset: { value: params?.offset }, limit: { value: params?.limit }, teamTags: { value: params?.teamTags }, teamIds: { value: params?.teamIds }, }); return this.get<ListApiResponse<Team>>(`/v1/teams?${searchString}`); }
- src/features/teams/tools.ts:17-20 (schema)Input schema for the `list_teams` tool, extending pagination schema with team-specific filters for tags and IDs.schema: paginationSchema.extend({ teamTags: tagFilterSchema, teamIds: idFilterSchema, }),
- src/features/teams/tools.ts:16-28 (registration)Local registration of the `list_teams` tool within `teamTools`, including schema, description, and handler wrapper.list_teams: { schema: paginationSchema.extend({ teamTags: tagFilterSchema, teamIds: idFilterSchema, }), description: "List teams from TeamRetro with filtering by tags and IDs, and pagination using offset and limit parameters", handler: async (args: { offset?: number; limit?: number; teamTags?: string; teamIds?: string; }) => createToolResponse(teamsService.listTeams(args)), },
- src/tools.ts:13-22 (registration)Global tool registry that spreads `teamTools` (containing `list_teams`) into the main `tools` object for schema and handler export.const tools = { ...userTools, ...teamTools, ...teamMembersTools, ...actionTools, ...retrospectiveTools, ...agreementTools, ...healthModelTools, ...healthCheckTools, };