Merge Unified's Zendesk integration Merge Agent Handler's Zendesk MCP server

Connect your AI Agents to Zendesk in minutes

Merge lets you securely connect your agents to Zendesk and thousands of tools instantly

Start building for free

Read docs

Zendesk

Learn more about Merge Agent Handler

Available tools

list_articles

List Help Center articles with pagination. Optionally filter by section ID or label names. To fetch the next page, pass pageinfo.cursor as the page parameter. Check pageinfo.hasnextpage to see if more results exist.

get_article

Get a specific Help Center article by ID. Use list_articles to find valid article IDs.

create_article

Create a new Help Center article within a section. Articles contain the actual help content with title and body.

update_article

Update an existing Help Center article. Use get_article to retrieve the current values first.

delete_article

Delete a Help Center article. This permanently removes the article from the knowledge base.

list_categories

List Help Center categories with pagination. To fetch the next page, pass pageinfo.cursor as the page parameter. Check pageinfo.hasnextpage to see if more results exist.

get_category

Get a specific Help Center category by ID. Use list_categories to find valid category IDs.

create_category

Create a new Help Center category. Categories organize sections and articles.

update_category

Update an existing Help Center category. Use get_category to retrieve the current values first.

delete_category

Delete a Help Center category. WARNING: This will also delete all sections and articles within the category.

get_organization

Get a specific organization by ID

list_organizations

List organizations with optional filtering

create_organization

Create a new organization

update_organization

Update an existing organization

delete_organization

Delete an organization

search_organizations

Search organizations using query

get_organization_users

Get users in an organization

get_organization_tickets

Get tickets for an organization

list_organization_memberships

List organization memberships

create_organization_membership

Create an organization membership

delete_organization_membership

Delete an organization membership

bulk_create_organizations

Create multiple organizations at once

bulk_update_organizations

Update multiple organizations at once

merge_organizations

Merge two organizations

list_sections

List Help Center sections with pagination. Optionally filter by category ID. To fetch the next page, pass pageinfo.cursor as the page parameter. Check pageinfo.hasnextpage to see if more results exist.

get_section

Get a specific Help Center section by ID. Use list_sections to find valid section IDs.

create_section

Create a new Help Center section within a category. Sections organize articles within categories.

update_section

Update an existing Help Center section. Use get_section to retrieve the current values first.

delete_section

Delete a Help Center section. WARNING: This will also delete all articles within the section.

get_ticket

Get a specific ticket by ID

list_tickets

List tickets with optional filtering

create_ticket

Create a new ticket

update_ticket

Update an existing ticket

delete_ticket

Delete a ticket

search_tickets

Search tickets using query

get_ticket_comments

Get comments for a ticket

add_ticket_comment

Add a comment to a ticket

add_internal_note

Add an INTERNAL (staff-only) note to a ticket — always private, no public option in this tool. Use when a comment must stay internal. Note: this is a property of THIS tool only; addticketcomment, updateticket, createticket, and bulkupdatetickets can each still post public replies, so for an internal-only setup grant only this tool and withhold those four.

get_ticket_audits

Get audit history for a ticket

bulk_update_tickets

Update multiple tickets at once

get_user

Get a specific user by ID

list_users

List users with optional filtering

create_user

Create a new user

update_user

Update an existing user

search_users

Search users using query

suspend_user

Suspend a user

unsuspend_user

Unsuspend a user

delete_user

Delete a user

get_user_identities

Get identities for a user

create_user_identity

Create a new identity for a user

update_user_identity

Update a user identity

delete_user_identity

Delete a user identity

make_user_identity_primary

Make a user identity primary

bulk_create_users

Create multiple users at once

bulk_update_users

Update multiple users at once

get_job_status

Get the status of a bulk operation job

validate_credential

Validate Zendesk credentials. Verifies credentials during setup.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Zendesk MCP server

What is a Zendesk MCP server?

It’s an MCP server that exposes data and functionality from Zendesk via tools. Your agents can use these tools to do everything from updating a support ticket to removing a user in your Zendesk instance.

How can I use the Zendesk MCP server?

Here are just a few ways to use it:

Automated ticket triage and routing: Your agent can classify incoming tickets by intent, priority, or customer tier and route them to the right team. For example, enterprise billing issues can be auto-escalated to a high-priority queue

AI-assisted ticket responses: Your agent can draft replies using ticket history, macros, and help center content. For example, common integration issues can trigger pre-filled troubleshooting responses for quick resolution

Customer context enrichment: Your agent can enrich tickets with CRM, billing, or product usage data. For example, account plan, ARR, and recent activity can be surfaced directly on each ticket

Proactive issue detection: Your agent can detect spikes or patterns across tickets to identify emerging issues. For example, repeated API error reports can trigger alerts and incident creation

Cross-tool workflow automation: Your agent can trigger actions in other systems from Zendesk events. For example, confirming a bug can automatically create a Jira issue, notify Slack, and update the customer

What are popular tools for Zendesk’s MCP server?

Here are some popular tools across data types:

Organizations

<code class="blog_inline-code">get_organization</code>
<code class="blog_inline-code">list_organization</code>
<code class="blog_inline-code">create_organization</code>
<code class="blog_inline-code">get_organization_tickets</code>

Tickets

<code class="blog_inline-code">list_tickets</code>
<code class="blog_inline-code">get_ticket</code>
<code class="blog_inline-code">update_ticket</code>
<code class="blog_inline-code">get_tickets_comments</code>

Users

<code class="blog_inline-code">list_users</code>
<code class="blog_inline-code">suspend_user</code>
<code class="blog_inline-code">search_users</code>
<code class="blog_inline-code">delete_user</code>

What makes Merge Agent Handler’s Zendesk MCP server better than alternative Zendesk MCP servers?

Merge Agent Handler’s Zendesk MCP server comes with platform-level capabilities:

Enterprise-grade security and DLP: All Zendesk tool inputs and outputs pass through Merge’s Security Gateway, which can block, redact, or mask sensitive data using default or custom rules. This applies consistently across all connectors, including Zendesk

Centralized authentication and credential management: Merge handles individual or shared authentication for Zendesk connectors, removing the need to manage OAuth flows or credentials inside agent code

Real-time observability with a complete audit trail: Every Zendesk tool call is logged, including underlying API requests. Logs are fully searchable, enabling auditing, debugging, and behavioral analysis across agents and users

Evaluation Suite for quality assurance: Test and validate Zendesk tool calls across different prompts before deploying to production. This ensures high-quality, consistent tool performance and helps optimize outputs for reliability

Can I set custom security rules for Zendesk tool calls in Merge Agent Handler?

Yes, Merge Agent Handler supports custom security rules through its Security Gateway and Data Loss Protection (DLP) system. These rules can inspect both tool inputs and outputs and automatically block, redact, or mask sensitive data before it is returned to the agent.

Here are just a few examples:

Customer email addresses and phone numbers: Block or redact any tool calls that attempt to include customer contact information in ticket comments, internal notes, or agent responses

Credit card numbers: Automatically block any attempts to include credit card information in Zendesk tickets, comments, or custom fields before they're written to your support platform

Social security numbers: Block any tool calls that attempt to include SSNs in ticket descriptions, comments, or custom field values

Internal account IDs: Mask sensitive customer identifiers when agents read or update Zendesk tickets to prevent cross-account information leakage

API keys and tokens: Block any tool calls that attempt to include API keys, authentication tokens, or credentials in ticket content or metadata

External webhook destinations: Block tool calls that attempt to configure Zendesk triggers or webhooks with destinations outside your organization's approved domains

How can I start using Merge Agent Handler’s Zendesk MCP server?

You can follow these steps:

1. Create your Agent Handler account. Sign up for a free account.

2. Create a Tool Pack. Navigate to "Tool Packs" in the left sidebar and click "Create New Tool Pack." Give it a descriptive name (e.g., "Zendesk Support Pack").

3. Add the Zendesk connector. In your Tool Pack settings, click "Add Connector" and select Zendesk from the connector marketplace.

4. Authenticate with Zendesk. Click the authentication button to connect your Zendesk account via OAuth. You can configure this as individual authentication (each user connects their own Zendesk account) or shared authentication (one admin connection for all users).

5. Select specific tools. Choose which Zendesk tools you want to make available to your agent, or enable all tools by default.

6. Register a User. Navigate to "Registered Users" in the sidebar and create a new registered user. This represents the identity that will perform actions through your agent.

7. Save your Tool Pack. Review and save all your Tool Pack settings.

8. Connect to your agent or IDE. Copy the MCP entry URL from your Tool Pack settings.

Can employees use Merge Agent Handler to connect their AI tools to Zendesk?

Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to Zendesk without bypassing IT governance.

Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity.

IT also provisions access by role or group via SCIM. A support agent, for example, gets Zendesk access to resolve tickets, Jira to track related bugs, and Slack to coordinate with engineering; while an account manager gets Zendesk access to review customer history, Salesforce to track account health, and Gmail to manage follow-up communications.

Every tool call an employee's AI makes to Zendesk is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.