TeamRetro MCP Server

Instructions

Implementation Reference

• src/features/team-members/tools.ts:8-18 (handler)

  Definition of the 'list_team_members' tool including input schema (paginationSchema merged with teamIdSchema), description, and handler function that delegates to teamMembersService.listTeamMembers.

  list_team_members: {
    schema: paginationSchema.merge(teamIdSchema),
    description: "Retrieve a list of team members for a specified team ID with pagination controls for offset and limit.",
    handler: async (args: {
      teamId: string;
      offset?: number;
      limit?: number;
    }) => {
      return createToolResponse(teamMembersService.listTeamMembers(args));
    },
  },

• src/features/team-members/service.ts:13-25 (helper)

  Core implementation of listTeamMembers in TeamMembersService, which makes an HTTP GET request to the API endpoint /v1/teams/{teamId}/members with pagination query params.

  async listTeamMembers(params?: {
      teamId: string;
      offset?: number;
      limit?: number;
  }): Promise<ListApiResponse<TeamMember>> {
    const searchString = createSearchParams({
      offset: { value: params?.offset },
      limit: { value: params?.limit },
    });
    return this.get<ListApiResponse<TeamMember>>(
      `/v1/teams/${params?.teamId}/members?${searchString}`
    );
  }

• src/tools.ts:13-22 (registration)

  Registration of the teamMembersTools (which includes list_team_members) by spreading it into the central tools object used for MCP tool schema and handler registry.

  const tools = {
    ...userTools,
    ...teamTools,
    ...teamMembersTools,
    ...actionTools,
    ...retrospectiveTools,
    ...agreementTools,
    ...healthModelTools,
    ...healthCheckTools,
  };

• src/tools.ts:24-30 (schema)

  Generation of JSON schemas for all tools, including list_team_members, by converting Zod schemas to JSON schema format for MCP.

  const toolSchema = Object.entries(tools).map(([name, tool]) => ({
    name,
    description: tool.description,
    inputSchema: zodToJsonSchema(tool.schema, {
      $refStrategy: "none",
    }),
  }));

• src/tools.ts:36-39 (registration)

  Registration of wrapped tool handlers for all tools, including list_team_members, with error handling wrapper.

  Object.entries(tools).forEach(([name, tool]) => {
    toolHandlers[name] = (args: any) => toolErrorHandlers(tool.handler, args);
  });