# Zendesk QA (Klaus) MCP

> Zendesk QA (Klaus) MCP connects your AI agent directly to your customer service quality assurance data. Use it to list all reviews, search specific conversations by client email or topic, and import external ticket records for grading. It lets you automate the messy process of gathering support performance metrics without ever leaving your chat window.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** quality-assurance, customer-service, qa-reviews, ticket-analysis, performance-metrics, feedback-loop

## Description

Managing customer service quality used to mean manually exporting reports, cross-referencing spreadsheets, and hunting through endless tickets just to find out if an agent followed protocol. This MCP changes that. Connect it to any AI client via Vinkius to instantly automate the core of your QA workflow. Your agent can list all available workspaces so you know exactly what data pools exist. Need performance metrics? You can ask your agent to search for conversations based on a customer's email or even find out which interactions have been graded already. Plus, if you get external ticket data from another system, the MCP lets you import that information directly into Zendesk QA for grading. It also handles cleaning up old records by letting you permanently remove specific ticket data when needed.

## Tools

### delete_qa_tickets
Removes specific customer ticket records directly from the QA platform.

### import_qa_tickets
Brings external conversation data into Zendesk QA so it can be reviewed for quality scores.

### import_qa_users
Syncs agent and manager profiles from your company directory into the QA platform.

### list_all_reviews
Retrieves a comprehensive list of all quality assurance reviews across the entire account.

### search_qa_conversations
Searches for specific customer interactions within Zendesk QA using keywords or criteria.

### list_workspace_reviews
Lists all quality assurance reviews that belong to a defined, single workspace.

### list_qa_workspaces
Provides a list of all available workspaces so you can target your review exports correctly.

## Prompt Examples

**Prompt:** 
```
List all my Zendesk QA workspaces.
```

**Response:** 
```
I've retrieved your workspaces. You have 3 active environments: 'English Support', 'Spanish Support', and 'Technical Escalations'. Which one would you like to access?
```

**Prompt:** 
```
Show recent QA reviews for the 'English Support' workspace (ID: '123').
```

**Response:** 
```
I found 10 recent reviews for the English Support workspace. The average Internal Quality Score (IQS) is 92%. Notable recent reviews include tickets #ORD-987 and #TECH-101.
```

**Prompt:** 
```
Search for reviewed conversations associated with client email 'user@example.com'.
```

**Response:** 
```
I've searched your account and found 2 conversations for 'user@example.com' that have been graded. Ticket #12345 received a score of 100% and Ticket #12346 received a score of 85%.
```

## Capabilities

### Retrieve performance metrics
List all quality assurance reviews and internal scores, either across the entire account or within a single workspace.

### Find conversations by topic
Search for specific customer interactions to quickly see which ones have already been assigned a grade.

### Sync ticket data
Import raw conversation data and agent profiles from other systems, preparing them for official grading within Zendesk QA.

### Manage workspace access
Identify all available workspaces to keep your different support teams' quality processes organized.

## Use Cases

### Auditing Agent Performance Post-Audit
A QA Manager needs to check how many reviews were completed last month for the 'Technical Support' team. They ask their agent to `list_workspace_reviews` (targeting the specific workspace ID) and immediately see a count of 150, instead of clicking into the dedicated workspace view in Zendesk.

### Investigating High-Value Client Complaints
A Support Lead knows client 'Acme Corp' had an issue last week. They ask their agent to `search_qa_conversations` using Acme Corp's account email, and the agent returns two graded tickets with detailed scores for review.

### Onboarding a New Support Channel
An Operations Analyst gets ticket data from Slack that needs to be scored. They use their agent to `import_qa_tickets`, feeding the new conversation records into Zendesk QA so the team can start grading them immediately.

### Cleaning Up Old Data for Compliance
A manager needs to remove a batch of old, irrelevant ticket data. They command their agent to `delete_qa_tickets` by ID range, ensuring the records are permanently purged from the QA platform.

## Benefits

- Stop pulling reports from Zendesk UI. Instead, ask your agent to use `list_all_reviews` and get the data you need structured immediately for reporting.
- Don't waste time searching through tickets. Just tell your agent to `search_qa_conversations` by a client email or issue type, and it pulls up all graded interactions.
- When integrating external systems, use `import_qa_tickets`. Your agent takes the raw data from another platform and gets it ready for grading inside Zendesk QA.
- Need to keep your team organized? Use `list_qa_workspaces` first. This lets you pinpoint exactly which subset of reviews belongs to a specific department or region.
- Keep compliance clean. If you need to remove old data, the agent can execute `delete_qa_tickets`, taking records out of circulation with a simple command.

## How It Works

The bottom line is that instead of logging into Zendesk QA and clicking through multiple menus, you just talk to your agent and get the data you need instantly.

1. Subscribe to this MCP and provide your Zendesk Subdomain credentials along with the QA API Token.
2. Connect your agent from Claude, Cursor, or any compatible client using the provided tokens.
3. Tell your agent exactly what you need—for example, 'List all recent quality assurance reviews for the European support team.' — and it executes the task.

## Frequently Asked Questions

**How do I list all my Zendesk QA workspaces using the Zendesk QA (Klaus) MCP?**
You use the `list_qa_workspaces` tool. This command provides a full inventory of your environments, allowing you to know exactly which ID you need for subsequent review exports.

**Can I import raw ticket data into Zendesk QA using this MCP?**
Yes, the `import_qa_tickets` tool lets your agent take conversation records from outside sources and properly structure them for grading within the platform.

**What is the difference between listing all reviews and listing workspace reviews with Zendesk QA (Klaus) MCP?**
The `list_all_reviews` tool pulls data account-wide, giving you a total view. The `list_workspace_reviews` tool limits results to only one specific workspace ID, which is better for department-specific reports.

**Does the Zendesk QA (Klaus) MCP allow me to delete old tickets?**
Yes, you can use `delete_qa_tickets` to permanently remove specific ticket data records from the platform when required for compliance or cleanup.