@wellforce/zendesk-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wellforce IT
+
+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,130 @@
+# @wellforce/zendesk-mcp
+
+A Zendesk MCP server for Claude Desktop. Gives Claude access to 41 Zendesk tools — manage tickets, users, organizations, and more through natural language.
+
+## Installation
+
+Add to your Claude Desktop config file:
+
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "zendesk": {
+      "command": "npx",
+      "args": ["-y", "@wellforce/zendesk-mcp"],
+      "env": {
+        "ZENDESK_SUBDOMAIN": "yourcompany",
+        "ZENDESK_EMAIL": "you@yourcompany.com",
+        "ZENDESK_TOKEN": "your_api_token"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You should see a hammer icon with 41 tools available.
+
+## Getting Your API Token
+
+1. Log into Zendesk as an admin
+2. Go to **Admin Center > Apps and Integrations > Zendesk API**
+3. Click **Add API token**
+4. Copy the token — you won't be able to see it again
+
+## Environment Variables
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `ZENDESK_SUBDOMAIN` | Your Zendesk subdomain | `acme` (from `acme.zendesk.com`) |
+| `ZENDESK_EMAIL` | Your Zendesk agent email | `you@acme.com` |
+| `ZENDESK_TOKEN` | Your Zendesk API token | See above |
+
+## Available Tools (41)
+
+### Tickets
+- `zendesk_list_tickets` — List tickets with status/assignee/requester filters
+- `zendesk_get_ticket` — Get a single ticket by ID
+- `zendesk_create_ticket` — Create a new ticket
+- `zendesk_update_ticket` — Update ticket properties
+- `zendesk_delete_ticket` — Delete a ticket (soft delete)
+
+### Comments
+- `zendesk_list_comments` — List all comments on a ticket
+- `zendesk_add_comment` — Add a public reply or internal note
+
+### Users
+- `zendesk_list_users` — List users with optional role filter
+- `zendesk_get_user` — Get a user by ID
+- `zendesk_create_user` — Create a new user
+- `zendesk_update_user` — Update user properties
+- `zendesk_delete_user` — Delete a user (soft delete)
+
+### Organizations
+- `zendesk_list_organizations` — List all organizations
+- `zendesk_get_organization` — Get an organization by ID
+- `zendesk_create_organization` — Create a new organization
+- `zendesk_update_organization` — Update organization properties
+- `zendesk_delete_organization` — Delete an organization
+
+### Groups
+- `zendesk_list_groups` — List all groups
+- `zendesk_get_group` — Get a group by ID
+- `zendesk_create_group` — Create a new group
+- `zendesk_update_group` — Update group properties
+- `zendesk_delete_group` — Delete a group
+
+### Views
+- `zendesk_list_views` — List all views
+- `zendesk_get_view` — Get a view by ID
+- `zendesk_list_view_tickets` — List tickets in a view
+- `zendesk_count_view_tickets` — Count tickets in a view
+
+### Macros
+- `zendesk_list_macros` — List all macros
+- `zendesk_get_macro` — Get a macro by ID
+- `zendesk_apply_macro` — Apply a macro to a ticket
+
+### Triggers
+- `zendesk_list_triggers` — List all triggers
+- `zendesk_get_trigger` — Get a trigger by ID
+- `zendesk_create_trigger` — Create a new trigger
+- `zendesk_update_trigger` — Update trigger properties
+- `zendesk_delete_trigger` — Delete a trigger
+
+### Automations
+- `zendesk_list_automations` — List all automations
+- `zendesk_get_automation` — Get an automation by ID
+- `zendesk_create_automation` — Create a new automation
+- `zendesk_update_automation` — Update automation properties
+- `zendesk_delete_automation` — Delete an automation
+
+### Search
+- `zendesk_search` — Search across tickets, users, and organizations
+
+### Auth
+- `zendesk_whoami` — Check current authenticated identity
+
+## Development
+
+```bash
+git clone https://github.com/wellforce/zendesk-mcp.git
+cd zendesk-mcp
+npm install
+npm run build
+npm test
+```
+
+```bash
+# Watch mode
+npm run dev
+
+# Test with MCP Inspector
+npm run inspect
+```
+
+## License
+
+MIT

package/dist/src/client/types.d.ts

@@ -0,0 +1,160 @@
+export interface ZendeskTicket {
+    id: number;
+    subject: string;
+    description: string;
+    status: "new" | "open" | "pending" | "hold" | "solved" | "closed";
+    priority: "urgent" | "high" | "normal" | "low" | null;
+    type: "problem" | "incident" | "question" | "task" | null;
+    requester_id: number;
+    assignee_id: number | null;
+    group_id: number | null;
+    organization_id: number | null;
+    tags: string[];
+    custom_fields: Array<{
+        id: number;
+        value: unknown;
+    }>;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskComment {
+    id: number;
+    body: string;
+    html_body: string;
+    public: boolean;
+    author_id: number;
+    created_at: string;
+}
+export interface ZendeskUser {
+    id: number;
+    name: string;
+    email: string;
+    role: "end-user" | "agent" | "admin";
+    organization_id: number | null;
+    phone: string | null;
+    tags: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskOrganization {
+    id: number;
+    name: string;
+    domain_names: string[];
+    tags: string[];
+    notes: string;
+    details: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskGroup {
+    id: number;
+    name: string;
+    description: string;
+    default: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskView {
+    id: number;
+    title: string;
+    active: boolean;
+    description: string;
+    position: number;
+    restriction: {
+        type: string;
+        id?: number;
+    } | null;
+    conditions: unknown;
+    output: unknown;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskViewCount {
+    view_id: number;
+    url: string;
+    value: number;
+    pretty: string;
+    fresh: boolean;
+}
+export interface ZendeskMacro {
+    id: number;
+    title: string;
+    active: boolean;
+    description: string | null;
+    actions: Array<{
+        field: string;
+        value: unknown;
+    }>;
+    restriction: {
+        type: string;
+        id?: number;
+    } | null;
+    position: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskTrigger {
+    id: number;
+    title: string;
+    active: boolean;
+    description: string | null;
+    conditions: {
+        all: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+        }>;
+        any: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+        }>;
+    };
+    actions: Array<{
+        field: string;
+        value: unknown;
+    }>;
+    position: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface ZendeskAutomation {
+    id: number;
+    title: string;
+    active: boolean;
+    description: string | null;
+    conditions: {
+        all: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+        }>;
+        any: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+        }>;
+    };
+    actions: Array<{
+        field: string;
+        value: unknown;
+    }>;
+    position: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface PaginatedResponse<T> {
+    results?: T[];
+    tickets?: T[];
+    users?: T[];
+    organizations?: T[];
+    comments?: T[];
+    groups?: T[];
+    views?: T[];
+    macros?: T[];
+    triggers?: T[];
+    automations?: T[];
+    count: number;
+    next_page: string | null;
+    previous_page: string | null;
+}

package/dist/src/client/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/client/types.js.map

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

package/dist/src/client/zendesk-client.d.ts

@@ -0,0 +1,13 @@
+import { ZendeskConfig } from "../config.js";
+export declare class ZendeskClient {
+    private http;
+    private currentEmail;
+    constructor(config: ZendeskConfig);
+    reconfigure(config: ZendeskConfig): void;
+    getAuthenticatedEmail(): string;
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    post<T>(path: string, data: unknown): Promise<T>;
+    put<T>(path: string, data: unknown): Promise<T>;
+    delete(path: string): Promise<void>;
+    private wrapError;
+}

package/dist/src/client/zendesk-client.js

@@ -0,0 +1,79 @@
+import axios, { AxiosError } from "axios";
+import { ZendeskApiError } from "../utils/errors.js";
+export class ZendeskClient {
+    http;
+    currentEmail;
+    constructor(config) {
+        this.currentEmail = config.email;
+        this.http = axios.create({
+            baseURL: config.baseUrl,
+            auth: {
+                username: `${config.email}/token`,
+                password: config.token,
+            },
+            headers: { "Content-Type": "application/json" },
+            timeout: 30000,
+        });
+    }
+    reconfigure(config) {
+        this.currentEmail = config.email;
+        this.http = axios.create({
+            baseURL: config.baseUrl,
+            auth: {
+                username: `${config.email}/token`,
+                password: config.token,
+            },
+            headers: { "Content-Type": "application/json" },
+            timeout: 30000,
+        });
+    }
+    getAuthenticatedEmail() {
+        return this.currentEmail;
+    }
+    async get(path, params) {
+        try {
+            const response = await this.http.get(path, { params });
+            return response.data;
+        }
+        catch (error) {
+            throw this.wrapError(error, `GET ${path}`);
+        }
+    }
+    async post(path, data) {
+        try {
+            const response = await this.http.post(path, data);
+            return response.data;
+        }
+        catch (error) {
+            throw this.wrapError(error, `POST ${path}`);
+        }
+    }
+    async put(path, data) {
+        try {
+            const response = await this.http.put(path, data);
+            return response.data;
+        }
+        catch (error) {
+            throw this.wrapError(error, `PUT ${path}`);
+        }
+    }
+    async delete(path) {
+        try {
+            await this.http.delete(path);
+        }
+        catch (error) {
+            throw this.wrapError(error, `DELETE ${path}`);
+        }
+    }
+    wrapError(error, endpoint) {
+        if (error instanceof AxiosError) {
+            const status = error.response?.status ?? 0;
+            const data = error.response?.data;
+            const message = data?.error ?? data?.description ?? error.message ?? "Request failed";
+            return new ZendeskApiError(message, status, endpoint, data);
+        }
+        const message = error instanceof Error ? error.message : "Unknown error";
+        return new ZendeskApiError(message, 0, endpoint);
+    }
+}
+//# sourceMappingURL=zendesk-client.js.map

package/dist/src/client/zendesk-client.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,8 @@
+export interface ZendeskConfig {
+    subdomain: string;
+    email: string;
+    token: string;
+    baseUrl: string;
+}
+export declare function loadConfig(): ZendeskConfig;
+export declare function loadSubdomain(): string;

package/dist/src/config.js

@@ -0,0 +1,27 @@
+export function loadConfig() {
+    const subdomain = process.env.ZENDESK_SUBDOMAIN;
+    const email = process.env.ZENDESK_EMAIL;
+    const token = process.env.ZENDESK_TOKEN;
+    if (!subdomain || !email || !token) {
+        const missing = [
+            !subdomain && "ZENDESK_SUBDOMAIN",
+            !email && "ZENDESK_EMAIL",
+            !token && "ZENDESK_TOKEN",
+        ].filter(Boolean);
+        throw new Error(`Missing required environment variables: ${missing.join(", ")}`);
+    }
+    return {
+        subdomain,
+        email,
+        token,
+        baseUrl: `https://${subdomain}.zendesk.com/api/v2`,
+    };
+}
+export function loadSubdomain() {
+    const subdomain = process.env.ZENDESK_SUBDOMAIN;
+    if (!subdomain) {
+        throw new Error("Missing required environment variable: ZENDESK_SUBDOMAIN");
+    }
+    return subdomain;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAExC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG;YACd,CAAC,SAAS,IAAI,mBAAmB;YACjC,CAAC,KAAK,IAAI,eAAe;YACzB,CAAC,KAAK,IAAI,eAAe;SAC1B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS;QACT,KAAK;QACL,KAAK;QACL,OAAO,EAAE,WAAW,SAAS,qBAAqB;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ZendeskClient } from "./client/zendesk-client.js";
+import { registerAllTools } from "./tools/index.js";
+async function main() {
+    const subdomain = process.env.ZENDESK_SUBDOMAIN;
+    const email = process.env.ZENDESK_EMAIL;
+    const token = process.env.ZENDESK_TOKEN;
+    const missing = [
+        !subdomain && "ZENDESK_SUBDOMAIN",
+        !email && "ZENDESK_EMAIL",
+        !token && "ZENDESK_TOKEN",
+    ].filter(Boolean);
+    if (!subdomain || !email || !token) {
+        console.error(`Missing required environment variables: ${missing.join(", ")}\n` +
+            "Set these in the \"env\" block of your claude_desktop_config.json.");
+        process.exit(1);
+    }
+    const config = {
+        subdomain,
+        email,
+        token,
+        baseUrl: `https://${subdomain}.zendesk.com/api/v2`,
+    };
+    const client = new ZendeskClient(config);
+    const server = new McpServer({
+        name: "@wellforce/zendesk-mcp",
+        version: "1.0.0",
+    });
+    registerAllTools(server, client, subdomain);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAExC,MAAM,OAAO,GAAG;QACd,CAAC,SAAS,IAAI,mBAAmB;QACjC,CAAC,KAAK,IAAI,eAAe;QACzB,CAAC,KAAK,IAAI,eAAe;KAC1B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CACX,2CAA2C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAC/D,oEAAoE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG;QACb,SAAS;QACT,KAAK;QACL,KAAK;QACL,OAAO,EAAE,WAAW,SAAS,qBAAqB;KACnD,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/tools/auth.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZendeskClient } from "../client/zendesk-client.js";
+export declare function registerAuthTools(server: McpServer, client: ZendeskClient, subdomain: string): void;

package/dist/src/tools/auth.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { formatErrorResponse } from "../utils/errors.js";
+export function registerAuthTools(server, client, subdomain) {
+    server.tool("zendesk_authenticate", "Authenticate as a specific Zendesk agent. Call this at the start of a session to set who actions are performed as. Verifies credentials by fetching the authenticated user profile.", {
+        email: z.string().email().describe("Your Zendesk agent email address"),
+        token: z.string().describe("Your personal Zendesk API token"),
+    }, async ({ email, token }) => {
+        try {
+            const config = {
+                subdomain,
+                email,
+                token,
+                baseUrl: `https://${subdomain}.zendesk.com/api/v2`,
+            };
+            client.reconfigure(config);
+            // Verify credentials by fetching the authenticated user
+            const result = await client.get("/users/me.json");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Authenticated successfully as ${result.user.name} (${result.user.email}, role: ${result.user.role}). All subsequent actions will be performed as this user.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorResponse(error);
+        }
+    });
+    server.tool("zendesk_whoami", "Check which Zendesk user is currently authenticated", {}, async () => {
+        try {
+            const result = await client.get("/users/me.json");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Currently authenticated as ${result.user.name} (${result.user.email}, role: ${result.user.role}).`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/tools/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/tools/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,MAAqB,EACrB,SAAiB;IAEjB,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,qLAAqL,EACrL;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACtE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAC9D,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,SAAS;gBACT,KAAK;gBACL,KAAK;gBACL,OAAO,EAAE,WAAW,SAAS,qBAAqB;aACnD,CAAC;YAEF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAE3B,wDAAwD;YACxD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,gBAAgB,CACjB,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iCAAiC,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,2DAA2D;qBACpK;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,qDAAqD,EACrD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC7B,gBAAgB,CACjB,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,WAAW,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI;qBAC1G;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/tools/automations.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZendeskClient } from "../client/zendesk-client.js";
+export declare function registerAutomationTools(server: McpServer, client: ZendeskClient): void;