pylon_get_team
Retrieve team details by ID from the Pylon customer support platform to manage team information and access specific data.
Instructions
Get a specific team by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The team ID |
Implementation Reference
- src/index.ts:600-612 (registration)Registration of the 'pylon_get_team' MCP tool. Includes input schema (id: z.string()), description, and inline handler function that calls PylonClient.getTeam(id) and returns the result as formatted JSON text content.server.tool( 'pylon_get_team', 'Get a specific team by ID', { id: z.string().describe('The team ID'), }, async ({ id }) => { const result = await client.getTeam(id); return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }], }; }, );
- src/pylon-client.ts:431-433 (handler)Core handler logic in PylonClient: performs HTTP GET request to `/teams/${id}` endpoint via the private request method to fetch team data.async getTeam(id: string): Promise<SingleResponse<Team>> { return this.request<SingleResponse<Team>>('GET', `/teams/${id}`); }
- src/pylon-client.ts:102-106 (schema)TypeScript interface defining the structure of a Team object returned by the Pylon API.export interface Team { id: string; name: string; users: { email: string; id: string }[]; }
- src/pylon-client.ts:121-147 (helper)Private HTTP request utility method used by getTeam to make authenticated API calls to Pylon.private async request<T>( method: string, path: string, body?: object, ): Promise<T> { const url = `${PYLON_API_BASE}${path}`; const headers: Record<string, string> = { Authorization: `Bearer ${this.apiToken}`, 'Content-Type': 'application/json', Accept: 'application/json', }; const response = await fetch(url, { method, headers, body: body ? JSON.stringify(body) : undefined, }); if (!response.ok) { const errorText = await response.text(); throw new Error( `Pylon API error: ${response.status} ${response.statusText} - ${errorText}`, ); } return response.json() as Promise<T>; }