Xray Test Management MCP. Get QA insights through plain conversation.
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.
Give Claude and any AI agent real-world access
List all available test cases in a project and pull out specific unique keys for deep inspection.
Track current QA outcomes by listing and checking records from completed test runs to gauge release health.
Get detailed results for a specific execution, pinpointing exactly which steps passed, failed, or hit an error.
Browse high-level test plans to understand the scope of testing and track overall progress against goals.
See how individual test cases are grouped together in functional or regression test sets.
Retrieve the full run history for any single test case across multiple cycles to identify unstable or flaky tests.
Check environment settings and status mappings to ensure your AI agent is aligned with the project's workflow.
Ask an AI about this
Waiting for input…
What AI agents can do with Xray (Test Management) with 9 Tools
These tools let your agent pull specific data from Xray, giving you the power to track test progress, view detailed execution results, and manage project configurations conversationally.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Xray (Test Management) MCPGet 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.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Xray (Test Management), then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Xray (Test Management). All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The Manual Pain of Quality Assurance Reporting
Right now, checking release status means logging into Xray and navigating through dozens of dashboards. You have to manually filter by date range, then select the specific test plan, check if all required test sets are complete, and finally copy-paste summary data for stakeholders. It's a painful sequence of clicks.
With this MCP, you just talk to your agent. Instead of clicking through five screens to get that status, you ask: 'Show me the progress for v2.4 Release.' The answer comes back immediately in plain language, giving you instant visibility into test plan completion and failure metrics.
Xray Test Management MCP Delivers Deep Insights
The tedious steps of manually comparing execution results to determine if a bug is flaky or critical disappear. You can ask the agent to list test executions and then use specific tools like `get_test_details` to pull up all necessary context for review.
Your AI client now acts as an embedded QA specialist, giving you immediate answers about your codebase's health that were previously locked away behind complex Jira menus. It’s pure, instant intelligence.
What Xray Test Management MCP does for your AI
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.
019d7625-b3c4-73c4-a282-097d7e15cdee How to set up Xray Test Management MCP
The bottom line is you get instant, conversational access to deep QA metrics without manual dashboard navigation.
Subscribe to this MCP using your Xray Client ID and Secret.
Connect your preferred client (Claude, Cursor, etc.) through Vinkius.
Ask your agent a question in plain English; it uses the available tools to fetch and summarize complex test data.
Who uses Xray Test Management MCP
This MCP is essential for Quality Assurance Engineers, Test Managers, and Product Owners who are tired of copy-pasting data from Jira dashboards. If checking release readiness or debugging a flaky test requires clicking through five different screens, you need this.
They use the MCP to check specific execution results and pull historical data on individual tests to help pinpoint failure causes.
They rely on it to quickly surface progress across entire test plans and verify how test sets are organized without manual navigation.
They use the MCP to check the latest execution status before a release is greenlit, ensuring quality standards were actually met.
Benefits of connecting Xray Test Management MCP
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.
Xray Test Management MCP 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.
Xray Test Management MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it like a search bar
Typing, 'I want to know about the mobile login test.' This vague query forces the agent to guess which specific tool or dataset you mean.
Instead, ask: 'List all test cases in the Mobile-App project and give me their keys.' Use the list_xray_tests function for a precise list of available assets.
Asking for generalized reports
Saying, 'Give me an overall report on last week's testing.' This is too vague and requires manual filtering by the agent.
Be specific: 'List test executions from the past seven days that had a failure count greater than zero.' Use list_test_executions to narrow down the search.
Confusing plans with sets
Asking, 'Show me the plan for regression testing.' This might pull general documentation instead of the current execution status.
Use list_test_sets first to see how tests are grouped, then use a specific tool like get_test_plan_details with the correct key.
When to use Xray Test Management MCP
You should use this MCP if your primary job involves auditing, tracking, or reporting on quality assurance outcomes from Jira's Xray platform. It excels when you need to move beyond a simple 'pass/fail' status and dive into the mechanics of why something failed—like checking specific steps within an execution using get_execution_details or understanding test history with list_individual_test_runs. Don't use this if your goal is simply creating new test cases, writing documentation, or managing user permissions. For those tasks, you need a dedicated Jira administrative tool, not a QA reporting MCP.
Frequently asked questions about Xray Test Management MCP
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.