Zendesk MCP Server

{ "description": "MCP (Model Context Protocol) server for Zendesk Ticket Analytics", "aboutText": "# Zendesk MCP Server\n\nModel Context Protocol (MCP) server for Zendesk Ticket Analytics.\n\nThis MCP server enables AI Agents to analyze Zendesk ticket data and provide customer support insights.\n\n## Features\n\n- **Unified ticket search**: Search by keywords, tags, or company filter\n- **Company grouping**: Automatically group results by company\n- **Ticket links**: Each ticket includes a direct Zendesk URL\n- **Ticket details**: Get detailed information about specific tickets\n- **Agent performance**: Find top-performing agents by ticket resolution\n- **Service trends**: Analyze inquiry frequency by service\n\n## Prerequisites\n\n### Environment Variables\n\n- `ZENDESK_SUBDOMAIN` (Required): Your Zendesk subdomain\n- `ZENDESK_EMAIL` (Required): Zendesk API user email\n- `ZENDESK_API_TOKEN` (Required): Zendesk API token\n\n## Quick Start\n\n```bash\ndocker run -d \\\n --name zendesk-mcp \\\n -p 8000:8000 \\\n -e ZENDESK_SUBDOMAIN=your-subdomain \\\n -e ZENDESK_EMAIL=your-email@example.com \\\n -e ZENDESK_API_TOKEN=your-api-token \\\n public.ecr.aws/saltware/zendesk-mcp:latest\n```\n\n## Claude Desktop / Cursor Integration\n\nAdd to mcp.json or mcp_settings.json:\n\n```json\n{\n \"mcpServers\": {\n \"zendesk\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"--rm\", \"-i\",\n \"-e\", \"ZENDESK_SUBDOMAIN=your-subdomain\",\n \"-e\", \"ZENDESK_EMAIL=your-email@example.com\",\n \"-e\", \"ZENDESK_API_TOKEN=your-api-token\",\n \"public.ecr.aws/saltware/zendesk-mcp:latest\"\n ]\n }\n }\n}\n```\n\n## Available Tools\n\n- **search_tickets**: Unified search with keywords, tags, company filter - returns grouped results with ticket URLs\n- **get_ticket_details**: Get detailed ticket information\n- **get_top_agents**: Get top agents by ticket resolution count\n- **get_service_trends**: Analyze service inquiry trends", "usageText": "## Usage\n\n### Docker Run (HTTP Mode)\n\n```bash\ndocker run -d \\\n --name zendesk-mcp \\\n -p 8000:8000 \\\n -e ZENDESK_SUBDOMAIN=your-subdomain \\\n -e ZENDESK_EMAIL=your-email@example.com \\\n -e ZENDESK_API_TOKEN=your-api-token \\\n -e MCP_TRANSPORT=http \\\n public.ecr.aws/saltware/zendesk-mcp:latest\n```\n\n### Docker Run (STDIO Mode for Claude Desktop)\n\n```bash\ndocker run --rm -i \\\n -e ZENDESK_SUBDOMAIN=your-subdomain \\\n -e ZENDESK_EMAIL=your-email@example.com \\\n -e ZENDESK_API_TOKEN=your-api-token \\\n public.ecr.aws/saltware/zendesk-mcp:latest\n```\n\n### search_tickets Parameters\n\n| Parameter | Description | Required |\n|-----------|-------------|----------|\n| keywords | Keyword list (OR search) | One of keywords/tags/company |\n| tags | Tag filter | One of keywords/tags/company |\n| company | Company name filter | One of keywords/tags/company |\n| status | Status filter (open/pending/hold/solved/closed) | No |\n| period_days | Search period in days (default: 90) | No |\n| limit | Max tickets (default: 500) | No |\n\n### Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| ZENDESK_SUBDOMAIN | Zendesk subdomain | Yes |\n| ZENDESK_EMAIL | API user email | Yes |\n| ZENDESK_API_TOKEN | API token | Yes |\n| MCP_HOST | Server host (default: 0.0.0.0) | No |\n| MCP_PORT | Server port (default: 8000) | No |" }