@fruggr/zendesk-mcp-server 2.3.1 → 2.5.0

package/README.md

@@ -1,16 +1,19 @@
 # Zendesk MCP Server
 
 [![Glama score](https://glama.ai/mcp/servers/fruggr/zendesk-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/fruggr/zendesk-mcp-server)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.fruggr%2Fzendesk--mcp--server-0a7ea4)](https://registry.modelcontextprotocol.io/?search=io.github.fruggr/zendesk-mcp-server)
 [![npm version](https://img.shields.io/npm/v/@fruggr/zendesk-mcp-server?logo=npm&color=cb3837)](https://www.npmjs.com/package/@fruggr/zendesk-mcp-server)
 [![License: MIT](https://img.shields.io/npm/l/@fruggr/zendesk-mcp-server?color=blue)](LICENSE)
 [![Node.js](https://img.shields.io/node/v/@fruggr/zendesk-mcp-server?logo=nodedotjs&logoColor=white&color=339933)](https://nodejs.org)
 [![Renovate enabled](https://img.shields.io/badge/renovate-enabled-brightgreen?logo=renovatebot&logoColor=white)](https://renovatebot.com)
 [![semantic-release](https://img.shields.io/badge/semantic--release-e10079?logo=semantic-release&logoColor=white)](https://github.com/semantic-release/semantic-release)
 
-**Bring Zendesk Support & the Help Center into your AI assistant.** A
-[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that lets
-your assistant search articles, answer questions, and create, track and update
-tickets in plain language — **without switching apps**.
+**Bring Zendesk deep into your AI assistant.** A
+[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for a
+two-way integration: find answers in the Help Center, **draft, update and
+translate** articles (keeping languages in sync), and **manage Support tickets**
+end to end — comments, triage and image attachments — all in plain language,
+**without switching apps**.
 
 Think of it as the [Zendesk agent for Microsoft 365 Copilot](https://support.zendesk.com/hc/en-us/articles/9958331458458-Using-the-Zendesk-agent-in-Microsoft-365-Copilot),
 but **vendor-neutral** — it drops into any MCP client (Claude Desktop, Claude
@@ -130,8 +133,8 @@ zendesk-mcp-server acme --namespace tickets
 | `list_sla_policies` | List SLA policies with filter conditions and per-priority targets (requires an admin token, or a custom role with the SLA-management permission) | read |
 | `create_ticket` | Create a new ticket with subject, description, priority, tags... | write |
 | `update_ticket` | Update ticket status, priority, assignee, tags, custom fields | write |
-| `add_private_note` | Add an internal note (not visible to requester) | write |
-| `add_public_comment` | Add a public comment (visible to requester) | write |
+| `add_private_note` | Add an internal note (not visible to requester), optionally with file attachments | write |
+| `add_public_comment` | Add a public comment (visible to requester), optionally with file attachments | write |
 | `manage_tags` | Add or remove tags on a ticket | write |
 
 </details>
@@ -622,7 +625,7 @@ This project was built with reference to:
 
 ## Releases & versioning
 
-Versions follow [SemVer](https://semver.org/) and are calculated **automatically** from commit messages — no one bumps the version by hand. Every merge to `main` triggers [semantic-release](https://github.com/semantic-release/semantic-release), which inspects the new [Conventional Commits](https://www.conventionalcommits.org/) since the previous tag, computes the next version, updates [`CHANGELOG.md`](CHANGELOG.md), publishes to npm, and creates the matching GitHub Release.
+Versions follow [SemVer](https://semver.org/) and are calculated **automatically** from commit messages — no one bumps the version by hand. Every merge to `main` triggers [semantic-release](https://github.com/semantic-release/semantic-release), which inspects the new [Conventional Commits](https://www.conventionalcommits.org/) since the previous tag, computes the next version, updates [`CHANGELOG.md`](CHANGELOG.md), publishes to npm, creates the matching GitHub Release, and mirrors the release into the [official MCP registry](https://registry.modelcontextprotocol.io) as [`io.github.fruggr/zendesk-mcp-server`](https://registry.modelcontextprotocol.io/?search=io.github.fruggr/zendesk-mcp-server) so registry-driven clients discover the new version automatically.
 
 | Commit type | Resulting bump |
 |---|---|

package/dist/index.js

@@ -783,6 +783,24 @@ const fetchZendeskBinary = async (subdomain, token, contentUrl) => {
 		contentType
 	};
 };
+const zendeskUpload = async (subdomain, token, filename, data, contentType, uploadToken) => {
+	const params = { filename };
+	if (uploadToken) params["token"] = uploadToken;
+	const url = buildUrl(getBaseUrl(subdomain), "/uploads", params);
+	const response = await fetch(url, {
+		method: "POST",
+		headers: {
+			Authorization: buildAuthHeader(token),
+			"Content-Type": contentType
+		},
+		body: data
+	});
+	if (!response.ok) {
+		const responseBody = await response.text();
+		throw new ZendeskApiError(response.status, response.statusText, responseBody);
+	}
+	return response.json();
+};
 const helpCenterUpload = async (subdomain, token, path, formData) => {
 	const url = buildUrl(getHelpCenterBaseUrl(subdomain), path);
 	const response = await fetch(url, {
@@ -1905,7 +1923,10 @@ const fetchAllTicketComments = async (subdomain, token, ticketId) => {
 	let cursor;
 	let pages = 0;
 	while (pages < MAX_COMMENT_PAGES) {
-		const response = await zendeskGet(subdomain, token, `/tickets/${ticketId}/comments`, buildCursorParams(100, cursor));
+		const response = await zendeskGet(subdomain, token, `/tickets/${ticketId}/comments`, {
+			...buildCursorParams(100, cursor),
+			include_inline_images: "true"
+		});
 		all.push(...response.comments);
 		pages += 1;
 		if (!response.meta?.has_more || !response.meta?.after_cursor) break;
@@ -1969,6 +1990,20 @@ const fetchTicketSla = async (subdomain, token, ticket) => {
 };
 const createTicketTools = (ctx) => {
 	const { subdomain, getToken } = ctx;
+	const attachmentSchema = z.object({
+		file_name: z.string().min(1).describe("File name, e.g. \"app.log\" or \"screenshot.png\"."),
+		file_base64: z.string().min(1).base64().describe("File content encoded as base64."),
+		content_type: z.string().min(1).default("application/octet-stream").describe("MIME type, e.g. \"text/plain\", \"image/png\", \"application/pdf\".")
+	});
+	const uploadAttachments = async (token, files) => {
+		let uploadToken;
+		for (const file of files) {
+			const { upload } = await zendeskUpload(subdomain, token, file.file_name, Buffer.from(file.file_base64, "base64"), file.content_type, uploadToken);
+			uploadToken = upload.token;
+		}
+		return uploadToken;
+	};
+	const formatAttachmentSuffix = (count) => count ? ` with ${count} attachment(s)` : "";
 	return [
 		{
 			name: "get_ticket",
@@ -1992,7 +2027,7 @@ const createTicketTools = (ctx) => {
 				const { ticket } = await zendeskGet(subdomain, token, `/tickets/${ticket_id}`);
 				let text = formatTicket(ticket) + formatSlaBlock(await fetchTicketSla(subdomain, token, ticket));
 				if (include_comments) {
-					const { comments } = await zendeskGet(subdomain, token, `/tickets/${ticket_id}/comments`);
+					const { comments } = await zendeskGet(subdomain, token, `/tickets/${ticket_id}/comments`, { include_inline_images: "true" });
 					text += `\n\n---\n# Comments\n\n${comments.map(formatComment).join("\n\n")}`;
 				}
 				return { content: [{
@@ -2177,10 +2212,11 @@ const createTicketTools = (ctx) => {
 			namespace: "tickets",
 			readOnly: false,
 			title: "Add Private Note",
-			description: "Add an internal note (not visible to requester) to a ticket.",
+			description: "Add an internal note (not visible to requester) to a ticket, optionally with file attachments (uploaded via the Zendesk Uploads API and carried on the note).",
 			inputSchema: z.object({
 				ticket_id: z.number().int().describe("Ticket ID"),
-				body: z.string().min(1).describe("Note content")
+				body: z.string().min(1).describe("Note content"),
+				attachments: z.array(attachmentSchema).optional().describe("Files to attach to this note (base64-encoded content).")
 			}),
 			annotations: {
 				readOnlyHint: false,
@@ -2189,14 +2225,17 @@ const createTicketTools = (ctx) => {
 				openWorldHint: true
 			},
 			handler: async (params) => {
-				const { ticket_id, body } = params;
-				await zendeskPut(subdomain, await getToken(), `/tickets/${ticket_id}`, { ticket: { comment: {
+				const { ticket_id, body, attachments } = params;
+				const token = await getToken();
+				const uploads = attachments?.length ? [await uploadAttachments(token, attachments)] : void 0;
+				await zendeskPut(subdomain, token, `/tickets/${ticket_id}`, { ticket: { comment: {
 					body,
-					public: false
+					public: false,
+					...uploads && { uploads }
 				} } });
 				return { content: [{
 					type: "text",
-					text: `Private note added to ticket #${ticket_id}.`
+					text: `Private note added to ticket #${ticket_id}${formatAttachmentSuffix(attachments?.length)}.`
 				}] };
 			}
 		},
@@ -2205,10 +2244,11 @@ const createTicketTools = (ctx) => {
 			namespace: "tickets",
 			readOnly: false,
 			title: "Add Public Comment",
-			description: "Add a public comment (visible to requester) to a ticket.",
+			description: "Add a public comment (visible to requester) to a ticket, optionally with file attachments (uploaded via the Zendesk Uploads API and carried on the comment).",
 			inputSchema: z.object({
 				ticket_id: z.number().int().describe("Ticket ID"),
-				body: z.string().min(1).describe("Comment content")
+				body: z.string().min(1).describe("Comment content"),
+				attachments: z.array(attachmentSchema).optional().describe("Files to attach to this comment (base64-encoded content).")
 			}),
 			annotations: {
 				readOnlyHint: false,
@@ -2217,14 +2257,17 @@ const createTicketTools = (ctx) => {
 				openWorldHint: true
 			},
 			handler: async (params) => {
-				const { ticket_id, body } = params;
-				await zendeskPut(subdomain, await getToken(), `/tickets/${ticket_id}`, { ticket: { comment: {
+				const { ticket_id, body, attachments } = params;
+				const token = await getToken();
+				const uploads = attachments?.length ? [await uploadAttachments(token, attachments)] : void 0;
+				await zendeskPut(subdomain, token, `/tickets/${ticket_id}`, { ticket: { comment: {
 					body,
-					public: true
+					public: true,
+					...uploads && { uploads }
 				} } });
 				return { content: [{
 					type: "text",
-					text: `Public comment added to ticket #${ticket_id}.`
+					text: `Public comment added to ticket #${ticket_id}${formatAttachmentSuffix(attachments?.length)}.`
 				}] };
 			}
 		},