# Xray (Test Management) MCP for AI Agents AI Agent Connect

> Xray (Test Management) MCP connects your Xray account to your AI agent so you can manage QA workflows like browsing test cases, monitoring executions, and auditing histories through natural conversation. It turns your AI into a QA operations analyst, removing the need to manually filter through complex Jira issue lists to find a specific test result or status. It's the fastest way to get QA data without the UI friction.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** test-management, qa-automation, jira-integration, test-execution, bug-tracking, software-quality

## Description

This Connector lets you talk to your Xray Test Management data instead of hunting through endless Jira tickets. You can ask your AI agent to find specific test cases, check the status of a release plan, or pull up the history of a flaky test. Instead of clicking through multiple menus to see if a specific step failed in a test run, you just ask and get the answer immediately. It connects your Xray account to any AI client you use, making it easier to stay on top of quality assurance without the manual overhead. Because Vinkius hosts this in their catalog, you can plug it into your existing workflow and start querying your QA library right away. You'll get a clear picture of your project's readiness by pulling high-level plans or drilling down into granular execution results. It's about getting the right QA data at the right time without the friction of a standard UI. You can see how your test sets are organized, verify your project configurations, and monitor the pulse of your release cycles in real time. It turns the way you interact with your quality assurance data from a series of clicks into a simple conversation. This means you spend less time navigating menus and more time actually fixing bugs and improving your software quality.

## Tools

### get_xray_settings
Get project configuration and field mappings. This helps your agent understand your specific workflow.

### get_execution_details
Get results for a specific test execution. Use this to see exactly which steps failed.

### get_test_plan_details
Get details for a specific test plan. This shows you the scope and progress of a testing strategy.

### get_individual_test_runs
Get run instances for a specific test. This is perfect for auditing historical performance.

### get_test_details
Get details for a specific Xray test case. Use this to see preconditions and test steps.

### list_test_executions
List all test execution records. This lets you see the overall status of your QA runs.

### list_test_plans
List all test plans in Xray. Use this to get a high-level view of your testing roadmap.

### list_test_sets
List all test sets. This helps you see how tests are organized into functional groups.

### list_xray_tests
List all test cases in the project. This is the quickest way to browse your entire QA library.

## Prompt Examples

**Prompt:** 
```
What's the status of the 'Mobile-App' project tests?
```

**Response:** 
```
I found 15 test cases in project 'Mobile-App'. The most recent are:

| Test Name | Key | Status |
| :--- | :--- | :--- |
| Login Validation | TST-101 | Passed |
| Profile Update | TST-102 | Passed |
| Push Notifications | TST-103 | Passed |

Which one would you like to inspect?
```

**Prompt:** 
```
Did the payment test fail in the last run?
```

**Response:** 
```
Results for the last payment test execution show a failure:

* **Total Tests:** 10
* **Passed:** 8
* **Failed:** 2 (TST-42, TST-45)

**Failure Detail for TST-42:**
The step 'Submit payment' returned a 500 error. Would you like me to pull the logs for these failures?
```

**Prompt:** 
```
Show me the progress of the v2.4 release.
```

**Response:** 
```
Plan 'v2.4 Release' (Key: PLAN-12) is **75% complete**.

* **Executed:** 45/60 tests
* **Passed:** 40
* **Failed:** 5
* **Pending:** 15

The regression test set is still pending execution.
```

## Capabilities

### Browse test cases
Find and inspect specific test keys within your project using natural language.

### Monitor executions
Track real-time QA results and release readiness across your project.

### View granular results
See exactly which steps passed, failed, or hit errors during a specific test run.

### Check test plans
Retrieve scope details and progress for high-level testing strategies.

### Group test sets
See how individual test cases are organized into functional or regression groups.

### Audit test history
Identify flaky tests by looking at the complete run history across multiple cycles.

### Verify project config
Check environment settings and status mappings to keep your agent aligned with your workflow.

## Use Cases

### Checking Release Readiness
A Product Owner asks the agent for the status of the 'v2.4 Release' plan. The agent uses list_test_plans and list_test_executions to report completion percentage and pending tests.

### Debugging a Failure
A developer asks why a payment test failed. The agent uses get_execution_details to find the specific step that returned a 500 error.

### Audit Trail for Flaky Tests
A QA engineer notices a test is inconsistent. They ask the agent to pull the history for that test using get_individual_test_runs to see patterns.

### Onboarding New QA
A manager wants to see how tests are grouped. The agent uses list_test_sets to show the functional organization of the library.

## Benefits

- Stop manual Jira filtering by using list_xray_tests to find any test case instantly.
- Identify flaky tests faster by using get_individual_test_runs to see historical data across cycles.
- Get instant release readiness updates by using list_test_executions to see the latest QA results.
- Understand complex test scopes quickly with get_test_plan_details for high-level strategy.
- Debug failures faster by using get_execution_details to see specific failed steps and error messages.
- Keep your agent aligned with your project by using get_xray_settings to pull environment mappings.

## How It Works

The bottom line is you get a conversational interface for your entire Xray QA library.

1. Subscribe to the Xray (Test Management) MCP on Vinkius.
2. Enter your Xray Client ID and Client Secret in your AI client settings.
3. Ask your agent to list test plans, browse cases, or check execution results.

## Frequently Asked Questions

**Can I use Xray (Test Management) to check my QA progress?**
Yes, this Connector allows your AI agent to pull high-level test plan details and list all test executions so you can see exactly how much of your testing is complete.

**Does Xray (Test Management) work with my Jira project?**
Yes, it connects directly to your Xray account, which is the leading quality assurance platform for Jira, giving your agent access to your specific project data.

**How does Xray (Test Management) help with flaky tests?**
It allows your agent to retrieve individual test run instances for a specific test, making it easy to audit historical performance and identify inconsistent results.

**Can my agent find specific test keys?**
Yes, your agent can list all test cases in your project, allowing you to find and inspect specific test keys like TST-101 through natural conversation.

**Can I see which steps failed in a test?**
Yes, the Connector can retrieve granular results for specific executions, showing you exactly which steps passed, failed, or encountered specific errors.

**Can I check the specific steps of a test case through the agent?**
Yes. The `get_test_details` tool allows your AI agent to retrieve the full technical metadata for any test key, including the defined test steps, preconditions, and any linked requirement issues.

**How do I find out which tests failed in a recent execution?**
You can use the `get_execution_details` tool. Provide the unique execution key, and your agent will return a granular breakdown of the results, highlighting tests that failed or were aborted.

**Is it possible to see the progress of a test plan via chat?**
Absolutely. Using the `get_test_plan_details` tool, your agent can retrieve the scope and real-time progress metrics for any plan ID, helping you monitor overall QA coverage for a release.