Jira Xray Tools

Jira Xray Tools is a Visual Studio Code extension to automate common Jira and Xray Cloud workflows from the Command Palette.

This project can also run as an MCP server so the same Jira/Xray capabilities are available to MCP clients.

Features

• Configure Jira and Xray credentials securely using VS Code SecretStorage.
• Test Jira and Xray connectivity before running workflows.
• Create Jira issues.
• Create Xray Test issues.
• Create Xray Test Execution issues.
• Link regular Jira issues to Test Executions.
• Add tests to a Test Execution (accepts issue keys or numeric IDs).
• Get full Jira issue details by key or numeric ID.
• Get a filtered Jira issue summary with the most relevant fields.
• Resolve test runs.
• Upload evidence files to test runs.
• Run the same workflows as MCP tools over stdio.

Commands

• Jira Xray: Configure Credentials
• Jira Xray: Test Connection
• Jira Xray: Create Issue
• Jira Xray: Create Test
• Jira Xray: Create Test Execution
• Jira Xray: Link Issue To Test Execution
• Jira Xray: Add Tests To Execution
• Jira Xray: Get Issue Details
• Jira Xray: Get Issue Summary
• Jira Xray: Get Test Run
• Jira Xray: Upload Evidence

MCP Server

The repository includes an MCP server entrypoint in dist/mcp.js after build.

Build and run

npm install
npm run build
npm run mcp

Required environment variables

• JIRA_BASE_URL
• JIRA_EMAIL
• JIRA_API_TOKEN
• JIRA_PROJECT_KEY
• XRAY_CLIENT_ID
• XRAY_CLIENT_SECRET

Exposed MCP tools

• test_connection
• get_issue_details
• get_issue_summary
• create_issue
• create_test
• create_test_execution
• link_issue_to_test_execution
• add_tests_to_execution
• get_test_run
• upload_evidence

Example MCP client config

{
   "mcpServers": {
      "jira-xray-tools": {
         "command": "node",
         "args": ["/absolute/path/to/agente jira xray/dist/mcp.js"],
         "env": {
            "JIRA_BASE_URL": "https://your-domain.atlassian.net",
            "JIRA_EMAIL": "you@example.com",
            "JIRA_API_TOKEN": "your-jira-token",
            "JIRA_PROJECT_KEY": "MBA",
            "XRAY_CLIENT_ID": "your-xray-client-id",
            "XRAY_CLIENT_SECRET": "your-xray-client-secret"
         }
      }
   }
}

When the extension is installed from Marketplace, the MCP entrypoint is also shipped in the extension files, so you can point your MCP client to that dist/mcp.js path inside the installed extension folder.

Setup

1. Install the extension.
2. Run the command Jira Xray: Configure Credentials.
3. Provide:
   • Jira base URL (for example: https://your-domain.atlassian.net)
   • Jira email
   • Jira API token
   • Xray client ID
   • Xray client secret
   • Default Jira project key
4. Run Jira Xray: Test Connection.

Notes

• Xray GraphQL operations require numeric Jira issue IDs. The extension can resolve issue keys automatically in supported flows.
• For localized Jira projects, issue type names may differ by language. The extension queries available issue types directly from Jira.

Security

• Secrets are stored in VS Code SecretStorage.
• Do not commit credential files such as .env to source control.

Development

npm install
npm run build
npm run typecheck

To run the extension in development mode, use the launch configuration:

• Run Jira Xray Extension

License

This project is licensed under the ISC License. See LICENSE.