@fruggr/zendesk-mcp-server 2.7.0 → 2.8.0

package/dist/index.js

@@ -775,6 +775,9 @@ const helpCenterPut = (subdomain, token, path, body) => {
 		body
 	});
 };
+const helpCenterDelete = (subdomain, token, path) => {
+	return executeRequest(buildUrl(getHelpCenterBaseUrl(subdomain), path), token, { method: "DELETE" });
+};
 const fetchZendeskBinary = async (subdomain, token, contentUrl) => {
 	const expectedHost = `${subdomain}.zendesk.com`;
 	const headers = {};
@@ -1566,6 +1569,32 @@ const createHelpCenterTools = (ctx) => {
 				}] };
 			}
 		},
+		{
+			name: "archive_article",
+			namespace: "help_center",
+			readOnly: false,
+			title: "Archive Help Center Article",
+			description: "Archive (soft-delete) a Help Center article: it is removed from the Help Center but can be restored from the Guide admin UI. Returns a confirmation message; the article and all its translations become invisible to end users. This is the only removal the Zendesk API offers — permanent deletion is not available via the API (do it from the Guide admin UI). To only hide an article temporarily while keeping it in the knowledge base, use update_article with draft: true (unpublish) instead. Guarded by a required confirm flag.",
+			inputSchema: z.object({
+				article_id: z.number().int().describe(ARTICLE_ID_DESC),
+				confirm: z.boolean().describe("Explicit safety guard: must be set to true to archive the article. Any other value refuses the operation without calling Zendesk.")
+			}),
+			annotations: {
+				readOnlyHint: false,
+				destructiveHint: true,
+				idempotentHint: true,
+				openWorldHint: true
+			},
+			handler: async (params) => {
+				const { article_id, confirm } = params;
+				if (confirm !== true) throw new Error("Archiving is guarded: pass confirm: true to archive (soft-delete) this article. No changes were made.");
+				await helpCenterDelete(subdomain, await getToken(), `/articles/${article_id}`);
+				return { content: [{
+					type: "text",
+					text: `Article #${article_id} archived (soft-deleted). It is removed from the Help Center; restore it from the Guide admin UI if needed.`
+				}] };
+			}
+		},
 		{
 			name: "list_content_tags",
 			namespace: "help_center",