Skip to main content
Glama
Pylon MCP Server

Pylon MCP Server

by gasconc

Pylon MCP Server

MCP (Model Context Protocol) server for integrating with the Pylon API. This server provides tools for managing accounts, issues, messages, and custom fields in Pylon.

Features

  • Accounts: List, get, create, and update accounts

  • Issues: List, get, create, update, and search support issues with advanced filters

  • Messages: Get issue messages and redact messages

  • Custom Fields: List, get, create, and update custom fields

Related MCP server: Pylon MCP Server

Prerequisites

  • Node.js 18 or higher

  • A Pylon account with API access

  • Pylon API token

Installation

  1. Clone or navigate to the project directory:

cd pylon-mcp-server
  1. Install dependencies:

npm install
  1. Set up your environment variables:

cp env.example .env
  1. Edit .env and add your Pylon API token:

PYLON_API_TOKEN=your_pylon_api_token_here

Configuration in Cursor

Add the following to your Cursor MCP settings file (~/.cursor/mcp.json or the project's .cursor/mcp.json):

{
  "mcpServers": {
    "pylon": {
      "command": "node",
      "args": ["/path/to/pylon-mcp-server/src/index.js"],
      "env": {
        "PYLON_API_TOKEN": "your_pylon_api_token_here"
      }
    }
  }
}

Replace /path/to/pylon-mcp-server with the actual path to this project.

Available Tools

Accounts

Tool

Description

pylon_list_accounts

List all accounts with optional pagination

pylon_get_account

Get a specific account by ID

pylon_create_account

Create a new account

pylon_update_account

Update an existing account

Issues

Tool

Description

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

pylon_update_issue

Update an existing issue

pylon_search_issues

Search issues with advanced filters (state, priority, assignee, tags, etc.)

Messages

Tool

Description

pylon_get_issue_messages

Get all messages for a specific issue

pylon_redact_message

Redact a specific message in an issue

Custom Fields

Tool

Description

pylon_list_custom_fields

List custom fields by object type (account, issue, contact)

pylon_get_custom_field

Get a specific custom field by ID

pylon_create_custom_field

Create a new custom field

pylon_update_custom_field

Update an existing custom field

Usage Examples

List accounts

List all accounts in Pylon

Get issues from last week

List all issues from the last 7 days

Create a new account

Create a new account named "Acme Corp" with domain "acme.com"

Search for open high-priority issues

Search for all open issues with high or urgent priority

The pylon_search_issues tool supports complex filters with AND/OR operators:

{
  "filter": {
    "operator": "and",
    "subfilters": [
      { "field": "state", "operator": "equals", "value": "open" },
      { "field": "priority", "operator": "in", "values": ["high", "urgent"] }
    ]
  },
  "limit": 50
}

Available filter fields: state, priority, assignee.id, account.id, tags, requester.email, source, team.id

Create a custom field

Create a select custom field called "Priority Level" for issues with options: Low, Medium, High

API Reference

For more information about the Pylon API, see:

Development

Run in development mode with auto-reload:

npm run dev

License

MIT

Available Tools

36 tools
pylon_create_accountB

Create a new account in Pylon.

Inputs: name (required), tags, type, domains, +3 more.

pylon_create_articleC

Create a new article within a knowledge base.

Inputs: title (required), body_html (required), author_user_id (required), knowledge_base_id (required), +6 more.

pylon_create_collectionB

Create a new collection within a knowledge base.

Inputs: title (required), knowledge_base_id (required), slug, description, +1 more.

pylon_create_custom_fieldB

Create a new custom field in Pylon.

Inputs: type (required), label (required), object_type (required), slug, +4 more.

pylon_create_issueC

Create a new issue in Pylon.

Inputs: body_html (required), tags, state, title, +4 more.

pylon_create_milestoneB

Create a new milestone in Pylon. Rate limit: 60 requests per minute.

Inputs: name (required), project_id (required), due_date, account_id.

pylon_create_projectB

Create a new project in Pylon. Rate limit: 60 requests per minute.

Inputs: name (required), account_id (required), end_date, owner_id, +4 more.

pylon_create_route_redirectA

Create a path redirect within a knowledge base, mapping a source path to an article or collection.

Inputs: from_path (required), object_id (required), object_type (required), knowledge_base_id (required), +1 more.

pylon_create_taskB

Create a new task in Pylon. Rate limit: 60 requests per minute.

Inputs: title (required), status, due_date, body_html, +5 more.

pylon_delete_articleA

Permanently delete an article from a knowledge base.

Inputs: article_id (required), knowledge_base_id (required).

pylon_delete_milestoneA

Delete an existing milestone in Pylon. Rate limit: 60 requests per minute.

Inputs: milestone_id (required).

pylon_delete_projectA

Delete an existing project in Pylon. Rate limit: 20 requests per minute.

Inputs: project_id (required).

pylon_delete_taskB

Delete an existing task in Pylon. Rate limit: 20 requests per minute.

Inputs: task_id (required).

pylon_get_accountA

Get a specific account by its ID.

Inputs: account_id (required).

pylon_get_articleA

Get a specific article by its ID within a knowledge base.

Inputs: article_id (required), knowledge_base_id (required).

pylon_get_collectionA

Get a specific collection by its ID within a knowledge base.

Inputs: collection_id (required), knowledge_base_id (required).

pylon_get_custom_fieldA

Get a specific custom field by its ID.

Inputs: custom_field_id (required).

pylon_get_issueA

Get a specific issue by its ID.

Inputs: issue_id (required).

pylon_get_issue_messagesB

Get all messages for a specific issue.

Inputs: issue_id (required), limit, cursor.

pylon_get_knowledge_baseA

Get a specific knowledge base by its ID.

Inputs: knowledge_base_id (required).

pylon_list_accountsA

List all accounts in Pylon with optional pagination.

Inputs: limit, cursor.

pylon_list_articlesA

List all articles in a knowledge base with optional pagination.

Inputs: knowledge_base_id (required), limit, cursor.

pylon_list_collectionsA

List all collections in a knowledge base.

Inputs: knowledge_base_id (required).

pylon_list_custom_fieldsA

List all custom fields for a specific object type.

Inputs: object_type (required), cursor.

pylon_list_issuesB

List issues within a time range in Pylon.

Inputs: end_time (required), start_time (required), limit, cursor.

pylon_list_knowledge_basesA

List all knowledge bases for the organization.

Inputs: no named parameters.

pylon_redact_messageB

Redact a specific message in an issue.

Inputs: issue_id (required), message_id (required).

pylon_search_issuesA

Search issues in Pylon using filters. Supports complex queries with AND/OR operators and nested filters. Common filter fields: state, priority, assignee_id, account_id, tags, requester.email, source, team_id.

Inputs: limit, cursor, filter.

pylon_update_accountC

Update an existing account in Pylon.

Inputs: account_id (required), name, tags, type, +4 more.

pylon_update_articleA

Update an existing article in a knowledge base. Only provided fields are modified.

Inputs: article_id (required), knowledge_base_id (required), title, language, +3 more.

pylon_update_custom_fieldB

Update an existing custom field in Pylon.

Inputs: custom_field_id (required), slug, label, description, +3 more.

pylon_update_issueC

Update an existing issue in Pylon.

Inputs: issue_id (required), tags, state, title, +3 more.

pylon_update_milestoneB

Update an existing milestone in Pylon. Rate limit: 60 requests per minute.

Inputs: milestone_id (required), name, due_date.

pylon_update_projectB

Update an existing project in Pylon. Rate limit: 60 requests per minute.

Inputs: project_id (required), name, end_date, owner_id, +4 more.

pylon_update_taskB

Update an existing task in Pylon. Rate limit: 60 requests per minute.

Inputs: task_id (required), title, status, due_date, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 36 tools

    Disambiguation5/5

    Each tool targets a distinct resource-action combination (e.g., account, issue, article). Overlapping concepts like list_issues vs search_issues are clearly differentiated by scope (time range vs complex filters). No two tools appear to do the same thing.

    Naming Consistency5/5

    All tools follow a consistent 'pylon_verb_noun' pattern with snake_case verbs (list, get, create, update, delete, search). The naming is predictable and uniform across all resources.

    Tool Count2/5

    At 36 tools, the set is substantially larger than typical MCP servers. While it covers multiple resource types, many resources (projects, tasks, milestones) lack corresponding list/get tools, making the count feel inflated rather than comprehensive.

    Completeness2/5

    Major gaps exist: projects, tasks, and milestones have create/update/delete but no list/get operations, leaving no way to retrieve them. Custom fields lack delete, and collections lack update/delete. These are critical CRUD omissions.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers