Pylon MCP Server

An MCP (Model Context Protocol) server for integrating with the Pylon API.

Features

This MCP server provides tools to interact with Pylon's API:

User Management: Get current user information
Contacts: List, search, and create contacts
Issues: List, filter, and create issues
Knowledge Base: Access and create knowledge base articles

Setup

Environment Variables

Set the following environment variable:

PYLON_API_TOKEN: Your Pylon API token (required)

Installation

npm install
npm run build

Development

npm run dev

Available Tools

Contact Tools

pylon_get_contacts: List contacts with optional search and limit
pylon_create_contact: Create a new contact

Issue Tools

pylon_get_issues: List issues with optional filtering by assignee, status, and limit
pylon_create_issue: Create a new issue

Knowledge Base Tools

pylon_get_knowledge_bases: List all knowledge bases
pylon_get_knowledge_base_articles: Get articles from a specific knowledge base
pylon_create_knowledge_base_article: Create a new article in a knowledge base

Usage Examples

Running Locally with Claude Desktop

Setup Environment:

# Clone and install
git clone <your-repo-url>
cd pylon-mcp-server
npm install
npm run build

# Set up environment variables
cp .env.example .env
# Edit .env and add your PYLON_API_TOKEN

Configure Claude Desktop:

Add this to your Claude Desktop MCP settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

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

Test the Connection:

Restart Claude Desktop and try these commands in a conversation:

Use the pylon_get_me tool to check my Pylon user info

Use pylon_get_issues to show recent support tickets

Search for contacts with pylon_search_contacts using "[email protected]"

Running via Smithery

Deploy to Smithery:
- Upload your project to Smithery
- Smithery will automatically use the smithery.yaml configuration
- Set the PYLON_API_TOKEN environment variable in Smithery's deployment settings
Configure in Claude Desktop:

{
  "mcpServers": {
    "pylon": {
      "command": "npx",
      "args": ["-y", "@smithery/pylon-mcp-server"]
    }
  }
}

Example Tool Usage

Once connected, you can use any of the 23+ available tools:

# User Management
"Get my user info" → uses pylon_get_me
"Search for users named John" → uses pylon_search_users

# Issue Management  
"Show all open issues" → uses pylon_get_issues
"Create a new bug report" → uses pylon_create_issue
"Add a comment to issue #123" → uses pylon_create_issue_message

# Knowledge Base
"List all knowledge bases" → uses pylon_get_knowledge_bases
"Create a new help article" → uses pylon_create_knowledge_base_article

# Team & Account Management
"Show all teams" → uses pylon_get_teams
"Get account details" → uses pylon_get_accounts

Deployment to Smithery

This server is designed to be deployed to Smithery using the included smithery.yaml configuration. The deployment will automatically:

Install dependencies with npm install && npm run build
Configure the Node.js runtime with proper entrypoint
Expose all 23 Pylon API tools
Require the PYLON_API_TOKEN environment variable

API Reference

For more information about the Pylon API, visit the API reference.

Pylon