# Zephyr Scale (SmartBear) MCP for AI Agents AI Agent Connect

> Zephyr Scale (SmartBear) MCP lets you manage your Jira test cases, cycles, and execution results using your AI client. It pulls real-time QA data so you can track progress, audit test scripts, and organize your testing strategy without digging through complex Jira plugins.

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

## Description

This Connector connects your Zephyr Scale (SmartBear) account to your AI agent so you can handle your QA operations through a simple chat interface. Instead of clicking through nested Jira menus to find a specific test script or checking the status of a regression cycle, you just ask your agent to do it for you. You can pull up the preconditions for a failed test, check which environments are currently configured, or see how many test steps are left in a sprint. It turns your AI into a QA coordinator that knows exactly where your test plans stand. When you use this with the Vinkius catalog, you get a direct line into your enterprise quality assurance infrastructure, making it much easier to keep your release schedule on track. You'll stop hunting for data and start making decisions based on what's actually happening in your test cycles.

## Tools

### list_test_cases
Lists all test cases in a Jira project by key. It is your primary tool for finding specific work items in your backlog.

### list_test_cycles
Lists all test cycles in a project. Use this to see how test runs are grouped for different releases or sprints.

### get_test_cycle
Gets all the details for a specific test cycle. It helps you quickly check the status and scope of a specific run.

### list_executions
Shows all test executions in your project. This gives you a bird's eye view of all ongoing work and results.

### get_execution
Pulls the full details of a specific Zephyr Scale test execution. It is useful for seeing exactly which step caused a failure.

### list_test_plans
Lists all test plans in your project. This helps you understand the overall testing strategy and project scope.

### list_folders
Shows the folder hierarchy for test cases, cycles, or plans. This makes navigating your project organization much faster.

### list_statuses
Lists all custom test execution statuses in a project. Use this to see the specific statuses your team uses for reporting.

### list_environments
Lists all configured test environments in a project. This lets you quickly see which environments like Staging are active.

### get_test_case
Retrieves the full details of a specific test case. This is the fastest way to see preconditions and scripts in one place.

## Prompt Examples

**Prompt:** 
```
What's the status of the regression cycle for the Q1 release?
```

**Response:** 
```
The regression cycle for Q1 is currently **In Progress**. It contains 25 test executions, with 15 completed. Progress is at 60%.
```

**Prompt:** 
```
Show me the steps for the login test in project PROJ.
```

**Response:** 
```
I found the **'User Login'** test case (PROJ-T1). Here are the details:

- **Objective**: Verify user can log in.
- **Preconditions**: User has a valid account.
- **Steps**:
  1. Enter username.
  2. Enter password.
  3. Click Login.
```

**Prompt:** 
```
List the environments for our project.
```

**Response:** 
```
I found 3 test environments configured for your project:

- Staging
- Production
- UAT (User Acceptance Testing)
```

## Capabilities

### Pull test case details
Get the full objective, preconditions, and steps for any specific test.

### Monitor cycle progress
See how many tests are finished in a specific release or sprint.

### Audit test environments
View the list of configured environments like Staging or Production.

### Browse folder structures
Navigate the hierarchy of your test plans and cycles quickly.

### Track execution results
See real-time pass, fail, and blocked statuses for your test runs.

### Explore test plans
View the high-level testing strategy for your entire project.

## Use Cases

### Debugging a failed test
A QA Engineer needs to know why a specific test failed. They ask the agent to pull the details for a specific execution ID to see the failed step.

### Verifying release readiness
A Release Manager wants to know if a regression cycle is done. They ask the agent to check the progress of the current sprint cycle.

### Reproducing a bug
A Developer is trying to reproduce a bug. They ask the agent to list the preconditions and steps for a test case from a previous run.

### Auditing project structure
A Test Manager needs to reorganize folders. They ask the agent to list the folder hierarchy to see how test plans are currently grouped.

## Benefits

- Stop digging through Jira menus by using list_test_cases to find any work item in seconds.
- Get instant clarity on release readiness by using list_test_cycles to see all sprint groupings.
- Reduce debugging time for developers who can use get_test_case to see exact failure steps.
- Audit your QA infrastructure faster with list_environments to see all active staging and production setups.
- Keep your team aligned on the testing strategy by using list_test_plans to view the project scope.
- Track real-time progress with list_executions to see exactly how many tests are passing or blocked.

## How It Works

The bottom line is you get a chat-based command center for your Jira test management.

1. Subscribe to this Connector and grab your Zephyr Scale API Token.
2. Connect the Connector to your AI client like Claude or Cursor.
3. Ask your agent to list test cases or check cycle statuses to start managing your QA.

## Frequently Asked Questions

**Can I use Zephyr Scale (SmartBear) MCP to see my test results?**
Yes, you can use it to see the pass, fail, and blocked status of your test executions. It pulls this data directly into your chat so you don't have to open Jira.

**Does Zephyr Scale (SmartBear) MCP work with my Jira project?**
It works with any project where you have Zephyr Scale configured. You just provide your project key to the agent to start browsing your test cases.

**Can I check test scripts using Zephyr Scale (SmartBear) MCP?**
Yes, you can ask your agent to retrieve the full details of any test case. It will pull the objective, preconditions, and detailed scripts for you.

**Is Zephyr Scale (SmartBear) MCP good for release management?**
It's great for checking the status of test cycles and plans. You can quickly see if a release is ready by asking the agent to summarize the progress of your cycles.

**How does Zephyr Scale (SmartBear) MCP help with debugging?**
It helps developers find the exact steps of a failed test execution. Your agent can pull up the specific failure details so you can see what went wrong quickly.

**Can I see what environments are set up with Zephyr Scale (SmartBear) MCP?**
Yes, you can list all configured environments like Staging or Production. This helps you verify where your tests are actually running.

**Can I check the specific test steps for a case through the agent?**
Yes. The `get_test_case` tool allows your AI agent to retrieve the full script for any test key, providing the exact sequence of steps, test data, and expected results defined in Zephyr Scale.

**How do I see the progress of a specific test cycle via chat?**
Use the `get_test_cycle` tool. Provide the unique cycle key, and your agent will return the cycle status, planned dates, and high-level execution statistics to help you monitor testing progress.

**Is it possible to see the results of individual test runs?**
Absolutely. Using the `get_execution_details` tool, your agent can retrieve step-by-step results for any execution, including comments and execution time, helping you identify exactly where a test failed.