Pylon MCP

🚀 pylon-mcp

The MCP (Model Context Protocol) server for the Pylon customer support platform, facilitating seamless integration and enhanced functionality.

🚀 Quick Start

This guide will walk you through the steps to set up and use the pylon-mcp server.

📦 Installation

To install the necessary dependencies and build the project, run the following commands:

corepack enable
pnpm install
pnpm run build

📚 Documentation

Configuration

Follow these steps to configure the pylon-mcp server:

1. Copy the example environment file:

   cp .env.example .env
   

2. Edit the .env file and add your Pylon API token:

   PYLON_API_TOKEN=your_api_token_here
   

You can generate an API token from the Pylon dashboard. Note: Only Admin users can create API tokens.

Usage

With Claude Desktop

Add the following configuration to your Claude Desktop settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "pylon": {
      "command": "node",
      "args": ["--env-file", "/path/to/pylon-mcp/.env", "/path/to/pylon-mcp/dist/index.js"]
    }
  }
}

With Claude Code

Add the following configuration to your Claude Code MCP settings:

{
  "mcpServers": {
    "pylon": {
      "command": "node",
      "args": ["--env-file", "/path/to/pylon-mcp/.env", "/path/to/pylon-mcp/dist/index.js"]
    }
  }
}

Available Tools

Organization

• pylon_get_organization - Get information about your Pylon organization

Accounts

• pylon_list_accounts - List all accounts with pagination
• pylon_get_account - Get a specific account by ID
• pylon_create_account - Create a new account
• pylon_update_account - Update an existing account
• pylon_delete_account - Delete an account
• pylon_search_accounts - Search accounts with filters

Contacts

• pylon_list_contacts - List all contacts with pagination
• pylon_get_contact - Get a specific contact by ID
• pylon_create_contact - Create a new contact
• pylon_update_contact - Update an existing contact
• pylon_delete_contact - Delete a contact
• pylon_search_contacts - Search contacts with filters

Issues

• pylon_list_issues - List issues within a time range
• pylon_get_issue - Get a specific issue by ID
• pylon_create_issue - Create a new issue/ticket
• pylon_update_issue - Update an existing issue
• pylon_delete_issue - Delete an issue
• pylon_search_issues - Search issues with filters
• pylon_snooze_issue - Snooze an issue until a specific time
• pylon_get_issue_followers - Get issue followers
• pylon_update_issue_followers - Add/remove issue followers

Messages

• pylon_redact_message - Redact a message from an issue

Tags

• pylon_list_tags - List all tags
• pylon_get_tag - Get a specific tag by ID
• pylon_create_tag - Create a new tag
• pylon_update_tag - Update an existing tag
• pylon_delete_tag - Delete a tag

Teams

• pylon_list_teams - List all teams
• pylon_get_team - Get a specific team by ID
• pylon_create_team - Create a new team
• pylon_update_team - Update an existing team

Requirements

• Node.js 24+
• Pylon API token (Admin access required)

📄 License

This project is licensed under the MIT license.