What is Pylon Mcp

Pylon MCP is an MCP (Model Context Protocol) server designed for integrating with the Pylon API, allowing users to manage various functionalities such as user information, contacts, issues, and knowledge base articles.

Use cases

Use cases for pylon-mcp include managing user profiles in a customer support application, tracking issues in a project management tool, and maintaining a knowledge base for frequently asked questions and articles.

How to use

To use pylon-mcp, set up the environment by installing the necessary packages and configuring the environment variables. You can run the server locally and integrate it with applications like Claude Desktop by modifying the configuration settings.

Key features

Key features of pylon-mcp include user management, contact management (listing, searching, and creating contacts), issue tracking (listing, filtering, and creating issues), and knowledge base management (accessing and creating articles).

Where to use

Pylon MCP can be used in various fields such as customer support, project management, and any application requiring integration with the Pylon API for managing user data and support resources.

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

User Tools

• pylon_get_me: Get current user information

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

1. 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
   

2. 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"
      }
    }
  }
}

3. 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

1. 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

2. 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.