Pylon MCP Server

Instructions

Implementation Reference

• src/index.ts:689-700 (handler)

  Handler for 'pylon_create_tag' tool that validates arguments are present and calls pylonClient.createTag(), returning the created tag as JSON text content

  case 'pylon_create_tag': {
    if (!args) throw new Error('Arguments required for creating tag');
    const tag = await pylonClient.createTag(args as any);
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(tag, null, 2),
        },
      ],
    };
  }

• src/pylon-client.ts:220-223 (helper)

  Implementation of createTag method in PylonClient class that makes a POST request to /tags endpoint and returns the created tag

  async createTag(tag: Omit<PylonTag, 'id'>): Promise<PylonTag> {
    const response: AxiosResponse<PylonTag> = await this.client.post('/tags', tag);
    return response.data;
  }

• src/pylon-client.ts:66-70 (schema)

  Type definition for PylonTag interface with required id and name fields, and optional color field

  export interface PylonTag {
    id: string;
    name: string;
    color?: string;
  }

• src/index.ts:291-300 (registration)

  Tool registration defining the tool name, description, and input schema with required 'name' property and optional 'color' property

  name: 'pylon_create_tag',
  description: 'Create a new tag for categorizing issues and contacts. Use this to add new categories that help organize and filter your support tickets effectively.',
  inputSchema: {
    type: 'object',
    properties: {
      name: { type: 'string', description: 'Tag name that describes the category. Examples: "billing-question", "feature-request", "bug-report", "urgent", "enterprise-customer"' },
      color: { type: 'string', description: 'Color for the tag in hex format or color name. Examples: "#FF0000", "red", "#00AA00", "blue"' },
    },
    required: ['name'],
  },