# MaestroQA MCP > MaestroQA gives your AI client access to detailed customer service quality assurance data. It lets you list support tickets, retrieve real-time Internal Quality Scores (IQS), sync external CSAT metrics, and run asynchronous exports of performance records. Use it when you need to audit agent work or analyze trends across a large ticket volume via natural language commands. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** quality-assurance, performance-reporting, csat, agent-coaching, data-export, support-analytics ## Description You wanna audit your team? MaestroQA gives your AI client deep access to quality assurance data from customer support tickets. You can use this server when you need to track agent performance, check metrics across huge volumes of tickets, or sync external satisfaction scores right into the system. **Checking Ticket Scores and Details** You've got a ticket ID; you wanna know how it stacked up? The `get_ticket_qa_details` tool pulls all the Internal Quality Scores (IQS) and gives you the full grading breakdown for that specific support ticket. If you need to see what's going on across your whole department, you start with `list_qa_tickets`. This lists every support ticket and its current QA status; you can filter those results by date or by any status to quickly find pending reviews. **Managing Agents and Rubrics** To figure out who needs coaching, use `list_qa_agents` to get a list of every agent tracked in MaestroQA. You also need to know what the team is grading against. The `list_qa_rubrics` tool displays all available evaluation rubrics your team uses for scoring tickets. **Syncing External Data and Exporting Records** Don't forget about customer feedback outside of the system. You can use `push_csat_scores` to send external Customer Satisfaction (CSAT) scores directly into MaestroQA, letting you pair those metrics with internal performance grades for a full picture. When you need deep analysis that goes beyond what your AI client can display live, you initialize an export job using `request_qa_data_export`. This starts a background process to compile all the raw QA data across a specific date range. Once that job is done, you call `get_export_download_links` and it pulls the final download link for your records. **What You Actually Do With These Tools** * **Audit Specific Tickets:** Give the agent one ticket ID; it returns the Internal Quality Score (IQS) and full grading details. * **Find Pending Reviews:** Call `list_qa_tickets` to fetch lists of tickets, letting you filter by status or date. * **Review Agent Performance:** Get a list of all agents with `list_qa_agents`, then see what criteria they're judged on using `list_qa_rubrics`. * **Correlate Data Points:** Send external CSAT scores via `push_csat_scores` so you can cross-reference them against internal QA grades. * **Analyze Trends:** Use `request_qa_data_export` to compile raw QA data for a date range, and then grab the final link with `get_export_download_links` when it's ready. ## Tools ### list_qa_agents Returns a list of all agents tracked in MaestroQA, helping you identify who to audit. ### get_export_download_links Pulls the final download link once a previously requested data export is ready. ### get_ticket_qa_details Retrieves all Internal Quality Scores and grading information for one specific support ticket ID. ### push_csat_scores Sends external customer satisfaction scores into MaestroQA's database for correlation with internal grades. ### request_qa_data_export Starts a background job to compile and export raw QA data across a specified date range. ### list_qa_rubrics Displays every available evaluation rubric used by the team for scoring tickets. ### list_qa_tickets Lists all support tickets and their current QA statuses, allowing filtering via optional parameters. ## Prompt Examples **Prompt:** ``` List all support tickets awaiting QA review in MaestroQA. ``` **Response:** ``` I've retrieved the list of tickets. You have 15 tickets currently marked as 'Pending', including Ticket #12345 from 'Support Team A'. Would you like to see the full metadata for any of them? ``` **Prompt:** ``` Request a raw data export for the month of July in MaestroQA. ``` **Response:** ``` I've submitted the export request for July (Start: 2024-07-01, End: 2024-07-31). The export ID is 'exp-98765'. I will check for the download links shortly. ``` **Prompt:** ``` Show the QA score for ticket ID 'ticket-54321'. ``` **Response:** ``` I've retrieved the details for ticket 54321. The Internal Quality Score (IQS) is 🟢 95%. It was graded on 2024-08-15 using the 'Global Support Rubric'. ``` ## Capabilities ### Check Ticket Scores Retrieve the Internal Quality Score (IQS) and full details for a specific support ticket. ### List All Support Tickets Fetch lists of tickets, allowing you to filter results by date or status to see pending reviews. ### Export Performance Data Initialize a background job that compiles raw QA data for a specific date range, providing links when ready. ### Sync External CSAT Scores Send external Customer Satisfaction (CSAT) scores directly into MaestroQA to pair them with internal performance grades. ## Use Cases ### Investigating a low CSAT score. A user notices a ticket has a poor CSAT score. They tell their agent, 'What's the internal QA score for this?' The agent calls 'get_ticket_qa_details', retrieving the IQS and grading status immediately so the manager knows if the problem was process failure or skill gap. ### Running a quarterly performance review. A lead needs to compare Q1 vs. Q2 performance metrics. They use 'request_qa_data_export' for both quarters, then 'get_export_download_links' when the files are ready, giving them two massive CSVs for deep analysis. ### Onboarding a new QA standard. An Ops team needs to update their grading standards. They first use 'list_qa_rubrics' to see what exists, then they run 'list_qa_agents' to confirm who needs training on the new rubrics. ### Batch processing for compliance. A manager has 50 tickets that need review. Instead of manually searching, they ask their agent to 'List all pending QA tickets.' The agent uses 'list_qa_tickets' and presents the list right there. ## Benefits - Audit agents instantly. Instead of drilling into dashboards, you use 'get_ticket_qa_details' to pull the IQS for any ticket ID in one command. - Analyze time trends with bulk exports. Use 'request_qa_data_export' to get raw data spanning months, which is better than relying on limited dashboard filters. - Tie external scores to internal grades. You can call 'push_csat_scores' to merge CSAT feedback with QA scores, giving a 360-degree view of performance. - Keep track of everyone. Use 'list_qa_agents' and 'list_qa_rubrics' together to quickly see who is being graded and by what standard. - Get the right data at the right time. You list tickets with 'list_qa_tickets', then use that small dataset to feed a more detailed export request. ## How It Works The bottom line is that your AI client handles all the API calls; you just talk to it. 1. Subscribe to the MaestroQA server and input your API Token. 2. Your AI client uses natural language to call a specific tool (e.g., 'List tickets for last month'). 3. The agent executes the request, retrieves the QA data, and presents it back to you in conversation. ## Frequently Asked Questions **How do I get all the raw QA data for my team using request_qa_data_export?** You call 'request_qa_data_export' and provide a specific start and end date. This starts an asynchronous export job, so you'll need to use 'get_export_download_links' later to get the final file. **Can I list tickets that are pending QA review using list_qa_tickets?** Yes. You can call 'list_qa_tickets' and provide parameters (like status='Pending') to filter the results, giving you a quick overview of what needs attention. **What tool do I use if I only want to check one ticket's score?** Use 'get_ticket_qa_details'. This tool takes a single ticket ID and gives you the complete scoring breakdown, including IQS and grading dates. **Does MaestroQA handle CSAT scores from non-Maestro sources?** Yes. Use 'push_csat_scores' to sync external customer satisfaction metrics into the system for correlation with internal QA grades. **How do I use `list_qa_agents` to get a roster of all monitored support agents?** It returns a list of every agent tracked in MaestroQA. This function establishes the scope for your quality monitoring, showing which accounts are included in your system's QA reports. **What is the purpose of `list_qa_rubrics`? Does it show all available grading standards?** `list_qa_rubrics` pulls a definitive list of every evaluation rubric you can use. This helps you confirm which scoring guidelines are active and ready for QA review. **After running an export, how do I actually get the file using `get_export_download_links`?** You pass the unique export ID to this tool. It fetches the secure, time-sensitive URLs you need to download the raw data files for analysis. **When I use `get_ticket_qa_details`, what specific audit metadata does it retrieve about a ticket?** It provides deep metadata beyond just the score. You get details like who graded the ticket, when they graded it, and the full breakdown of the rubric criteria used. **What is an Internal Quality Score (IQS)?** IQS is the grade assigned to a ticket during the QA process based on your rubrics. The agent can retrieve this score using the `get_ticket_qa_details` tool. **How do I download a data export?** First, request the export using `request_qa_data_export`. Once processed, use `get_export_download_links` with the provided ID to retrieve the download URL. **Where do I find my API Token?** Log in to MaestroQA, go to Settings > API, and generate a new token. Note that the API is also referred to as 'Rippit' in technical documentation.