home / mcp / pylon mcp server

Pylon MCP Server

MCP server for Pylon customer support platform enabling programmatic access to organizations, accounts, contacts, issues, messages, tags, and teams.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run the MCP (Model Context Protocol) server to enable programmatic access to Pylon customer data and actions. This server acts as the bridge between your MCP client and Pylon, exposing endpoints for organizations, accounts, contacts, issues, messages, tags, and teams. It lets you automate workflows, build integrations, and manage data through a consistent API surface.

How to use

Use the MCP server with your MCP client to connect to Pylon and perform operations like listing accounts, creating issues, or updating teammates. You load your API token from a local environment file and start the server locally, then configure your client to point at the local process or a remote MCP endpoint.

Configure your Claude Desktop or Claude Code to load the MCP server you run locally. The server runs via Node and reads your environment file to authenticate with Pylon.

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

How to install

Prerequisites: you need Node.js 24+ installed on your system. You will also work with a package manager to install dependencies and build the MCP server.

Install and build the MCP server dependencies, then prepare to run the server locally.

corepack enable
pnpm install
pnpm run build

Configuration

Create your environment file from the example, then add your Pylon API token. This token authenticates requests to Pylon.

cp .env.example .env
```
```bash
PYLON_API_TOKEN=your_api_token_here

Usage notes

You will load the API token from the environment file when starting the MCP server. Only Admin users can generate API tokens in the Pylon dashboard.

To run with Claude Desktop or Claude Code, reference the local MCP server configuration and point your client at the same Node process started by the server.

Available tools

pylon_get_organization

Retrieve information about your Pylon organization.

pylon_list_accounts

List all accounts with optional pagination.

pylon_get_account

Fetch a specific account by its ID.

pylon_create_account

Create a new account in your Pylon instance.

pylon_update_account

Update details for an existing account.

pylon_delete_account

Remove an account from your Pylon instance.

pylon_search_accounts

Search accounts using filters.

pylon_list_contacts

List contacts with optional 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.

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 or 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 followers of an issue.

pylon_update_issue_followers

Add or remove followers for an issue.

pylon_redact_message

Redact a message from an issue.

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.

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.