Pylon MCP Server

Instructions

Implementation Reference

• src/index.ts:516-528 (registration)

  Registration of the MCP tool 'pylon_get_tag' including name, description, input schema, and thin handler that delegates to PylonClient.getTag.

  server.tool(
  	'pylon_get_tag',
  	'Get a specific tag by ID',
  	{
  		id: z.string().describe('The tag ID'),
  	},
  	async ({ id }) => {
  		const result = await client.getTag(id);
  		return {
  			content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
  		};
  	},
  );

• src/index.ts:522-527 (handler)

  The handler function for the pylon_get_tag tool, which fetches the tag using PylonClient and returns a formatted text response.

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

• src/index.ts:519-521 (schema)

  Zod input schema for the pylon_get_tag tool requiring a string 'id' parameter.

  {
  	id: z.string().describe('The tag ID'),
  },

• src/pylon-client.ts:393-395 (helper)

  Core helper method in PylonClient that implements the API call to retrieve a specific tag by ID.

  async getTag(id: string): Promise<SingleResponse<Tag>> {
  	return this.request<SingleResponse<Tag>>('GET', `/tags/${id}`);
  }

• src/pylon-client.ts:95-100 (schema)

  TypeScript interface defining the structure of a Tag object.

  export interface Tag {
  	id: string;
  	value: string;
  	object_type: 'account' | 'issue' | 'contact';
  	hex_color?: string;
  }