How to Use the Xray (Test Management) MCP in Mastra AI

Q: What information can I retrieve about test plans using Mastra AI for Xray (Test Management)?

You use gettestplandetails to gather everything about a plan. The agent confirms if all necessary components are present and reports the full scope of testing defined in Jira.

Q: Does the Mastra AI client support listing all test sets in Xray (Test Management)?

Yes, it can call listtestsets to build a comprehensive inventory. This allows your workflow engine to ensure that every required group of tests is accounted for before deployment.

Build resilient QA pipelines with Mastra AI by automating Xray (Test Management) checks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Xray (Test Management) MCP to Mastra AI

Create your Vinkius account to connect Xray (Test Management) to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Xray (Test Management) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Check Test Execution Status

When a complex workflow needs status checks, Mastra AI uses `list_test_executions`. It can check the list of records and automatically retry if an endpoint fails due to temporary network issues. This ensures your process doesn't halt just because of bad connectivity. The agent reports on test outcomes after several attempts, guaranteeing a reliable result for every step in your multi-stage deployment.

Deep Dive into Test Runs

Use `get_individual_test_runs` when a specific part of the workflow needs deep inspection. The agent gets the run instance details, allowing you to write conditional logic based on success or failure. If it fails, the workflow can immediately switch to a recovery step. This means your system doesn't just report data; it acts on it, continuing complex processes regardless of intermediate test results.

Plan Validation and Retries

A multi-step plan requires knowing what to check next. Mastra AI runs `list_test_plans` first. If the required plan isn't found, it triggers a predefined failure handler—say, notifying an admin or falling back to a default test set. This conditional branching makes your workflows robust enough for production use.

Setup guide

Set up Xray (Test Management) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Xray (Test Management) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "xray-test-management-mcp-client",
  servers: {
    "xray-test-management-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Xray (Test Management) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Xray (Test Management) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Xray (Test Management) transactions"
);
console.log(result.text);

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Xray (Test Management) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Xray (Test Management) MCP in Mastra AI

It builds automatic retries with exponential backoff. If a connection drops or an API call fails, the agent waits and tries again up to a specified number of times before failing the overall workflow.

You use `get_test_plan_details` to gather everything about a plan. The agent confirms if all necessary components are present and reports the full scope of testing defined in Jira.

Yes, it can call `list_test_sets` to build a comprehensive inventory. This allows your workflow engine to ensure that every required group of tests is accounted for before deployment.

It uses the details to evaluate conditions. For instance, 'If execution status is FAILURE AND test type is API,' then trigger a rollback sequence.

This server touches Test Execution Records, Test Plan Metadata, and Test Set Lists. These are the critical pieces of information needed to build reliable QA automation pipelines.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript