ticksy-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artem Semkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# ticksy-mcp
+
+MCP server for the [Ticksy](https://ticksy.com) 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](https://ticksy.com)
+
+<details>
+<summary>Claude Desktop</summary>
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "ticksy": {
+      "command": "npx",
+      "args": ["-y", "ticksy-mcp"],
+      "env": {
+        "TICKSY_DOMAIN": "your-domain",
+        "TICKSY_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary>Claude Code</summary>
+
+```bash
+claude mcp add ticksy \
+  -e TICKSY_DOMAIN=your-domain \
+  -e TICKSY_API_KEY=your-api-key \
+  -- npx -y ticksy-mcp
+```
+</details>
+
+<details>
+<summary>VS Code / Cursor</summary>
+
+Add to `.vscode/mcp.json` (VS Code) or `.cursor/mcp.json` (Cursor) in your project:
+
+```json
+{
+  "servers": {
+    "ticksy": {
+      "command": "npx",
+      "args": ["-y", "ticksy-mcp"],
+      "env": {
+        "TICKSY_DOMAIN": "your-domain",
+        "TICKSY_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+</details>
+
+## Build from source
+
+```bash
+git clone https://github.com/artkrsk/ticksy-mcp.git
+cd ticksy-mcp
+pnpm install
+pnpm build
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { listOpenTickets, listClosedTickets, getTicket, getTicketComments, listMyTickets, countResponsesNeeded, countMyResponsesNeeded, closeTicket, openTicket, markAsRead, markAsUnread, starTicket, unstarTicket, createCustomer, replyToTicket, addTicketNote, } from './ticksy.js';
+// ── Validate env ───────────────────────────────────────────────
+if (!process.env.TICKSY_DOMAIN || !process.env.TICKSY_API_KEY) {
+    console.error('Missing required env vars: TICKSY_DOMAIN, TICKSY_API_KEY');
+    process.exit(1);
+}
+// ── Server ─────────────────────────────────────────────────────
+const server = new McpServer({ name: 'ticksy', version: '1.0.0' }, { capabilities: { logging: {} } });
+// ── Helpers ────────────────────────────────────────────────────
+async function run(fn, format = v => JSON.stringify(v, null, 2)) {
+    try {
+        const result = await fn();
+        return { content: [{ type: 'text', text: format(result) }] };
+    }
+    catch (err) {
+        return { isError: true, content: [{ type: 'text', text: String(err) }] };
+    }
+}
+const TICKET_ID_SCHEMA = {
+    ticket_id: z.string().describe('The Ticksy ticket ID'),
+};
+// ── Read tools ──────────────────────────────────────────────────
+server.registerTool('list_open_tickets', {
+    description: 'List open support tickets, each with embedded comments.',
+    inputSchema: {
+        needs_response_only: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('If true, return only tickets where the customer is waiting for a reply'),
+    },
+}, async ({ needs_response_only }) => run(() => listOpenTickets(needs_response_only)));
+server.registerTool('list_closed_tickets', { description: 'List the most recently closed support tickets.' }, async () => run(() => listClosedTickets()));
+server.registerTool('get_ticket', {
+    description: 'Get a single ticket with its full comment thread.',
+    inputSchema: TICKET_ID_SCHEMA,
+}, async ({ ticket_id }) => run(() => getTicket(ticket_id)));
+server.registerTool('get_ticket_comments', {
+    description: 'Get comments for a ticket without full ticket data.',
+    inputSchema: TICKET_ID_SCHEMA,
+}, async ({ ticket_id }) => run(() => getTicketComments(ticket_id)));
+server.registerTool('list_my_tickets', { description: 'List open tickets assigned to the authenticated agent.' }, async () => run(() => listMyTickets()));
+server.registerTool('count_responses_needed', { description: 'Count open tickets awaiting a support response.' }, async () => run(() => countResponsesNeeded(), String));
+server.registerTool('count_my_responses', { description: 'Count tickets assigned to you that await a response.' }, async () => run(() => countMyResponsesNeeded(), String));
+// ── Write tools ─────────────────────────────────────────────────
+server.registerTool('reply_to_ticket', {
+    description: 'Post a public reply visible to the customer.',
+    annotations: { readOnlyHint: false },
+    inputSchema: {
+        ticket_id: z.string().describe('The Ticksy ticket ID'),
+        comment: z.string().describe('Reply body (HTML is accepted)'),
+        private: z.boolean().optional().default(false).describe('If true, the reply is visible only to staff'),
+    },
+}, async ({ ticket_id, comment, private: isPrivate }) => run(() => replyToTicket(ticket_id, comment, isPrivate)));
+server.registerTool('add_ticket_note', {
+    description: 'Post an internal note visible only to staff.',
+    annotations: { readOnlyHint: false },
+    inputSchema: {
+        ticket_id: z.string().describe('The Ticksy ticket ID'),
+        comment: z.string().describe('Note body (HTML is accepted)'),
+    },
+}, async ({ ticket_id, comment }) => run(() => addTicketNote(ticket_id, comment)));
+const SIMPLE_WRITE_TOOLS = [
+    ['close_ticket', 'Close an open ticket.', closeTicket],
+    ['reopen_ticket', 'Reopen a closed ticket.', openTicket],
+    ['mark_ticket_read', 'Mark a ticket as read.', markAsRead],
+    ['mark_ticket_unread', 'Mark a ticket as unread.', markAsUnread],
+    ['star_ticket', 'Star a ticket for follow-up.', starTicket],
+    ['unstar_ticket', 'Remove star from a ticket.', unstarTicket],
+];
+for (const [name, description, fn] of SIMPLE_WRITE_TOOLS) {
+    server.registerTool(name, { description, annotations: { readOnlyHint: false }, inputSchema: TICKET_ID_SCHEMA }, async ({ ticket_id }) => run(() => fn(ticket_id)));
+}
+server.registerTool('create_customer', {
+    description: 'Create a new customer account.',
+    annotations: { readOnlyHint: false },
+    inputSchema: {
+        first_name: z.string().describe('Customer first name'),
+        email: z.string().describe('Customer email address'),
+        password: z.string().describe('Account password'),
+    },
+}, async ({ first_name, email, password }) => run(() => createCustomer(first_name, email, password)));
+// ── Start ──────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/ticksy.d.ts

@@ -0,0 +1,70 @@
+export interface TicketComment {
+    comment_id: string;
+    ticket_id: string;
+    user_id: string;
+    commenter_name: string;
+    commenter_email: string;
+    user_type: 'user' | 'employee';
+    comment: string;
+    body?: string;
+    private: '0' | '1';
+    type: 'comment' | 'note';
+    time_stamp: string;
+    quoted_text: string | null;
+    attachments: Array<{
+        id: string;
+        file_url: string;
+        file_name: string;
+    }>;
+    post_date?: string;
+    user_avatar?: string;
+    user_likes?: string;
+    my_reply?: '0' | '1';
+    username?: string;
+    status_string?: string;
+}
+export interface Ticket {
+    ticket_title: string;
+    status: 'open' | 'closed';
+    time_stamp: string;
+    needs_response: '0' | '1';
+    starred: '0' | '1';
+    ticket_type: string;
+    user_id: string;
+    assigned_to: string;
+    assigned_to_email: string;
+    category_id: string;
+    related_url: string;
+    ticket_id?: string;
+    elapsed_time?: string;
+    user_name?: string;
+    user_email?: string;
+    user_avatar?: string;
+    assigned_to_name?: string;
+    response_time?: string;
+    envato_purchase_code?: string;
+    envato_verified_string?: string;
+    ticket_comments?: TicketComment[];
+    opened_by_me?: '0' | '1';
+    unsubscribed?: '0' | '1';
+}
+export declare function listOpenTickets(needsResponseOnly?: boolean): Promise<Ticket[]>;
+export declare function listClosedTickets(): Promise<Ticket[]>;
+export declare function getTicket(ticketId: string): Promise<{
+    data: Ticket;
+    comments: TicketComment[];
+}>;
+export declare function getTicketComments(ticketId: string): Promise<TicketComment[]>;
+export declare function listMyTickets(): Promise<Ticket[]>;
+export declare function countResponsesNeeded(): Promise<number>;
+export declare function countMyResponsesNeeded(): Promise<number>;
+export declare function closeTicket(ticketId: string): Promise<unknown>;
+export declare function openTicket(ticketId: string): Promise<unknown>;
+export declare function markAsRead(ticketId: string): Promise<unknown>;
+export declare function markAsUnread(ticketId: string): Promise<unknown>;
+export declare function starTicket(ticketId: string): Promise<unknown>;
+export declare function unstarTicket(ticketId: string): Promise<unknown>;
+export declare function createCustomer(firstName: string, email: string, password: string): Promise<unknown>;
+export declare function replyToTicket(ticketId: string, comment: string, isPrivate?: boolean): Promise<unknown>;
+export declare function addTicketNote(ticketId: string, comment: string): Promise<unknown>;
+//# sourceMappingURL=ticksy.d.ts.map

package/dist/ticksy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticksy.d.ts","sourceRoot":"","sources":["../src/ticksy.ts"],"names":[],"mappings":"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"}

package/dist/ticksy.js

@@ -0,0 +1,98 @@
+import { html as htmlDecode } from './utils.js';
+const BASE_URL = `https://api.ticksy.com/v1/${process.env.TICKSY_DOMAIN}/${process.env.TICKSY_API_KEY}`;
+// ── Helpers ────────────────────────────────────────────────────
+function decodeComment(comment) {
+    return { ...comment, body: htmlDecode(comment.comment) };
+}
+function decodeTicket(ticket) {
+    return {
+        ...ticket,
+        ticket_comments: (ticket.ticket_comments ?? []).map(decodeComment),
+    };
+}
+async function get(path) {
+    const res = await fetch(`${BASE_URL}/${path}`, { signal: AbortSignal.timeout(15_000) });
+    if (!res.ok) {
+        throw new Error(`Ticksy API ${path}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+async function post(action, params = {}) {
+    const body = new URLSearchParams({ action, ...params });
+    const res = await fetch(BASE_URL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body,
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok) {
+        throw new Error(`Ticksy API ${action}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+// ── API calls ──────────────────────────────────────────────────
+export async function listOpenTickets(needsResponseOnly = false) {
+    const data = await get('open-tickets.json');
+    const tickets = (data['open-tickets'] ?? []).map(decodeTicket);
+    return needsResponseOnly ? tickets.filter(t => t.needs_response === '1') : tickets;
+}
+export async function listClosedTickets() {
+    const data = await get('closed-tickets.json');
+    return (data['closed-tickets'] ?? []).map(decodeTicket);
+}
+export async function getTicket(ticketId) {
+    const raw = await get(`ticket.json/${ticketId}`);
+    return {
+        data: decodeTicket(raw['ticket-data']),
+        comments: (raw['ticket-comments'] ?? []).map(decodeComment),
+    };
+}
+export async function getTicketComments(ticketId) {
+    const data = await get(`ticket-comments.json/${ticketId}`);
+    return (data.ticket_comments ?? []).map(decodeComment);
+}
+export async function listMyTickets() {
+    const data = await get('my-tickets.json');
+    return (data['my-tickets'] ?? []).map(decodeTicket);
+}
+export async function countResponsesNeeded() {
+    const data = await get('responses-needed.json');
+    return parseInt(data['responses-needed'] ?? '0', 10);
+}
+export async function countMyResponsesNeeded() {
+    const data = await get('my-responses-needed.json');
+    return parseInt(data['responses-needed'] ?? '0', 10);
+}
+// ── Write operations ────────────────────────────────────────────
+export async function closeTicket(ticketId) {
+    return post('close_ticket', { ticket_id: ticketId });
+}
+export async function openTicket(ticketId) {
+    return post('open_ticket', { ticket_id: ticketId });
+}
+export async function markAsRead(ticketId) {
+    return post('mark_as_read', { ticket_id: ticketId });
+}
+export async function markAsUnread(ticketId) {
+    return post('mark_as_unread', { ticket_id: ticketId });
+}
+export async function starTicket(ticketId) {
+    return post('star_ticket', { ticket_id: ticketId });
+}
+export async function unstarTicket(ticketId) {
+    return post('unstar_ticket', { ticket_id: ticketId });
+}
+export async function createCustomer(firstName, email, password) {
+    return post('new_customer', { first_name: firstName, email_address: email, password });
+}
+export async function replyToTicket(ticketId, comment, isPrivate = false) {
+    const params = { ticket_id: ticketId, comment };
+    if (isPrivate) {
+        params.private = 'true';
+    }
+    return post('new_ticket_comment', params);
+}
+export async function addTicketNote(ticketId, comment) {
+    return post('new_ticket_note', { ticket_id: ticketId, comment });
+}
+//# sourceMappingURL=ticksy.js.map

package/dist/ticksy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticksy.js","sourceRoot":"","sources":["../src/ticksy.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Decode HTML entities in a string.
+ * Ticksy returns comment bodies as HTML-encoded strings.
+ */
+export declare function html(encoded: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc5C"}

package/dist/utils.js

@@ -0,0 +1,20 @@
+/**
+ * Decode HTML entities in a string.
+ * Ticksy returns comment bodies as HTML-encoded strings.
+ */
+export function html(encoded) {
+    return encoded
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        .replace(/&quot;/g, '"')
+        .replace(/&#039;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        // Strip HTML tags — return plain text
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,OAAO;SACX,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;QACxB,sCAAsC;SACrC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAA;AACX,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "ticksy-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Ticksy support ticket API",
+  "author": "Artem Semkin",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ticksy-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^22.13.14"
+  }
+}