# Xray Test Management MCP > Xray (Test Management) MCP connects your AI agent directly to Xray, Jira's leading quality assurance platform. Use natural conversation to manage complex testing workflows. You can list all test cases, check execution results for specific runs, monitor entire test plans, and audit historical data across projects—all without navigating Jira menus. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** test-management, qa-automation, jira-integration, test-execution, bug-tracking, software-quality ## Description Managing QA is usually a nightmare of dashboards, filters, and deep linking. This MCP changes that by letting your AI agent talk to Xray directly. Instead of spending time clicking through complex issue lists just to find out why a test failed, you simply ask your client what happened. Your agent acts as an experienced QA analyst, pulling granular data on everything from specific failing steps to overall release readiness. You can check the status of large test plans or audit how one test case performed over several cycles. Because this MCP is hosted and managed by Vinkius, you connect once through any compatible client—Claude, Cursor, Windsurf, etc.—and get immediate access to all these powerful testing tools. It’s about making your AI agent do the heavy lifting so you can focus on fixing the bugs. ## Tools ### get_xray_settings Fetches the current project configuration and field mappings for Xray. ### get_execution_details Retrieves detailed results for a specific instance of test execution. ### get_test_plan_details Gets comprehensive information about a defined test plan. ### get_individual_test_runs Pulls individual run instances for a specific test case key. ### get_test_details Retrieves all available details for any specified Xray test case. ### list_test_executions Lists every recorded instance of a test execution that has taken place. ### list_test_plans Shows a list of all active and configured test plans within the project. ### list_test_sets Lists functional or regression groups, showing how tests are organized together. ### list_xray_tests Provides a complete list of every test case defined in the Xray project. ## Prompt Examples **Prompt:** ``` List all test cases in the 'Mobile-App' project. ``` **Response:** ``` I found 15 test cases in project 'Mobile-App'. The most recent are: 1. 'Login Validation' (Key: TST-101), 2. 'Profile Update' (Key: TST-102), and 3. 'Push Notifications' (Key: TST-103). Which one would you like to inspect? ``` **Prompt:** ``` What were the results for execution 'EXEC-555'? ``` **Response:** ``` Results for EXEC-555: Total Tests: 10. Passed: 8, Failed: 2 (TST-42, TST-45). Failed steps in TST-42: 'Submit payment' returned a 500 error. Would you like me to pull the logs for these failures? ``` **Prompt:** ``` Show me the test plan progress for 'v2.4 Release'. ``` **Response:** ``` Plan 'v2.4 Release' (Key: PLAN-12) is 75% complete. 45/60 tests have been executed. Current status: 40 Passed, 5 Failed, 15 Pending. The regression test set is still pending execution. ``` ## Capabilities ### Discover and Inspect Test Cases List all available test cases in a project and pull out specific unique keys for deep inspection. ### Monitor Execution Results Track current QA outcomes by listing and checking records from completed test runs to gauge release health. ### Analyze Failed Test Steps Get detailed results for a specific execution, pinpointing exactly which steps passed, failed, or hit an error. ### Review Test Strategies and Plans Browse high-level test plans to understand the scope of testing and track overall progress against goals. ### Organize Tests into Groups See how individual test cases are grouped together in functional or regression test sets. ### Audit Test History Retrieve the full run history for any single test case across multiple cycles to identify unstable or flaky tests. ### Verify Project Configuration Check environment settings and status mappings to ensure your AI agent is aligned with the project's workflow. ## Use Cases ### Investigating a Critical Failure A QA Engineer finds an issue during staging but can’t tell if it's intermittent. Instead of spending hours comparing logs, they ask their agent to list individual test runs for that specific test case key and check the run history to see if this failure pattern is new or persistent. ### Release Readiness Check A Product Owner needs sign-off for a major version release. They ask their agent to list all active test plans and summarize which ones are 90% complete, getting an immediate status report without opening the main dashboard. ### Debugging Development Issues A developer is debugging a failure reported by QA. Instead of asking QA for screenshots, they ask their agent to get execution details for that specific run, which immediately shows them the exact step and error code (e.g., 500) needed to fix it. ### Validating Test Coverage A Test Manager wants to ensure a new feature wasn't missed. They ask their agent to list test sets related to the 'Billing Module,' which shows them all the functional groups they need to review and update. ## Benefits - Audit historical data for flaky tests. Instead of manually tracking a test’s performance across multiple Jira runs, you use the tool to get the complete run history and spot patterns instantly. - Know exactly what failed. If an execution fails, don't just see 'Failed.' Use the function that retrieves granular results to pinpoint if the problem was in step three or the payment submission logic. - Plan reviews are faster than ever. Get test plan progress by listing all available plans and seeing the current completion percentage without navigating multiple boards. - Understand your scope quickly. You can list all test cases, giving you a quick overview of what's being tested, and then use related tools to see how they’re grouped in functional sets. - Check project alignment easily. Use the function that verifies environment settings to confirm your agent is reading status codes correctly for the current build target. ## How It Works The bottom line is you get instant, conversational access to deep QA metrics without manual dashboard navigation. 1. Subscribe to this MCP using your Xray Client ID and Secret. 2. Connect your preferred client (Claude, Cursor, etc.) through Vinkius. 3. Ask your agent a question in plain English; it uses the available tools to fetch and summarize complex test data. ## Frequently Asked Questions **How do I check if a test case failed repeatedly using Xray Test Management MCP?** You use the tool to list individual test runs for that specific test case. This lets you retrieve the complete run history, which helps identify flaky tests or recurring failures across multiple cycles. **Can I see a summary of all my available tests using Xray Test Management MCP?** Yes, simply use the tool to list all test cases in your project. This gives you an immediate overview and unique keys for any deep inspection required. **What is the difference between a Test Plan and a Test Set using Xray Test Management MCP?** The MCP allows you to list both, but they serve different purposes. You can use `list_test_plans` for high-level strategy and `list_test_sets` to see how tests are functionally grouped together. **How do I find out what failed during a specific test run?** You retrieve the granular results by using the tool that gets execution details. This pinpoints exactly which steps, not just the overall test, returned an error code or passed. **Does Xray Test Management MCP work with any AI client?** Yes, because this is an MCP hosted on Vinkius, you connect once from your preferred compatible client (Claude, Cursor, Windsurf) and gain access to all the tools.