@helmdesk/mcp 0.5.0 → 0.7.0

package/README.md

@@ -68,8 +68,19 @@ HELMDESK_API_KEY=sk_live_xxx npx @helmdesk/mcp
 | `write_log` | Ship log events to the project (sandbox events are quota-exempt) |
 | `query_logs` | Query raw application log events (filter by level, search, fingerprint) |
 | `list_log_issues` | List grouped error issues — "did anything break?" |
-
-15 tools in total — `tickets:write` is required for ticket mutations and `add_ticket_tag`/`remove_ticket_tag`, `emails:send` for `send_email`/`send_email_batch` (batch also needs the Pro plan or higher), `articles:write` for `create_article`, `logs:read` for `query_logs`/`list_log_issues`. A key with empty scopes has full access.
+| `list_feedback_conversations` | List feedback conversations (filter by status, rating, source, customer, search, date range) |
+| `get_feedback_conversation` | Get a feedback conversation with its full message thread |
+| `reply_to_feedback` | Post a staff reply to a feedback conversation (emailed to the customer) |
+| `close_feedback_conversation` | Close a handled conversation (or reopen it via `status: "open"`) |
+| `list_feedback_requests` | List outgoing feedback requests with funnel status (sent/opened/responded) |
+| `request_feedback` | Create a feedback request and email the customer a branded respond link |
+| `list_customers` | List/search the customer directory (filter by email/name/company text or your app's `externalId`) |
+| `get_customer` | Get a customer with their full interaction history (tickets + feedback) — "who is this person?" |
+| `create_customer` | Create or pre-load a customer (set `externalId` to your own app's user id) |
+| `update_customer` | Update a customer's profile — incl. the staff-only `internalNote` for CRM-style context |
+| `delete_customer` | Remove a customer (their tickets/feedback are untouched) |
+
+36 tools in total — `tickets:write` is required for ticket mutations and `add_ticket_tag`/`remove_ticket_tag`, `emails:send` for `send_email`/`send_email_batch` (batch also needs the Pro plan or higher), `articles:write` for `create_article`, `logs:read` for `query_logs`/`list_log_issues`, `feedback:read` for the feedback list/get tools and `feedback:write` for `reply_to_feedback`/`close_feedback_conversation`/`request_feedback`, `customers:read` for `list_customers`/`get_customer` and `customers:write` for `create_customer`/`update_customer`/`delete_customer`. A key with empty scopes has full access.
 
 ## Available Resources
 
@@ -91,6 +102,10 @@ Once connected, you can ask your AI agent:
 - "Check my pending tickets and draft replies for any waiting more than 24 hours"
 - "List unassigned billing tickets, tag the urgent ones `needs-engineering`, and assign them to me"
 - "We keep getting the same SSO question — write a published KB article answering it, then reply to ticket #88 linking it"
+- "Show me open feedback conversations rated 3 or below and draft replies"
+- "Send a feedback request to jane@example.com asking how onboarding went"
+- "Who is jane@example.com? Show me everything she's asked us and any feedback she's given"
+- "Add an internal note to that customer: churn risk, complained about pricing twice"
 
 ## Testing
 

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAWnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CA0B9E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAanE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CA4B9E"}

package/dist/server.js

@@ -4,6 +4,8 @@ import { registerTicketTools } from './tools/tickets.js';
 import { registerEmailTools } from './tools/emails.js';
 import { registerArticleTools } from './tools/articles.js';
 import { registerLogTools } from './tools/logs.js';
+import { registerFeedbackTools } from './tools/feedback.js';
+import { registerCustomerTools } from './tools/customers.js';
 import { registerTeamTools } from './tools/team.js';
 import { registerWebhookTools } from './tools/webhooks.js';
 import { registerTicketResources } from './resources/tickets.js';
@@ -23,6 +25,8 @@ export function createHelmdeskMcpServer(options) {
     registerEmailTools(server, getClient);
     registerArticleTools(server, getClient);
     registerLogTools(server, getClient);
+    registerFeedbackTools(server, getClient);
+    registerCustomerTools(server, getClient);
     registerTeamTools(server, getClient);
     registerWebhookTools(server, getClient);
     // Register all resources

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAOlE,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,MAAM,CAAA;IAE9B,qBAAqB;IACrB,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACrC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACvC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnC,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACpC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEvC,yBAAyB;IACzB,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAE3C,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAOlE,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,MAAM,CAAA;IAE9B,qBAAqB;IACrB,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACrC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACvC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnC,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACxC,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACxC,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACpC,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAEvC,yBAAyB;IACzB,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAE3C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/tools/customers.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HelmdeskClient } from '@helmdesk/sdk';
+export declare function registerCustomerTools(server: McpServer, getClient: () => HelmdeskClient): void;
+//# sourceMappingURL=customers.d.ts.map

package/dist/tools/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/tools/customers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,QAgIvF"}

package/dist/tools/customers.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+export function registerCustomerTools(server, getClient) {
+    server.tool('list_customers', 'List the project\'s customers, most recently seen first (requires the customers:read scope). The directory builds itself from tickets and feedback, so this is everyone who has ever interacted with the project. Use search to match email/name/company, or externalId to resolve one of YOUR app\'s user ids to its Helmdesk customer.', {
+        search: z.string().optional().describe('Substring match on email, name, or company'),
+        externalId: z.string().optional()
+            .describe('Exact match on the customer\'s id in the installer\'s own app (their user id)'),
+        page: z.number().optional().describe('Page number (default: 1)'),
+        limit: z.number().optional().describe('Results per page (default: 25, max: 100)'),
+    }, async (params) => {
+        const client = getClient();
+        const result = await client.customers.list({
+            search: params.search,
+            externalId: params.externalId,
+            page: params.page,
+            limit: params.limit,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('get_customer', 'Get a customer including their full interaction history — their tickets and feedback conversations, joined by email, recent-first, capped at 50 each (requires the customers:read scope). This is the best "who is this person?" tool: one call gives you their profile (name, company, externalId, staff-only internalNote, metadata) plus everything they ever asked or said.', {
+        customerId: z.string().describe('The customer ID (UUID). Find it via list_customers.'),
+    }, async ({ customerId }) => {
+        const client = getClient();
+        const result = await client.customers.get(customerId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('create_customer', 'Create a customer explicitly (requires the customers:write scope). Customers are also created automatically when someone opens a ticket or gives feedback — use this to pre-load or enrich the directory, e.g. syncing your own user base with externalId set to your app\'s user id. Fails with a 409 conflict if the email already exists in this environment.', {
+        email: z.string().email().describe('Customer email — unique per project + environment, immutable after creation'),
+        name: z.string().optional().describe('Display name (max 200 characters)'),
+        company: z.string().optional().describe('Company name (max 200 characters)'),
+        externalId: z.string().optional()
+            .describe('The customer\'s id in the installer\'s own app, e.g. their user id (max 200 characters)'),
+        internalNote: z.string().optional()
+            .describe('Staff-only note, never shown to the customer (max 5000 characters)'),
+        metadata: z.record(z.unknown()).optional()
+            .describe('Arbitrary JSON metadata (at most 8 KB serialized)'),
+    }, async (params) => {
+        const client = getClient();
+        const result = await client.customers.create({
+            email: params.email,
+            name: params.name,
+            company: params.company,
+            externalId: params.externalId,
+            internalNote: params.internalNote,
+            metadata: params.metadata,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('update_customer', 'Update a customer\'s profile (requires the customers:write scope). Email is immutable — it is the join key back to tickets and feedback. internalNote is a staff-only, CRM-style note the customer never sees: use it to record context like "churn risk, complained about pricing in March" so the next agent (human or AI) has the backstory. Pass null to clear a field.', {
+        customerId: z.string().describe('The customer ID (UUID)'),
+        name: z.string().nullable().optional().describe('Display name (null clears)'),
+        company: z.string().nullable().optional().describe('Company name (null clears)'),
+        externalId: z.string().nullable().optional()
+            .describe('The customer\'s id in the installer\'s own app (null clears)'),
+        internalNote: z.string().nullable().optional()
+            .describe('Staff-only CRM-style note, never shown to the customer (null clears, max 5000 characters)'),
+        metadata: z.record(z.unknown()).nullable().optional()
+            .describe('Arbitrary JSON metadata, at most 8 KB serialized (null clears)'),
+    }, async ({ customerId, ...patch }) => {
+        const client = getClient();
+        const result = await client.customers.update(customerId, {
+            name: patch.name,
+            company: patch.company,
+            externalId: patch.externalId,
+            internalNote: patch.internalNote,
+            metadata: patch.metadata,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('delete_customer', 'Delete a customer from the directory (requires the customers:write scope). Their tickets and feedback conversations are untouched — linkage is by email, not foreign key — and any new interaction from the same email simply re-creates the customer.', {
+        customerId: z.string().describe('The customer ID (UUID)'),
+    }, async ({ customerId }) => {
+        const client = getClient();
+        const result = await client.customers.delete(customerId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=customers.js.map

package/dist/tools/customers.js.map

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

package/dist/tools/feedback.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HelmdeskClient } from '@helmdesk/sdk';
+export declare function registerFeedbackTools(server: McpServer, getClient: () => HelmdeskClient): void;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/tools/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/tools/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAOnD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,QA6KvF"}

package/dist/tools/feedback.js

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+// The SDK does not expose a feedback resource yet, so these tools call the
+// v1 feedback endpoints through the client's public `request()` method — the
+// same primitive every SDK resource class is built on. Swap to
+// `client.feedback.*` once the SDK grows a feedback resource.
+export function registerFeedbackTools(server, getClient) {
+    server.tool('list_feedback_conversations', 'List feedback conversations (customer feedback threads) with optional filters, newest first (requires the feedback:read scope). Each conversation has a title, status (open/closed), optional 1-5 rating, source (request/api/widget/dashboard), and customer info. Use customerEmail to see everything one customer said, or search to match title/customer text.', {
+        status: z.enum(['open', 'closed']).optional().describe('Filter by conversation status'),
+        rating: z.number().int().min(1).max(5).optional().describe('Filter by exact customer rating (1-5)'),
+        source: z.enum(['request', 'api', 'widget', 'dashboard']).optional()
+            .describe('Filter by how the conversation started (e.g. "request" = replies to a feedback request email)'),
+        customerEmail: z.string().optional().describe('Filter by the customer\'s email address'),
+        search: z.string().optional().describe('Substring match on title or customer email/name'),
+        dateFrom: z.string().optional().describe('ISO date lower bound, e.g. "2026-07-01"'),
+        dateTo: z.string().optional().describe('ISO date upper bound (inclusive day)'),
+        page: z.number().optional().describe('Page number (default: 1)'),
+        limit: z.number().optional().describe('Results per page (default: 25, max: 100)'),
+    }, async (params) => {
+        const client = getClient();
+        const result = await client.request('GET', '/feedback/conversations', {
+            params: {
+                status: params.status,
+                rating: params.rating !== undefined ? String(params.rating) : undefined,
+                source: params.source,
+                customerEmail: params.customerEmail,
+                search: params.search,
+                dateFrom: params.dateFrom,
+                dateTo: params.dateTo,
+                page: params.page !== undefined ? String(params.page) : undefined,
+                limit: params.limit !== undefined ? String(params.limit) : undefined,
+            },
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('get_feedback_conversation', 'Get a feedback conversation\'s full detail including the complete message thread (customer + staff messages, with any attachments), rating, and status (requires the feedback:read scope). Use this to read the whole exchange before replying with reply_to_feedback.', {
+        conversationId: z.string().describe('The feedback conversation ID (UUID)'),
+    }, async ({ conversationId }) => {
+        const client = getClient();
+        const result = await client.request('GET', `/feedback/conversations/${conversationId}`);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('reply_to_feedback', 'Post a staff reply to a feedback conversation (requires the feedback:write scope). The reply is recorded on the thread and the customer is emailed the message with a link back to the conversation — so only send text you intend the customer to read.', {
+        conversationId: z.string().describe('The feedback conversation ID to reply to'),
+        body: z.string().describe('Reply message body (plain text, max 10000 characters)'),
+    }, async ({ conversationId, body }) => {
+        const client = getClient();
+        const result = await client.request('POST', `/feedback/conversations/${conversationId}/messages`, { body: { body } });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('close_feedback_conversation', 'Close a feedback conversation once it has been handled (requires the feedback:write scope). Pass status "open" instead to reopen a previously closed conversation. Closing does not notify the customer.', {
+        conversationId: z.string().describe('The feedback conversation ID'),
+        status: z.enum(['open', 'closed']).optional()
+            .describe('Target status (default: "closed"; pass "open" to reopen)'),
+    }, async ({ conversationId, status }) => {
+        const client = getClient();
+        const result = await client.request('PATCH', `/feedback/conversations/${conversationId}`, { body: { status: status ?? 'closed' } });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('list_feedback_requests', 'List outgoing feedback requests ("tickles") with their funnel status, newest first (requires the feedback:read scope). Status tracks the funnel: "created" (link-only request, not yet opened), "sent" (emailed), "opened" (customer opened the respond page), "responded" (customer answered — a feedback conversation now exists). Link-channel rows include their respondUrl. Use this to see who has not responded yet before nudging again.', {
+        status: z.enum(['created', 'sent', 'opened', 'responded']).optional()
+            .describe('Filter by funnel status'),
+        customerEmail: z.string().optional().describe('Filter by the customer\'s email address'),
+        search: z.string().optional().describe('Substring match on title or customer email/name'),
+        dateFrom: z.string().optional().describe('ISO date lower bound, e.g. "2026-07-01"'),
+        dateTo: z.string().optional().describe('ISO date upper bound (inclusive day)'),
+        page: z.number().optional().describe('Page number (default: 1)'),
+        limit: z.number().optional().describe('Results per page (default: 25, max: 100)'),
+    }, async (params) => {
+        const client = getClient();
+        const result = await client.request('GET', '/feedback/requests', {
+            params: {
+                status: params.status,
+                customerEmail: params.customerEmail,
+                search: params.search,
+                dateFrom: params.dateFrom,
+                dateTo: params.dateTo,
+                page: params.page !== undefined ? String(params.page) : undefined,
+                limit: params.limit !== undefined ? String(params.limit) : undefined,
+            },
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+    server.tool('request_feedback', 'Ask a customer for feedback (requires the feedback:write scope). With the default channel "email" this creates a feedback request AND immediately emails the customer a branded message with your prompt and a respond link (with a sandbox key the email is captured, not delivered). With channel "link" NO email is sent — the response returns respondUrl, the public respond link, for you to embed in your own email/coupon/message; the funnel still tracks opened/responded either way. When the customer answers, a feedback conversation is created and the request\'s status becomes "responded".', {
+        title: z.string().describe('Short internal title for the request, e.g. "Post-onboarding check-in" (max 300 characters)'),
+        message: z.string().describe('The message/question the customer receives in the email — or sees on the respond page for channel "link" (max 10000 characters)'),
+        customerEmail: z.string().email().describe('Customer email address to send the request to'),
+        customerName: z.string().optional().describe('Customer display name (used in the email greeting)'),
+        channel: z.enum(['email', 'link']).optional()
+            .describe('"email" (default): Helmdesk sends the branded email. "link": no email — returns respondUrl to embed in your own email/coupon.'),
+        internalNote: z.string().optional()
+            .describe('Staff-only note, never shown to the customer, e.g. "Sent $50 coupon WELCOME50" (max 2000 characters)'),
+    }, async (params) => {
+        const client = getClient();
+        const result = await client.request('POST', '/feedback/requests', {
+            body: {
+                title: params.title,
+                message: params.message,
+                customerEmail: params.customerEmail,
+                customerName: params.customerName,
+                channel: params.channel,
+                internalNote: params.internalNote,
+            },
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=feedback.js.map

package/dist/tools/feedback.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helmdesk/mcp",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "MCP server for Helmdesk — let AI agents manage tickets, send emails, and search your knowledge base",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "zod": "^3.25.23",
-    "@helmdesk/sdk": "0.7.0"
+    "@helmdesk/sdk": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^20",