Pylon MCP Server

Instructions

Implementation Reference

• src/index.ts:624-629 (handler)

  The MCP tool handler function for 'pylon_create_team'. It calls PylonClient.createTeam(params) and returns the result as formatted text content.

  async (params) => {
  	const result = await client.createTeam(params);
  	return {
  		content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
  	};
  },

• src/index.ts:617-623 (schema)

  Zod input schema for the 'pylon_create_team' tool defining optional name and user_ids parameters.

  {
  	name: z.string().optional().describe('Team name'),
  	user_ids: z
  		.array(z.string())
  		.optional()
  		.describe('User IDs to add to the team'),
  },

• src/index.ts:614-630 (registration)

  Registration of the 'pylon_create_team' MCP tool using server.tool(), including description, schema, and handler.

  server.tool(
  	'pylon_create_team',
  	'Create a new team',
  	{
  		name: z.string().optional().describe('Team name'),
  		user_ids: z
  			.array(z.string())
  			.optional()
  			.describe('User IDs to add to the team'),
  	},
  	async (params) => {
  		const result = await client.createTeam(params);
  		return {
  			content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
  		};
  	},
  );

• src/pylon-client.ts:435-440 (helper)

  PylonClient.createTeam method: sends POST request to '/teams' endpoint with the provided data to create a new team.

  async createTeam(data: {
  	name?: string;
  	user_ids?: string[];
  }): Promise<SingleResponse<Team>> {
  	return this.request<SingleResponse<Team>>('POST', '/teams', data);
  }

• 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 }[];
  }