@artemsemkin/ticksy-mcp

MCP server for the Ticksy support ticket API. Gives AI agents full read and write access to your support tickets.

Tools

Read

• list_open_tickets — open tickets with embedded comments; optionally filter to those awaiting a reply
• list_closed_tickets — most recently closed tickets
• get_ticket — single ticket with full comment thread
• get_ticket_comments — comments for a ticket without full ticket data
• list_my_tickets — open tickets assigned to the authenticated agent
• count_responses_needed — number of tickets awaiting a support response
• count_my_responses — same, scoped to the authenticated agent

Write

• reply_to_ticket — post a public reply (or staff-only with private: true)
• add_ticket_note — post an internal note visible only to staff
• close_ticket / reopen_ticket — change ticket status
• mark_ticket_read / mark_ticket_unread — toggle read state
• star_ticket / unstar_ticket — toggle star
• create_customer — create a new customer account

Setup

You need two environment variables:

• `TICKSY_DOMAIN` — your subdomain (e.g. acme for acme.ticksy.com)
• `TICKSY_API_KEY` — from your Ticksy profile page

<details> <summary>Claude Desktop</summary>

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ticksy": {
      "command": "npx",
      "args": ["-y", "@artemsemkin/ticksy-mcp"],
      "env": {
        "TICKSY_DOMAIN": "your-domain",
        "TICKSY_API_KEY": "your-api-key"
      }
    }
  }
}

</details>

<details> <summary>Claude Code</summary>

claude mcp add ticksy \
  -e TICKSY_DOMAIN=your-domain \
  -e TICKSY_API_KEY=your-api-key \
  -- npx -y @artemsemkin/ticksy-mcp

</details>

<details> <summary>VS Code / Cursor</summary>

Add to .vscode/mcp.json (VS Code) or .cursor/mcp.json (Cursor) in your project:

{
  "servers": {
    "ticksy": {
      "command": "npx",
      "args": ["-y", "@artemsemkin/ticksy-mcp"],
      "env": {
        "TICKSY_DOMAIN": "your-domain",
        "TICKSY_API_KEY": "your-api-key"
      }
    }
  }
}

</details>

Build from source

git clone https://github.com/artkrsk/@artemsemkin/ticksy-mcp.git
cd @artemsemkin/ticksy-mcp
pnpm install
pnpm build