# pylon-mcp
<img src="https://raw.githubusercontent.com/justinbeckwith/pylon-mcp/main/pylon-mcp.png" alt="pylon-mcp" width="400" />
MCP (Model Context Protocol) server for [Pylon](https://www.usepylon.com/) customer support platform.
## Installation
```bash
corepack enable
pnpm install
pnpm run build
```
## Configuration
1. Copy the example environment file:
```bash
cp .env.example .env
```
2. Edit `.env` and add your Pylon API token:
```
PYLON_API_TOKEN=your_api_token_here
```
You can generate an API token from the [Pylon dashboard](https://app.usepylon.com/settings/api-tokens). Note: Only Admin users can create API tokens.
## Usage
### With Claude Desktop
Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"pylon": {
"command": "node",
"args": ["--env-file", "/path/to/pylon-mcp/.env", "/path/to/pylon-mcp/dist/index.js"]
}
}
}
```
### With Claude Code
Add to your Claude Code MCP settings:
```json
{
"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
MIT