Pylon MCP Server

Instructions

Implementation Reference

• src/index.ts:419-430 (handler)

  The request handler for 'pylon_create_issue' tool. Validates that arguments are provided, calls pylonClient.createIssue() with the arguments, and returns the created issue as JSON. This is the main entry point that executes when the tool is invoked.

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

• src/pylon-client.ts:119-122 (handler)

  The createIssue method in PylonClient class that performs the actual API call. Makes an HTTP POST request to '/issues' endpoint with the issue data and returns the created PylonIssue object from the API response.

  async createIssue(issue: Omit<PylonIssue, 'id'>): Promise<PylonIssue> {
    const response: AxiosResponse<PylonIssue> = await this.client.post('/issues', issue);
    return response.data;
  }

• src/index.ts:81-94 (schema)

  Tool registration and input schema definition for 'pylon_create_issue'. Defines the tool name, description, and inputSchema with properties: title (required), description (required), status (required), priority (required), and assignee (optional).

    name: 'pylon_create_issue',
    description: 'Create a new support issue/ticket in Pylon. Use this to log customer problems, bug reports, or feature requests that need to be tracked and resolved.',
    inputSchema: {
      type: 'object',
      properties: {
        title: { type: 'string', description: 'Brief title describing the issue. Examples: "Login page not loading", "Cannot upload files", "Billing question"' },
        description: { type: 'string', description: 'Detailed description of the issue, including steps to reproduce and impact. Example: "User reports that clicking login button shows error message. Affects all Chrome users on Windows."' },
        status: { type: 'string', description: 'Initial status: "open", "in_progress", "pending", "resolved", "closed". Usually "open" for new issues. Example: "open"' },
        priority: { type: 'string', description: 'Priority level: "low", "medium", "high", "urgent". Example: "high"' },
        assignee: { type: 'string', description: 'Team member to assign (optional). Use email or user ID. Example: "support@company.com"' },
      },
      required: ['title', 'description', 'status', 'priority'],
    },
  },

• src/pylon-client.ts:22-29 (schema)

  PylonIssue TypeScript interface defining the structure of an issue object with fields: id, title, description, status, priority, and optional assignee.

  export interface PylonIssue {
    id: string;
    title: string;
    description: string;
    status: string;
    priority: string;
    assignee?: string;
  }