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- Tag-based search: Search tickets by service classification tags\n- Keyword-based search: Search tickets by keywords (for older tickets without tags)\n- Free-text search: Search tickets with any query\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_by_tag**: Search tickets by service tag and aggregate by company\n- **search_tickets_with_keywords**: Search tickets by keywords and aggregate by company\n- **search_tickets**: Free-text ticket search\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### 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_TRANSPORT | Transport mode (http/stdio) | No |\n| MCP_HOST | Server host (default: 0.0.0.0) | No |\n| MCP_PORT | Server port (default: 8000) | No |" }