How to Use the Xray (Test Management) MCP in VS Code Copilot

Q: Can I list test plans using Xray (Test Management) in VS Code Copilot?

Yes, your team can use listtestplans. This makes sure the code you write for testing always references an active and defined plan.

Q: What specific tests does Xray (Test Management) support in VS Code Copilot?

It supports listing test cases via listxraytests. This gives the team a clear inventory of all the testable items defined within the MCP Server.

Q: Does Xray (Test Management) help with test sets in VS Code Copilot?

You can call listtestsets to get a list of all test groupings. This helps the team structure their code around predefined QA scopes.

Automate QA logic with Xray (Test Management) in VS Code Copilot for your team.

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 VS Code Copilot

Create your Vinkius account to connect Xray (Test Management) to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Review Test Execution Details via MCP Server

Copilot can call `get_execution_details` to pull granular test results directly into the current file. This is perfect for writing automated reporting code that needs deep status information. Don't waste time debugging; let your team's AI client fetch exactly what happened during a specific test run.

Get Full Test Case Information in Copilot Chat

Use `get_test_details` to pull comprehensive information for any Xray test case. This makes writing unit tests that match the platform's expectations much easier. It ensures consistency across the whole team because the tools are committed to the repository via `.vscode/mcp.json`.

List Test Executions from MCP Server

The `list_test_executions` tool gives your Copilot Chat access to all test execution records. This lets developers write code that processes large batches of QA data. Need to check the project's baseline? Running `get_xray_settings` provides the necessary configuration details right in your editor.

Setup guide

Set up Xray (Test Management) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Xray (Test Management) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Xray (Test Management) tools listed. Try asking: "List my recent Xray (Test Management) transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "xray-test-management-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 VS Code Copilot

The MCP Server exposes tools that let the AI client read QA data. When you ask it to call `list_test_executions`, it pulls that data and helps write code around it.

Yes, your team can use `list_test_plans`. This makes sure the code you write for testing always references an active and defined plan.

It supports listing test cases via `list_xray_tests`. This gives the team a clear inventory of all the testable items defined within the MCP Server.

This server touches Test Execution Records and Project Configuration details. It provides read-only access to structured QA metadata from Xray (Test Management).

You can call `list_test_sets` to get a list of all test groupings. This helps the team structure their code around predefined QA scopes.

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