Connect your AI Agents to Zoho Desk in minutes
Available tools
list_accounts
List customer accounts with sorting and pagination.
get_account
Get detailed information for a specific customer account by ID.
create_account
Create a new customer account with company name and business details.
update_account
Update an existing customer account's company information.
delete_account
Permanently delete a customer account from the system.
list_agents
List support agents with roles, status, and pagination.
get_agent
Get detailed profile information for a specific agent by ID.
list_contacts
List contacts with email filtering, search, sorting, and pagination.
get_contact
Get detailed information for a specific contact by ID.
create_contact
Create a new customer contact with email and profile details.
update_contact
Update an existing contact's profile information and details.
delete_contact
Permanently delete a contact from the system.
list_teams
List support teams (Note: ZohoDesk teams API does not support pagination parameters).
get_team
Get detailed information for a specific team by ID.
list_roles
List agent roles with pagination.
list_views
List ticket views with pagination.
list_tags
List tags for ticket categorization with pagination.
list_time_entries
List time entries logged by agents with pagination.
create_time_entry
Create a new time entry for tracking work hours.
list_articles
List knowledge base articles with pagination and filtering.
get_article
Get detailed information for a specific knowledge base article.
create_article
Create a new knowledge base article with title and content.
update_article
Update an existing knowledge base article's content or metadata.
delete_article
Move a knowledge base article to trash (soft delete).
list_layouts
List layout configurations with pagination.
list_departments
List support departments with pagination.
get_department
Get detailed information for a specific department by ID.
list_products
List products for ticket categorization with pagination.
get_product
Get detailed information for a specific product by ID.
create_product
Create a new product with name and optional details.
list_tasks
List tasks with status filtering and pagination.
get_task
Get detailed information for a specific task by ID.
create_task
Create a new task with subject and status.
update_task
Update an existing task's status, priority, or other fields.
search
Perform global search across tickets, contacts, and accounts.
get_organization
Get organization configuration details and settings.
list_ticket_threads
List comments and conversation threads for a specific ticket.
create_ticket_comment
Add a new comment or reply to a ticket with visibility control.
upload_ticket_attachment
Upload a file attachment to a specific ticket.
download_ticket_attachment
Download a file attachment from a ticket by attachment ID.
list_tickets
List tickets with filtering, sorting, and pagination support.
get_ticket
Get detailed information for a specific ticket by ID.
create_ticket
Create a new support ticket with subject, contact, and optional details.
update_ticket
Update an existing ticket's status, priority, assignment, or other fields.
close_ticket
Close a ticket by marking the status
validate_credential
Validate Zoho Desk credentials. Verifies credentials during setup.
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}
11Open 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}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 }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}FAQs on using Merge's Zoho Desk MCP server
FAQs on using Merge's Zoho Desk MCP server
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
