# Pylon Mcp

> MCP server for the Pylon API

- **Type:** MCP server
- **Install:** `agentstack add mcp-marcinwyszynski-pylon-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [marcinwyszynski](https://agentstack.voostack.com/s/marcinwyszynski)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [marcinwyszynski](https://github.com/marcinwyszynski)
- **Source:** https://github.com/marcinwyszynski/pylon-mcp

## Install

```sh
agentstack add mcp-marcinwyszynski-pylon-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
npm install
npm run build
```

### Development

```bash
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**:

   ```bash
   # Clone and install
   git clone 
   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):
  
  ```json
  {
    "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:

  ```text
  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 "customer@example.com"
  ```

### 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**:

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

### Example Tool Usage

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

```text
# 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](https://docs.usepylon.com/pylon-docs/developer/api/api-reference).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [marcinwyszynski](https://github.com/marcinwyszynski)
- **Source:** [marcinwyszynski/pylon-mcp](https://github.com/marcinwyszynski/pylon-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-marcinwyszynski-pylon-mcp
- Seller: https://agentstack.voostack.com/s/marcinwyszynski
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.