@helmdesk/mcp

MCP (Model Context Protocol) server for Helmdesk — let AI agents manage support tickets, send emails, and search your knowledge base.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "helmdesk": {
      "command": "npx",
      "args": ["-y", "@helmdesk/mcp"],
      "env": {
        "HELMDESK_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add helmdesk -- npx -y @helmdesk/mcp

Then set the environment variable:

export HELMDESK_API_KEY=sk_live_your_api_key_here

Direct Usage

HELMDESK_API_KEY=sk_live_xxx npx @helmdesk/mcp

Available Tools

| Tool | Description | |---|---| | list_tickets | List tickets with filters (status, priority, search, pagination) | | get_ticket | Get full ticket details with message thread | | create_ticket | Create a new support ticket | | update_ticket | Update ticket status, priority, or category | | reply_to_ticket | Send a staff reply to a ticket | | send_email | Send a transactional email using a template | | preview_email | Preview a rendered email template | | get_template_schema | Get the variable schema for an email template | | search_articles | Search the knowledge base |

Available Resources

| Resource | URI | Description | |---|---|---| | Open tickets | helmdesk://tickets/open | All tickets with status new or open | | Pending tickets | helmdesk://tickets/pending | Tickets waiting for staff response | | Knowledge base | helmdesk://articles | All published articles |

Example Prompts

Once connected, you can ask your AI agent:

• "Show me all open tickets"
• "Read ticket #42 and draft a reply"
• "Search the knowledge base for articles about file uploads"
• "Create a ticket for [email protected] about a billing issue"
• "Resolve ticket abc-123 and send a follow-up email"
• "Check my pending tickets and draft replies for any waiting more than 24 hours"

Configuration

| Environment Variable | Required | Description | |---|---|---| | HELMDESK_API_KEY | Yes | Your Helmdesk API key (starts with sk_live_) | | HELMDESK_BASE_URL | No | Custom API base URL (default: https://helmdesk.dev) |

Getting an API Key

1. Sign in at helmdesk.dev
2. Go to your project → API Keys
3. Click Create API Key and copy the key

License

MIT