get-team
Retrieve team details from Shortcut project management using the team's public ID to access member information and project data.
Instructions
Get a Shortcut team by public ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teamPublicId | Yes | The public ID of the team to get |
Implementation Reference
- src/tools/teams.ts:22-28 (handler)Implements the core logic for the 'get-team' tool: fetches the team by public ID using the client, handles not found case, and formats the response with related entities.
async getTeam(teamPublicId: string) { const team = await this.client.getTeam(teamPublicId); if (!team) return this.toResult(`Team with public ID: ${teamPublicId} not found.`); return this.toResult(`Team: ${team.id}`, await this.entityWithRelatedEntities(team, "team")); } - src/tools/teams.ts:13-13 (schema)Input schema for the 'get-team' tool using Zod: requires a string teamPublicId.
{ teamPublicId: z.string().describe("The public ID of the team to get") }, - src/tools/teams.ts:10-15 (registration)Registers the 'get-team' tool with the MCP server, including description and handler lambda that delegates to getTeam method.
server.tool( "get-team", "Get a Shortcut team by public ID", { teamPublicId: z.string().describe("The public ID of the team to get") }, async ({ teamPublicId }) => await tools.getTeam(teamPublicId), );