Advanced Zebrunner MCP Server

Official

by maksimsarychau · TypeScript

Advanced analytics, reporting, and safe mutations for Zebrunner. 64 tools, 14 resources, 17 prompts.

A Model Context Protocol (MCP) server for Zebrunner that provides advanced analytics, reporting, failure forensics, and safe TCM mutations. The server is positioned to coexist with the official Zebrunner MCP (beta), and defines 64 tools, 14 resources, and 17 prompts.

🛠️ Key Features

Advanced analytics and reporting for Zebrunner
Failure forensics
Safe TCM mutations
64 tools, 14 resources, 17 prompts
Tool naming uses the adv_<name> canonical form to avoid collisions with the official Zebrunner MCP (e.g., adv_create_test_case, adv_list_test_runs)

🚀 Use Cases

Generating Zebrunner analytics and reports
Investigating failures via failure forensics
Performing safe TCM-related mutations in environments that also use the official Zebrunner MCP (beta)

⚡ Developer Benefits

Predictable tool names under the adv_ prefix
Compatibility support for “Dual-MCP setup” alongside the official Zebrunner MCP (beta)

⚠️ Limitations

No additional functional details beyond the provided counts and capabilities are specified in the available excerpt.

README.md96 KBView on GitHub

Advanced Zebrunner MCP Server

version

A Model Context Protocol (MCP) server that brings advanced analytics, reporting, failure forensics, and safe TCM mutations to Zebrunner. Designed to coexist with the official Zebrunner MCP (beta) — see the "Dual-MCP setup" section below.

Tool naming: every tool on this server is registered under the canonical adv_<name> form (e.g. adv_create_test_case, adv_list_test_runs) so it never collides with the official Zebrunner MCP. The legacy names are kept as deprecated aliases so prompts/scripts that called the old names continue to work for now; aliases will be removed in the next major release.

🆕 v9.4.4 — Test-run metadata agent UX: post-mutation steering hints (discover env/config before update; import does not set badges); dual-MCP routing resource for environments vs Build/Platform; richer tool-intel for adv_manage_test_run. Builds on v9.4.3 env contract — see change-logs.md.

v9.4.3 — adv_prepare_jira_automation_plan + /jira-automation-plan prompt: Zebrunner suite → structured Jira plan; adv_manage_test_run Public API environment as { name } / { id }. See change-logs.md, TEST_PROMPTS.md §20.

v9.3.1 — TCM pagination fixes: correct get_all token walks, root_suite_id subtree scoping, honest bulk metadata. See PUBLIC_API_PAGINATION.md and change-logs.md.

v9.3.0 — Multi-PR / period test impact: change_batches[], /test-impact-period, extended /test-impact. See TEST_IMPACT_WORKFLOW.md and TEST_IMPACT_PR_PERIOD_DESIGN.md.

🆕 v9.2.7 — New adv_scaffold_test_case wizard (hybrid form/conversational) to author test cases from best practices with an automatic warn-only similar-case check, plus optional projectAliases in zebrunner-config.json so tools accept short names as well as Zebrunner project keys. See release notes.

🆕 v9.2.5 — adv_get_test_authoring_trend (TAM template 7) completes 22/22 dashboard widget MCP coverage. Hub tools, pass-rate views, period modes. See TEST_PROMPTS.md §18 and change-logs.md.

v9.2.1 — LLM-visible metrics (include_call_metrics, session breakdown), compact expansion (+19 tools), format/truncation bugfixes. See Token efficiency guide and change-logs.md.

v9.2.0 — Opt-in token/cost optimizations: format:'compact', detail:'summary', adv_batch_get_test_cases, report inline:false. Defaults unchanged. See change-logs.md.

v9.1.0 — Launch mutations: adv_rerun_launch_failures, adv_start_launch (Jenkins Build Now), plus /relaunch-regression-failures and /feature-scoped-launch prompts. See GitHub Release v9.1.0.

📖 Need help with installation? Check out our Step-by-Step Install Guide for detailed setup instructions.

🚀 Installing via npm? See our MCP NPM Installation Guide for Claude Desktop, Cursor, IntelliJ IDEA, and ChatGPT Desktop configuration.

📚 Test vs Test Case vs Launch? See Terminology & Glossary — definitions, counting rules, and how metrics are calculated.

🔥 Why This Server

This is the Advanced Zebrunner MCP Server — built to go well beyond basic test case management and help QA teams work smarter and faster with AI. Compared to the official Zebrunner MCP (beta, ~70 tools spanning Public REST + Reporting/TAM/Launcher), this server provides 76 registered adv_* tools (70 inline-regression suite + 6 handler-module tools; see tools.json) and is safe to run side-by-side with the official server:

Reporting & Analytics — dashboards, pass-rate trends, regression stability reports, runtime efficiency analysis, bug reviews, and weekly delta tracking
Test Coverage & Analysis — coverage gaps, automation readiness scoring, and cross-suite analysis
Intelligent Rules System — 3-tier quality rules with 100+ automated checkpoints for test case validation and improvement
Screenshot & Video Analysis — OCR, image processing, and video analysis powered by sharp, ffmpeg, and tesseract
MCP Resources & Prompts — @ context injection and / workflow commands for streamlined daily operations
Multi-Transport & Multi-Auth — STDIO, Streamable HTTP, self-service OAuth, Okta SSO, and token exchange (Modes 1–5)

3.1. What Makes This Tool Special
3.2. How the Rules Work Together
3.3. Why This Matters
3.4. Customizing Rules for Your Project

📋 Prerequisites
🚀 Quick Start Guide
🔧 Usage Methods

6.1. Method 1: Use with Claude Desktop/Code
6.2. Method 2: Run as standalone server
6.3. Method 3: Smart URL-Based Analysis 🚀

🛠️ Available Tools

7.1. 📋 Test Case Management
7.2. 🌳 Test Suite Hierarchy & Organization
7.3. 🔧 Mutation Tools
7.4. 🔍 Test Coverage & Analysis
7.5. 🧪 Test Code Generation & Validation
7.6. 🚀 Launch & Execution Management
7.7. 📊 Reporting & Analytics
7.8. 🏃 Test Run Management
7.9. 🎯 Management-Focused Quick Commands

📎 MCP Resources & Prompts (NEW)

8.1. Resources — @ Context Injection
8.2. Prompts — / Workflow Commands

🎭 Role-Specific Prompts & Workflows

9.1. 👩‍💻 Manual QA Engineers
9.2. 🤖 Test Automation Engineers & SDETs
9.3. 👨‍💻 Developers
9.4. 👔 Test Managers & Team Leads
9.5. 🏢 Project Owners & Product Managers

📖 Output Formats
⚙️ Configuration Options
🧪 Testing Your Setup
🔍 Troubleshooting
🎯 Example Workflows
🔧 Advanced Features
📚 Additional Documentation
🤝 Contributing
📄 License
🎉 You're Ready!

🎯 What is this tool?

This tool allows you to:

Retrieve test cases and test suites from Zebrunner
Analyze test coverage and generate test code
Get test execution results and launch details
Validate test case quality with automated checks using intelligent rules
Generate reports and insights from your test data
Improve test cases with AI-powered suggestions and automated fixes

All through natural language commands in AI assistants!

⬆️ Back to top

🧠 Intelligent Rules System

What Makes This Tool Special

Our MCP server includes a sophisticated 3-tier rules system that transforms how you work with test cases:

🎯 Test Case Review Rules (`test_case_review_rules.md`)

Purpose: Core quality standards and writing guidelines
What it does: Defines fundamental principles for writing high-quality test cases
Key areas: Independence, single responsibility, comprehensive preconditions, complete step coverage
Used by: adv_validate_test_case and adv_improve_test_case tools

✅ Test Case Analysis Checkpoints (`test_case_analysis_checkpoints.md`)

Purpose: Detailed validation checklist with 100+ checkpoints
What it does: Provides granular validation criteria for thorough test case analysis
Key areas: Structure validation, automation readiness, platform considerations, quality assurance
Used by: adv_validate_test_case for comprehensive scoring and issue detection

⚙️ MCP Zebrunner Rules (`mcp-zebrunner-rules.md`)

Purpose: Technical configuration for test generation and coverage analysis
What it does: Defines framework detection patterns, code templates, and coverage thresholds
Key areas: Framework detection, test generation templates, coverage thresholds, quality standards
Used by: adv_generate_draft_test_by_key and adv_get_enhanced_test_coverage_with_rules tools

How the Rules Work Together

graph TD
    A[Test Case] --> B[adv_validate_test_case]
    B --> C[test_case_review_rules.md]
    B --> D[test_case_analysis_checkpoints.md]
    B --> E[Validation Result + Issues]
    
    E --> F[adv_improve_test_case]
    F --> G[AI-Powered Improvements]
    
    A --> H[adv_generate_draft_test_by_key]
    H --> I[mcp-zebrunner-rules.md]
    H --> J[Generated Test Code]
    
    A --> K[adv_get_enhanced_test_coverage_with_rules]
    K --> I
    K --> L[Coverage Analysis + Rules Validation]

Why This Matters

Consistency: All team members follow the same quality standards
Automation: Reduce manual review time with automated validation
Learning: New team members learn best practices through AI feedback
Customization: Adapt rules to your project's specific needs
Continuous Improvement: AI suggests improvements based on proven patterns

Customizing Rules for Your Project

You can customize any of the three rules files:

bash

# Copy default rules to customize
cp test_case_review_rules.md my-project-review-rules.md
cp test_case_analysis_checkpoints.md my-project-checkpoints.md
cp mcp-zebrunner-rules.md my-project-technical-rules.md

# Use custom rules in validation
"Validate test case PROJ-123 using custom rules from my-project-review-rules.md"

Example customizations:

Mobile projects: Add mobile-specific validation rules
API projects: Focus on API testing patterns and data validation
Different frameworks: Customize code generation templates
Company standards: Align with your organization's testing guidelines

⬆️ Back to top

📋 Prerequisites

What you need to know

Basic command line usage (opening terminal, running commands)
Your Zebrunner credentials (login and API token)
Basic understanding of test management (test cases, test suites)

Software requirements

Node.js 18 or newer - Download here
npm (comes with Node.js)
Access to a Zebrunner instance with API credentials

How to check if you have Node.js

Open your terminal/command prompt and run:

bash

node --version
npm --version

If you see version numbers, you're ready to go!

⬆️ Back to top

🚀 Quick Start Guide

💡 Want more detailed instructions? Check out our More Detailed Step-by-step Install Guide with troubleshooting tips and platform-specific instructions.

Step 1: Get the code

Choose one of these methods:

Option A: Clone from repository (recommended)

bash

git clone https://github.com/maksimsarychau/mcp-zebrunner.git
cd mcp-zebrunner

Option B: Download and extract

Download the project files and extract them to a folder.

Step 2: Install dependencies

bash

npm install

Step 3: Configure your Zebrunner connection

Create a .env file in the project folder with your Zebrunner details:

env

# Your Zebrunner instance URL (without trailing slash)
ZEBRUNNER_URL=https://your-company.zebrunner.com/api/public/v1

# Your Zebrunner login (usually your email)
ZEBRUNNER_LOGIN=your.email@company.com

# Your Zebrunner API token (get this from your Zebrunner profile)
ZEBRUNNER_TOKEN=your_api_token_here

# Optional: Enable debug logging (default: false)
DEBUG=false

# Optional: Enable intelligent rules system (auto-detected if rules file exists)
ENABLE_RULES_ENGINE=true

How to get your Zebrunner API token:

Log into your Zebrunner instance
Go to your profile settings
Find the "API Access" section
Generate a new API token
Copy the token to your .env file

Step 4: Build the project

bash

npm run build

Step 5: Test your connection

bash

npm run test:health

If you see "✅ Health check completed", you're ready to go!

🔄 Updating to New Version

Check current version

bash

# Check your current version
npm run version
# or manually check package.json
cat package.json | grep '"version"'

Update steps

bash

# 1. Pull latest changes from master branch
git pull origin master

# 2. Install any new dependencies
npm install

# 3. Rebuild the project
npm run build

# 4. Test your connection (requires valid .env file)
npm run test:health

Important Notes:

✅ Your .env file must be properly configured for the health check to work
✅ Restart Claude Desktop/Code after updating to reload the MCP server
✅ Check release notes for any breaking changes before updating

If the health check fails, verify your .env configuration and Zebrunner credentials.

⬆️ Back to top

🔧 Usage Methods

Method 1: Use with Claude Desktop/Code (Recommended)

Add this configuration to your Claude Desktop or Claude Code settings. Important: You must use the full absolute path to your project folder.

json

{
  "mcpServers": {
    "mcp-zebrunner": {
      "command": "node",
      "args": ["/full/absolute/path/to/mcp-zebrunner/dist/server.js"],
      "env": {
        "ZEBRUNNER_URL": "https://your-company.zebrunner.com/api/public/v1",
        "ZEBRUNNER_LOGIN": "your.email@company.com",
        "ZEBRUNNER_TOKEN": "your_api_token_here",
        "DEBUG": "false",
        "ENABLE_RULES_ENGINE": "true",
        "DEFAULT_PAGE_SIZE": "100",
        "MAX_PAGE_SIZE": "100"
      }
    }
  }
}

Example paths:

Windows: C:\\Users\\YourName\\Projects\\mcp-zebrunner\\dist\\server.js
macOS/Linux: /Users/YourName/Projects/mcp-zebrunner/dist/server.js

Alternative: Command Line Integration (Claude Code)

You can also add the server using the command line:

bash

claude mcp add mcp-zebrunner \
  --env ZEBRUNNER_URL="https://your-company.zebrunner.com/api/public/v1" \
  --env ZEBRUNNER_LOGIN="your.email@company.com" \
  --env ZEBRUNNER_TOKEN="your_api_token_here" \
  --env DEBUG="false" \
  --env ENABLE_RULES_ENGINE="true" \
  -- node /full/absolute/path/to/mcp-zebrunner/dist/server.js

Important: Replace /full/absolute/path/to/mcp-zebrunner/ with the actual full path to your project folder.

Method 2: Run as standalone server

Development mode (with auto-reload)

bash

npm run dev

Production mode

bash

npm start

Method 3: Smart URL-Based Analysis 🚀

NEW in v5.4.1+: Claude can automatically detect Zebrunner URLs and analyze them with optimal settings!

Just paste a Zebrunner URL in your conversation, and Claude will automatically:

Parse the URL to extract project, launch, and test IDs
Call the appropriate analysis tool
Use recommended settings (videos, screenshots, AI analysis enabled)

📋 Supported URL Patterns

1. Test Analysis URLs

code

https://your-workspace.zebrunner.com/projects/PROJECT/automation-launches/LAUNCH_ID/tests/TEST_ID

What happens:

Claude automatically calls adv_analyze_test_failure
Extracts: projectKey, testRunId (launch ID), testId
Enables: includeVideo: true, analyzeScreenshotsWithAI: true, all diagnostics

Example:

code

User: "Analyze https://your-workspace.zebrunner.com/projects/MCP/automation-launches/120911/tests/5455386"

Claude automatically calls:
{
  projectKey: "MCP",
  testRunId: 120911,
  testId: 5455386,
  includeVideo: true,
  analyzeScreenshotsWithAI: true,
  includeLogs: true,
  includeScreenshots: true,
  analyzeSimilarFailures: true,
  screenshotAnalysisType: "detailed",
  format: "detailed"
}

2. Launch Analysis URLs

code

https://your-workspace.zebrunner.com/projects/PROJECT/automation-launches/LAUNCH_ID

What happens:

Claude automatically calls adv_detailed_analyze_launch_failures
Extracts: projectKey, testRunId (launch ID)
Enables: includeScreenshotAnalysis: true, comprehensive analysis

Example:

code

User: "Analyze https://your-workspace.zebrunner.com/projects/MCP/automation-launches/120911"

Claude automatically calls:
{
  projectKey: "MCP",
  testRunId: 120911,
  filterType: "without_issues",
  includeScreenshotAnalysis: true,
  screenshotAnalysisType: "detailed",
  format: "summary",
  executionMode: "sequential"
}

✨ Advanced Usage

Override Default Settings

Claude understands natural language overrides:

code

User: "Analyze https://...url... but without screenshots"
→ Claude sets: analyzeScreenshotsWithAI: false

User: "Analyze https://...url... in jira format"
→ Claude sets: format: "jira"

User: "Quick analysis of https://...url..."
→ Claude sets: format: "summary", screenshotAnalysisType: "basic"

Multiple URLs

Analyze multiple tests/launches in one request:

code

User: "Compare these failures:
https://your-workspace.zebrunner.com/projects/MCP/automation-launches/120911/tests/5455386
https://your-workspace.zebrunner.com/projects/MCP/automation-launches/120911/tests/5455390"

→ Claude analyzes both sequentially and compares results

Cross-Workspace Support

⚠️ URLs from different workspaces will show a warning but still attempt analysis:

code

User: "Analyze https://other-workspace.zebrunner.com/..."
→ Claude warns: "URL is from 'other-workspace.zebrunner.com' but configured workspace is 'your-workspace.zebrunner.com'"
→ Proceeds with analysis using available credentials

📖 URL Pattern Reference

Component	Example	Extracted As	Used In Tool
Workspace	`your-workspace.zebrunner.com`	Validation only	N/A
Project Key	`MCP`	`projectKey`	All tools
Launch ID	`120911`	`testRunId`	All tools
Test ID	`5455386`	`testId`	`adv_analyze_test_failure` only

🎯 Why Use URL-Based Analysis?

✅ Faster: No need to manually specify IDs
✅ Convenient: Copy-paste URLs directly from Zebrunner UI
✅ Optimized: Automatic use of recommended settings
✅ Smart: Claude detects intent and adjusts parameters
✅ Flexible: Natural language overrides work seamlessly

💡 Pro Tips

Direct from Zebrunner: Copy URL directly from your browser while viewing a test/launch
Batch Analysis: Paste multiple URLs separated by newlines
Custom Settings: Add natural language instructions to override defaults
Quick Checks: URLs work great for quick "what happened here?" questions
Reports: Combine with format requests: "Generate JIRA ticket for https://...url..."

⬆️ Back to top

🤝 Dual-MCP setup (official `zebrunner` + Advanced)

Zebrunner now offers an official hosted MCP (beta) at https://{workspace}.zebrunner.com/api/mcp. It is safe to run both servers in the same Cursor / Claude session: every tool on this server is exposed under the adv_<name> prefix, so it never collides with the official tools.

Example .cursor/mcp.json:

json

{
  "mcpServers": {
    "zebrunner": {
      "url": "https://your-workspace.zebrunner.com/api/mcp",
      "headers": {
        "X-Zebrunner-Username": "your.name@company.com",
        "X-Zebrunner-Api-Token": "<your-zebrunner-api-token>"
      }
    },
    "mcp-zebrunner": {
      "command": "npx",
      "args": ["-y", "mcp-zebrunner"],
      "env": {
        "ZEBRUNNER_URL": "https://your-workspace.zebrunner.com/api/public/v1",
        "ZEBRUNNER_LOGIN": "your.name@company.com",
        "ZEBRUNNER_TOKEN": "<your-zebrunner-api-token>"
      }
    }
  }
}

Rule of thumb when both are connected:

Use `zebrunner` (official) for	Use `mcp-zebrunner` (Advanced) for
`list_projects`, shared steps, test run replace/close, custom field create	Failure forensics, runtime + flakiness analytics
Server-side `filter` DSL; file upload + screenshot content in triage	Reporting, dashboards, regression analyzers
Bulk launch/test comments, issue linking, launcher/preset CRUD, `launch_tests`	Preview/confirm TCM mutations; Jenkins Build Now / rerun failures

Inside chat, ask adv_about_mcp_tools with mode: "routing" or open the zebrunner://mcp-routing resource for the full live-generated diff and routing table.

🛠️ Available Tools

Once connected, you can use these tools through natural language in your AI assistant. This section highlights all 76 adv_* tools (see tools.json) organized by category. For the complete catalog with natural-language examples for every tool, see TOOLS_CATALOG.md.

Dashboard widgets: All 22 Zebrunner dashboard templates have MCP coverage (v9.2.5). See docs/TEST_PROMPTS.md §18 for example prompts and npm run test:api verification.

Token-efficient reads

Large TCM exports can consume significant context. Use these opt-in parameters (defaults stay backward-compatible). Full guide: docs/TOKEN_EFFICIENCY.md.

Technique	Example	When to use
`format: 'compact'`	`adv_get_all_tcm_test_cases_by_project` with `format:'compact'`	Minified JSON (~22% smaller than pretty `json`)
`detail: 'summary'`	`adv_get_test_cases_by_suite_smart` with `detail:'summary'`	After filtering — returns id, key, title, priority, automationState, webUrl only
`adv_batch_get_test_cases`	`{ case_keys: ["MCP-1","MCP-2"], detail:"summary", format:"compact" }`	Fetch a shortlist without N round-trips
`adv_generate_report` `inline: false`	Writes HTML/PNG to disk, returns paths	Huge dashboards in chat clients
`count_only: true`	Any bulk TCM/suite read	Metrics without payload
Env flags (off)	`MCP_COMPACT_DEFAULTS=true`, `MCP_SUMMARY_DEFAULTS=true`	Server-wide default flips after eval passes

Workflow: list/filter with detail:'summary' + format:'compact' → adv_get_test_case_by_key for full body (steps, preconditions) before create/update.

Example prompts for your assistant:

"List test cases in project MCP with summary detail and compact JSON."
"Fetch MCP-1 and MCP-2 in one batch call with summary and compact format."
"Generate a quality dashboard for MCP with inline false — save to disk."

Tool naming: All tools are exposed as adv_<name> (e.g. adv_get_test_case_by_key). Use these names in prompts, scripts, and when both the official and Advanced MCP are connected. Legacy short names (get_test_case_by_key, etc.) are deprecated and only registered when ZEBRUNNER_REGISTER_LEGACY_ALIASES=true.

📋 Test Case Management

Core Test Case Tools

Tool	Description	Example Usage	Best For
`adv_get_test_case_by_key`	Get detailed test case information	`"Get test case MCP-123 details"`	All roles
`adv_batch_get_test_cases`	Fetch multiple cases by key (partial success)	`"Get MCP-1 and MCP-2 with summary detail"`	All roles
`adv_get_test_cases_advanced`	Advanced filtering with automation states, dates	`"Get test cases created after 2025-01-01 with automation state 'Manual'"`	QA, SDETs
`adv_get_test_cases_by_automation_state`	Filter by specific automation states	`"Show me all 'Not Automated' test cases in project MCP"`	SDETs, Managers
`adv_get_test_case_by_title`	Search test cases by title (partial match)	`"Find test cases with title containing 'login functionality'"`	All roles
`adv_get_test_case_by_filter`	Advanced filtering by suite, dates, priority, automation state	`"Get test cases from suite 491 created after 2025-01-01 with high priority"`	QA, Managers
`adv_get_automation_states`	List available automation states	`"What automation states are available for project MCP?"`	All roles
`adv_get_automation_priorities`	List available priorities with IDs	`"Show me all priority levels for project MCP"`	All roles

Batch Test Case Operations

Tool	Description	Example Usage	Best For
`adv_get_all_tcm_test_cases_by_project`	Get ALL test cases (handles pagination)	`"Get all test cases for project MCP"`	Managers, Leads
`adv_get_all_tcm_test_cases_with_root_suite_id`	All test cases with hierarchy info	`"Get all test cases with their root suite information"`	Analysts
`adv_get_test_cases_by_suite_smart`	Smart suite test case retrieval with root/child auto-detection	`"Get test cases from suite 18824 in project MCP using smart mode"`	QA, Analysts

Test Case Change History

Most test case tools support optional change history enrichment — fetching the audit log of modifications for each test case. This is useful for understanding when steps were changed, when automation state transitioned, or when a test case was deprecated.

Parameter	Type	Default	Description
`include_history`	boolean	`false`	Attach a `history` array of parsed change entries to each test case
`history_filter`	`steps_only`	`events_only`	`all`
`history_limit`	number (1–100)	`20`	Max history entries per test case

Supported on: adv_get_test_case_by_key, adv_get_test_cases_advanced, adv_get_test_cases_by_automation_state, adv_get_test_case_by_title, adv_get_test_case_by_filter, adv_get_all_tcm_test_cases_by_project, adv_get_test_cases_by_suite_smart

Example prompts:

"Get test case MCP-29 with change history" → sets include_history=true
"Show me MCP-29 history, events only" → sets include_history=true, history_filter='events_only'
"Get all automated test cases with their last 5 changes" → sets include_history=true, history_limit=5

Detected events: became_automated, became_manual, became_deprecated, became_undeprecated, steps_changed, preconditions_changed, postconditions_changed, and dynamically generated became_<state_name> for any project-specific automation state.

🌳 Test Suite Hierarchy & Organization

Suite Management

Tool	Description	Example Usage	Best For
`adv_list_test_suites`	List suites with pagination	`"List test suites for project MCP"`	All roles
`adv_get_suite_hierarchy`	Hierarchical tree view	`"Show me the hierarchy of test suites with depth 3"`	Managers, QA
`adv_get_root_suites`	Get top-level suites	`"Show me all root suites for project MCP"`	Managers
`adv_get_all_subsuites`	Get all child suites	`"Get all subsuites from root suite 18697"`	QA, Analysts

Suite Analysis Tools

Tool	Description	Example Usage	Best For
`adv_get_tcm_suite_by_id`	Get suite by ID (simple: fast direct API, full: hierarchy-enriched)	`"Show me suite 20421 in project MCP"`	All roles
`adv_get_tcm_test_suites_by_project`	Comprehensive suite listing	`"Get all suites for project MCP with hierarchy"`	Managers
`adv_get_all_tcm_test_case_suites_by_project`	Get all TCM test case suites with pagination	`"Get all TCM test case suites for project MCP"`	Managers, Analysts
`adv_get_root_id_by_suite_id`	Find root suite for any suite	`"What's the root suite for suite 12345?"`	Analysts

🔧 Mutation Tools

Safety Model: Every mutation tool follows a two-call confirmation gate. The first call returns a preview; only after user approval should confirm: true be passed to execute the mutation. All mutations are audit-logged to ~/.mcp-zebrunner-audit.jsonl. Use dry_run: true for raw payload inspection.

Next-step steering (v7.2.2): After every successful mutation, the server appends a Tip: block guiding the LLM to the most useful next action (e.g., "validate quality", "publish the draft", "populate the test run"). Hints are conditional -- they are suppressed when redundant. For example, the quality-check hint is omitted if review: true was already used. Created test cases are always forced to draft=true, and the hint always reminds the LLM to publish via adv_update_test_case. This approach is inspired by the Strands Agents steering pattern and delivers just-in-time guidance without bloating system prompts.

Suite Mutations

Tool	Description	Example Usage	Best For
`adv_create_test_suite`	Create a new Test Suite	`"Create root suite 'Payments' in project MCP"`	QA, Managers
`adv_update_test_suite`	Update an existing Test Suite (full PUT)	`"Rename suite 18697 to 'Login & Registration'"`	QA, Managers

Test Case Mutations

Tool	Description	Example Usage	Best For
`adv_create_test_case`	Create a new Test Case with runtime validation of priorities, automation states, and custom fields. Accepts `{file_path}` in attachments. Optional `source_case_key` to pre-populate from an existing test case.	`"Create test case 'Verify login' in suite 17470 for project MCP"`	QA, SDETs
`adv_update_test_case`	Partially update a Test Case by ID or key (PATCH). Accepts `{file_path}` in attachments for local file upload.	`"Attach /Users/me/screenshot.png to test case MCP-42"`	QA, SDETs

🔍 Test Coverage & Analysis

Test Impact (PR / code changes) (v9.2.8)

Tool	Description	Example Usage	Best For
`adv_analyze_test_impact`	Rank Zebrunner cases affected by code changes from compact semantic context	`"Analyze test impact for diary edit + serving size changes on PROJ2"`	Developers, SDETs

Use the /test-impact MCP prompt (optional pr_url) for guided workflow. See TEST_IMPACT_WORKFLOW.md. Configure repositoryProjectMap via .env.example.

Coverage Analysis

Tool	Description	Example Usage	Best For
`adv_get_test_coverage_by_test_case_steps_by_key`	Analyze implementation coverage	`"Analyze coverage for MCP-123 against this code: [paste code]"`	Developers, SDETs
`adv_get_enhanced_test_coverage_with_rules`	Rules-based coverage analysis	`"Enhanced coverage analysis for MCP-123 with framework detection"`	SDETs, Leads

Duplicate Analysis

Tool	Description	Example Usage	Best For
`adv_analyze_test_cases_duplicates`	Find and group similar test cases by step similarity	`"Analyze suite 12345 for duplicates with 80% similarity threshold"`	QA Managers, SDETs
`adv_analyze_test_cases_duplicates_semantic`	Advanced semantic analysis with LLM-powered step clustering	`"Semantic analysis of suite 12345 with step clustering and medoid selection"`	Senior QA, Test Architects

🔗 Clickable Links Feature: Both duplicate analysis tools support clickable links to Zebrunner web UI:

Add include_clickable_links: true to make test case keys clickable in markdown output
JSON/DTO formats automatically include webUrl fields when enabled
Links are generated from your ZEBRUNNER_URL environment variable
Example: "Analyze suite 17585 for duplicates with clickable links enabled"

🧪 Test Code Generation & Validation

AI-Powered Tools

Tool	Description	Example Usage	Best For
`adv_generate_draft_test_by_key`	Generate test code with framework detection	`"Generate Java/Carina test for MCP-123 based on this implementation"`	SDETs, Developers
`adv_validate_test_case`	Quality validation with improvement	`"Validate test case MCP-123 and suggest improvements"`	QA, Managers
`adv_improve_test_case`	Dedicated improvement tool	`"Improve test case MCP-123 with specific suggestions"`	QA, SDETs

🚀 Launch & Execution Management

Launch Operations ⭐ Essential for Managers

Tool	Description	Example Usage	Best For
`adv_get_launch_details`	Comprehensive launch information; optional `includeJobParameters` for Jenkins Build Now discovery	`"Get launch details for launch 118685 with job parameters"`	Managers, Leads, SDETs
`adv_rerun_launch_failures`	🆕 v9.1.0 Rerun failed/aborted tests for one or many launches (preview/confirm)	`"Rerun failures for launch 132522 in project android"`	Managers, SDETs
`adv_start_launch`	🆕 v9.1.0 Trigger Jenkins Build Now (not Launch Launchers); preview/confirm	`"Build now regression for android milestone 26.19.0 build 50977"`	Managers, SDETs
`adv_get_launch_summary`	Quick launch overview	`"Show me summary for launch 118685"`	Managers
`adv_get_all_launches_for_project`	List individual launch executions with pagination	`"List launches for project MCP from last month"`	Managers, Leads
`adv_get_all_launches_with_filter`	Search launches by milestone/build/name	`"Find launches for milestone 2.1.0 and build 'mcp-app-2.1.0'"`	Managers, Leads
`adv_generate_weekly_regression_stability_report`	Weekly regression stability report with WoW delta, linked issues, and strict Jira-ready output. Supports launch list or build-based auto-discovery (version-segment build lookup with `launch.build` validation when needed).	`"Weekly stability report for MCP: (120906 vs 120814), (120901 vs 120809)"` or `"Weekly stability report for builds 9117 vs 48886"`	Managers, Leads
`adv_analyze_regression_runtime`	Regression Runtime Efficiency — per-launch elapsed time, attempt/re-run breakdown, configurable duration classification (Short/Medium/Long), dual metrics for both Tests and Test Cases (Average Runtime, WRI), duration distribution with test case counts, and baseline comparison with delta tracking.	`"Analyze regression runtime for the iOS project on the latest milestone. Show WRI and WRI per test case."` or `"Compare runtime for latest vs previous milestone"`	Managers, Leads, SDETs

adv_analyze_regression_runtime — Usage Examples:

"Analyze regression runtime for the iOS project on the latest milestone. Show both average runtime per test and per test case, plus WRI and WRI per test case."

"Run regression runtime analysis for all three projects on their latest milestones. Compare how many test cases fall into Short vs Medium vs Long buckets per team."

"Analyze regression runtime for the Android project, latest vs previous milestone. Show WRI and WRI per test case for both. Has efficiency improved or degraded?"

"Analyze regression runtime with medium_threshold_seconds: 120 and long_threshold_seconds: 300. Show which tests fall into each bucket."

"What is the average time cost per test case in each duration bucket? Are long-running tests covering proportionally more test cases?"

📊 Reporting & Analytics

Test Failure Analysis 🆕 Game Changer

Tool	Description	Example Usage	Best For
`adv_analyze_test_failure`	Deep forensic analysis of failed tests with logs, screenshots, error classification, and recommendations. NEW in v5.11.0: Compare with last passed execution! Shows what changed (logs, duration, environment). Also: `format: 'jira'` generates ready-to-paste Jira tickets with auto-priority, labels, and clickable 🎥 video links!	`"Analyze test failure 5451420 in launch 120806 and compare with last passed execution"`	QA Engineers, SDETs, Managers
`adv_get_test_execution_history`	🆕 NEW in v5.11.0! Track test execution trends across launches. View pass/fail history, find last passed execution, calculate pass rate. Critical Detection: Highlights when test failed in all recent runs!	`"Show execution history for test 5478492"` or `"Has test 5478492 been failing consistently?"`	QA Engineers, SDETs, Managers
`adv_detailed_analyze_launch_failures`	🚀 Enhanced v4.12.1 Analyze failures WITHOUT linked issues with Claude-level intelligence + Jira format support. Auto-deep-dive with executive summary, timeline, patterns, priorities. NEW: Generate Jira-ready tickets for entire launches!	`"Analyze failures in launch 120806"` or with `format: 'jira'`	QA Managers, SDETs, Team Leads

✅ FIXED in v5.2.4! Improved Reliability & Video Links

🎥 Video URLs fixed: Now uses test-sessions API (/api/reporting/v1/launches/{id}/test-sessions) for reliable video artifact extraction

🛡️ Comprehensive error handling: Gracefully handles missing screenshots/logs (returns empty arrays instead of throwing)

🚫 No more "no result received" errors: All API calls have proper try-catch blocks with fallbacks

🐛 Better debugging: Enhanced logging when debug: true is enabled in config

📊 Schema updates: Supports both old and new API structures for backward compatibility

🎫 NEW in v4.12.1! Jira-Ready Ticket Format

Use format: 'jira' to generate ready-to-paste Jira tickets

Auto-calculated priority based on stability and impact

Smart labels: test-automation, locator-issue, flaky-test, etc.

Complete Jira markup: Tables, panels, code blocks, clickable links

🎥 Prominent video links: Beautiful panels + links section

Copy-paste ready: No manual formatting needed

Saves 5-10 minutes per ticket with consistent quality

🧠 Enhanced in v4.11.1! adv_detailed_analyze_launch_failures provides automatic deep synthesis like Claude would manually provide:

🎯 Executive Summary: Key findings, patterns, and stability indicators

📅 Timeline Analysis: When failures first appeared, progression tracking

🔬 Pattern Analysis: Groups by root cause with affected tests and stability %

🎯 Priority-Based Recommendations: 🔴 HIGH / 🟡 MEDIUM / 🟢 LOW with impact analysis

📋 Enhanced Test Details: Full error messages, stack traces, timestamps

❓ Smart Follow-up Questions: Guides next investigation steps

Smart filtering: Analyzes only tests WITHOUT linked issues by default

Optional AI screenshot analysis for all tests

No manual follow-up needed - get complete picture in one call!

🆕 NEW in v5.11.0! Test Execution History & Comparison

📊 Track execution trends: View pass/fail history across launches with adv_get_test_execution_history

🔄 Compare with last passed: New compareWithLastPassed parameter in adv_analyze_test_failure

Compare logs (new errors detection)

Compare duration (performance regression)

Compare environment (device/platform changes)

Compare screenshots (visual differences)

⚠️ Critical detection: Automatically highlights when test failed in all recent executions

🎯 Regression analysis: See exactly what changed between passed and failed runs

📈 Pass rate metrics: Calculate test stability over time

See TOOLS_CATALOG.md for example prompts!

Screenshot Analysis & Visual Forensics 🎯 Enhanced in v4.11.0

Tool	Description	Example Usage	Best For
`adv_download_test_screenshot`	Download protected screenshots from Zebrunner with authentication	`"Download screenshot from https://your-workspace.zebrunner.com/files/abc123 for test 5451420"`	QA Engineers, Automation Engineers
`adv_analyze_screenshot`	Visual analysis with OCR, UI detection, and Claude Vision	`"Analyze screenshot https://your-workspace.zebrunner.com/files/abc123 with OCR and detailed analysis"`	QA Engineers, SDETs, Developers

📸 Enhanced! Screenshot analysis now integrated directly into adv_analyze_test_failure and analyze_launch_failures - no need to call separately! See Screenshot Analysis Guide for details.

Platform & Results Analysis ⭐ Critical for Management

Tool	Description	Example Usage	Best For
`adv_get_platform_results_by_period`	Aggregated test results, pass rate, and statistics for a project over a time period	`"Get results for MCP during last 7 days"` or `"Show pass rate for MCP"`	Managers, Leads
`adv_get_top_bugs`	Most frequent defects	`"Show me top 10 bugs from last week"`	Managers, Developers
`adv_get_bug_review`	Detailed bug review with failure analysis, priority breakdown, and automatic detail fetching	`"Get bug review with full failure details for top 10 bugs"`	Managers, QA, Developers
`adv_get_bug_failure_info`	Comprehensive failure info by hashcode (alternative to auto-fetch)	`"Get failure info for hashcode 1051677506"`	Developers, SDETs
`adv_get_project_milestones`	Available milestones	`"Get all milestones for project MCP"`	Managers, PMs

Period behavior for reporting widgets: period is passed to Zebrunner widgets as-is (for example Today, Month, Last 30 Days). If a selected widget does not support a specific period label, the API will return an error.

Project Discovery

Tool	Description	Example Usage	Best For
`adv_get_available_projects`	Discover all accessible projects	`"What projects can I access?"`	All roles
`adv_test_reporting_connection`	Test API connectivity	`"Test my connection to Zebrunner"`	All roles
`adv_about_mcp_tools`	Summarize tools, prompts, resources, or show session metrics. Modes: summary, tool, prompts, resources, metrics	`"Using Zebrunner MCP make a summary of all tools with examples"` or `"Show me tool usage metrics for this session"`	All roles

🏃 Test Run Management

Public API Test Runs ⭐ Powerful for Analysis

Tool	Description	Example Usage	Best For
`adv_list_test_runs`	Advanced test run filtering	`"Get test runs from last 30 days with status 'FAILED'"`	Managers, SDETs
`adv_get_test_run_by_id`	Detailed test run information	`"Get details for test run 12345"`	Managers, QA
`adv_list_test_run_test_cases`	Test cases in a specific run	`"Show me all test cases in test run 12345"`	QA, Analysts

Configuration Management

Tool	Description	Example Usage	Best For
`adv_get_test_run_result_statuses`	Available result statuses	`"What result statuses are configured for project MCP?"`	QA, SDETs
`adv_get_test_run_configuration_groups`	Configuration options	`"Show me configuration groups for project MCP"`	SDETs, Leads

📎 MCP Resources & Prompts (NEW)

Full guide: docs/RESOURCES_AND_PROMPTS.md — detailed usage, examples, reference tables, and contributor guide.

In addition to tools, the server provides 15 resources and 22 MCP prompts (/pass-rate, /jira-automation-plan, etc.) that improve discoverability and automate complex workflows.

Resources — `@` Context Injection

Resources are read-only reference data you attach to your conversation via the @ menu. They help the AI use exact parameter values instead of guessing.

Resource	What it provides
`@zebrunner://reports/types`	6 report types with params, defaults, and examples
`@zebrunner://periods`	12 valid time period values (case-sensitive)
`@zebrunner://charts`	Chart formats, types, and 17 supported tools
`@zebrunner://formats`	5 output format families with valid values
`@zebrunner://projects`	All accessible projects with keys and IDs
`@zebrunner://projects/{key}/suites`	Root test suites for a project
`@zebrunner://projects/{key}/suite-hierarchy`	Full suite tree with parent-child relationships
`@zebrunner://projects/{key}/automation-states`	Automation state names and IDs
`@zebrunner://projects/{key}/priorities`	Priority levels and IDs
`@zebrunner://projects/{key}/milestones`	Active and completed milestones
`@zebrunner://projects/{key}/result-statuses`	Test run result statuses
`@zebrunner://projects/{key}/configuration-groups`	Test run config groups and options
`@zebrunner://projects/{key}/fields`	System and custom field definitions

Quick example:

code

@ zebrunner://reports/types
@ zebrunner://projects
Generate an executive dashboard for all starred projects.

Prompts — `/` Workflow Commands

Prompts are pre-built workflow instructions triggered via the / command menu. Each prompt guides the AI through a tested multi-tool orchestration.

Prompt	Parameters	What it does
`/pass-rate`	`projects`	Cross-platform pass rate with target comparison
`/runtime-efficiency`	`projects`	Runtime metrics with milestone delta
`/automation-coverage`	`projects`	7-metric coverage + automation intake rate
`/executive-dashboard`	`projects`	5-section standup-ready dashboard
`/release-readiness`	`project`, `milestone?`	Go/No-Go assessment with evidence
`/suite-coverage`	`projects`	Per-suite coverage tables (TOTAL + TOTAL REGRESSION)
`/regression-summary`	`project`, `milestone?`, `build?`	Regression results overview, new bugs, top bugs, slowest tests
`/review-test-case`	`case_key`	Validate + improve a test case
`/launch-triage`	`project`	Post-regression failure analysis
`/relaunch-regression-failures`	`projects`, `milestone?`, `build?`, `period?`	🆕 v9.1.0 Discover failed launches and batch-rerun failures
`/feature-scoped-launch`	`project`, `feature`, `suite_name?`, `build?`	🆕 v9.1.0 Feature keyword → test_run_rules → Build Now per root suite
`/flaky-review`	`project`	Flaky test detection + stabilization plan
`/find-duplicates`	`project`, `suite_id?`	Structural + semantic duplicate analysis
`/daily-qa-standup`	`projects`	Daily standup summary with action items
`/automation-gaps`	`projects`	Automation backlog prioritization
`/project-overview`	`project`	Comprehensive project health card
`/session-metrics`	(none)	Show tool usage stats for the current session

Quick example:

code

/executive-dashboard
  projects: android,ios,web

⬆️ Back to top

🎯 Management-Focused Quick Commands

📈 Daily Standup Reports

bash

# Get yesterday's results
"Get platform results for last 7 days for project MCP"

# Check recent failures  
"Show me top 5 bugs from last week"

# Review recent launches
"Get all launches for project MCP from last 3 days"

🔍 Test Suite Optimization

bash

# Basic duplicate analysis
"Analyze suite 12345 for duplicates with 80% similarity threshold"

# Advanced semantic analysis with step clustering
"Semantic analysis of suite 12345 with 85% step clustering and medoid selection"

# Analyze specific test cases for duplicates
"Analyze test cases MCP-123, MCP-124, MCP-125 for duplicates"

# Project-wide duplicate analysis (use with caution - large datasets)
"Analyze project MCP for test case duplicates with 85% similarity"

# Get detailed similarity matrix with pattern types
"Analyze suite 12345 for duplicates with similarity matrix included"

# Two-phase clustering with semantic insights
"Semantic duplicate analysis with step clustering threshold 90% and insights enabled"

# Enable clickable links for easy navigation
"Analyze suite 17585 for duplicates with clickable links enabled"

📊 Weekly Management Reports

bash

# Comprehensive project health
"Get all launches for project MCP with milestone filter"

# Platform performance analysis
"Get iOS and Android test results for the last month"

# Quality metrics
"Get all test cases by automation state for project MCP"

🎯 Milestone & Release Planning

bash

# Milestone tracking
"Get project milestones for MCP with completion status"

# Build-specific results
"Get launches for build 'mcp-app-2.1.0-release' and milestone '2.1.0'"

# Release readiness
"Get automation readiness for all test cases in project MCP"

🐞 Issue Analysis & Troubleshooting

bash

# Bug analysis
"Show me top 10 most frequent bugs with issue links"

# Failure investigation
"Get test run 12345 details with all test cases"

# Platform-specific issues
"Get Android test results for last 7 days with failure analysis"

⬆️ Back to top

🎭 Role-Specific Prompts & Workflows

👩‍💻 Manual QA Engineers

Daily Test Case Review

code

"Get test case MCP-45 details and validate its quality"
"Show me all test cases in suite 18708 that need improvement"
"Validate test case MCP-67 and suggest specific improvements"
"Find test cases with title containing 'login' to review authentication tests"
"Get test cases from suite 491 with high priority for today's testing"

Test Case Creation & Improvement

code

"I'm writing a test case for login functionality. What should I include based on our quality standards?"
"Improve test case MCP-89 - it's missing some preconditions"
"Check if test case MCP-12 is ready for manual execution"

Test Suite Organization

code

"Show me the hierarchy of test suites for project MYAPP to understand the structure"
"Get all subsuites from Authentication suite to review test coverage"
"List test cases in suite 18708 and identify which ones need validation"
"Find test cases with title containing 'payment' to organize payment testing"
"Get all high priority test cases from suite 491 for release testing"

Coverage Analysis

code

"I executed test case MCP-34 manually. Here's what I did: [paste your execution notes]. Analyze coverage against the documented steps."
"Compare test case MCP-56 with this manual testing session: [paste session details]"

🤖 Test Automation Engineers & SDETs

Automation Readiness Assessment

code

"Validate test case MCP-78 for automation readiness"
"Get all test cases in suite 18708 and identify which ones are ready for automation"
"Check test case MCP-23 - does it have clear, unambiguous steps for automation?"
"Find test cases with title containing 'API' to prioritize API automation"
"Get automation priorities to understand which test cases to automate first"
"Get test cases from suite 491 with 'Not Automated' state for automation planning"

Test Code Generation

code

"Generate Java/Carina test code for MCP-45 based on this existing framework: [paste framework code]"
"Create JavaScript/Jest test for MCP-67 using this test structure: [paste test example]"
"Generate Python/Pytest code for MCP-89 with these page objects: [paste page object code]"

Coverage Analysis & Validation

code

"Analyze test coverage for MCP-34 against this automated test: [paste test code]"
"Enhanced coverage analysis for MCP-56 with rules validation - here's my implementation: [paste code]"
"Compare test case MCP-78 steps with this Selenium test: [paste selenium code]"

Framework Integration

code

"Generate test code for MCP-45 using our Carina framework with these page objects: [paste existing code]"
"Create test automation for MCP-67 that integrates with this CI/CD pipeline: [paste pipeline config]"
"Generate API test for MCP-89 using this RestAssured setup: [paste API test framework]"

Batch Automation Analysis

code

"Validate all test cases in Authentication suite for automation readiness"
"Generate coverage report for all test cases in project MYAPP"
"Identify test cases in suite 18708 that have automation blockers"
"Find test cases with title containing 'regression' for automation sprint planning"
"Get test cases from suite 491 created after 2025-01-01 with high priority for next automation cycle"
"Get automation priorities and states to create automation roadmap"

👨‍💻 Developers

Test Case Understanding

code

"Get test case MCP-45 details to understand what I need to implement"
"Show me test cases related to login functionality in project MYAPP"
"Explain test case MCP-67 requirements in developer-friendly format"
"Find test cases with title containing 'authentication' for my feature development"
"Get high priority test cases from suite 491 that I need to implement"

Implementation Validation

code

"I implemented this feature: [paste code]. Analyze coverage against test case MCP-34"
"Here's my API implementation: [paste code]. Check coverage against test case MCP-56"
"Validate my UI implementation against test case MCP-78: [paste component code]"

Code Generation for Testing

code

"Generate unit tests for test case MCP-45 using Jest framework"
"Create integration tests for MCP-67 based on this API: [paste API code]"
"Generate test data setup for MCP-89 using this database schema: [paste schema]"

Bug Analysis

code

"Get test execution results for launch 118685 to understand recent failures"
"Show me top bugs from last week related to my feature area"
"Get detailed bug review for Android project from last 14 days"
"Show me comprehensive failure information for hashcode 1051677506"
"What are the top 50 bugs affecting our project this month?"
"Give me a summary of bug failures with reproduction dates from last 7 days"
"Analyze test case MCP-34 - why might it be failing in automation?"

👔 Test Managers & Team Leads

Team Quality Metrics

code

"Get quality metrics for all test cases in project MYAPP"
"Show me test cases that need improvement in suite 18708"
"Generate quality report for test cases created this month"
"Find test cases with title containing 'critical' to assess critical path quality"
"Get automation priorities to align team efforts with business priorities"
"Get test cases from suite 491 with high priority that need quality improvements"

Test Suite Analysis

code

"Show me the complete test suite hierarchy for project MYAPP"
"Analyze test coverage across all suites in project MYAPP"
"Get automation readiness status for all test cases in Authentication suite"

Team Performance & Planning

code

"Get test execution results by platform for the last 30 days"
"Show me top 10 most frequent bugs to prioritize fixes"
"Analyze test case quality trends in project MYAPP"
"Get all launches for project MYAPP from last 30 days with milestone tracking"
"Show me platform results for last 7 days to track team performance"
"Get test runs with status 'FAILED' from last week for team retrospective"

Process Improvement

code

"Validate all test cases in suite 18708 to identify common quality issues"
"Generate improvement recommendations for test cases created by junior team members"
"Analyze which test cases are consistently failing automation"
"Get top 10 bugs from last month to identify process improvements"
"Show me test runs with detailed failure analysis for process optimization"
"Get automation readiness metrics across all test cases"
"Find test cases with title containing 'flaky' to address test stability"
"Get test cases from suite 491 with medium priority that could be automated"
"Get automation priorities to optimize team resource allocation"

Reporting & Stakeholder Communication

code

"Generate comprehensive test coverage report for project MYAPP in markdown format"
"Get test execution summary for launch 118685 for stakeholder presentation"
"Show me test quality metrics and improvement suggestions for quarterly review"
"Get platform results by period for executive dashboard"
"Create milestone progress report with test execution data"
"Generate weekly team performance report with launch and bug metrics"

Daily Management Tasks

code

"Get all launches for project MYAPP from yesterday"
"Show me top 5 bugs from last 7 days with issue links"
"Get platform results for iOS and Android from last week"
"Check automation readiness for upcoming release milestone"
"Get test run details for failed runs from last 24 hours"
"Show me project milestones and their completion status"

🏢 Project Owners & Product Managers

Project Health Overview

code

"Get overall test coverage status for project MYAPP"
"Show me test execution results by platform for the last quarter"
"Generate project testing health report in markdown format"
"Get all launches for project MYAPP with milestone and build tracking"
"Show me platform results summary for executive review"
"Get project milestones with completion status and testing metrics"

Feature Testing Status

code

"Get test cases related to [feature name] in project MYAPP"
"Show me test execution results for [feature name] functionality"
"Analyze test coverage for [epic/story] requirements"
"Get launches filtered by milestone for feature release tracking"
"Show me test runs for specific build versions"

Quality Assurance Metrics

code

"Get quality metrics for all test cases in project MYAPP"
"Show me test case validation results and improvement areas"
"Generate testing quality report for stakeholder presentation"
"Get top bugs analysis for quality trend assessment"
"Show me automation vs manual testing ratio across the project"
"Find test cases with title containing 'smoke' to assess smoke test coverage"
"Get automation priorities to communicate testing strategy to stakeholders"
"Get test cases from suite 491 with critical priority for risk assessment"

Risk Assessment

code

"Show me top 10 most frequent bugs in project MYAPP"
"Get test cases that are not ready for automation and assess risk"
"Analyze test execution trends to identify potential quality risks"
"Get platform-specific failure rates for the last month"
"Show me test runs with high failure rates for risk mitigation"
"Get milestone-based testing progress for release risk assessment"

Planning & Resource Allocation

code

"Get automation readiness assessment for all test cases in project MYAPP"
"Show me test cases that need quality improvement and estimate effort"
"Analyze test suite structure to identify optimization opportunities"
"Get testing resource utilization by platform and time period"
"Show me milestone testing progress for sprint planning"
"Get comprehensive launch analysis for capacity planning"
"Find test cases with title containing 'performance' to plan performance testing"
"Get automation priorities to allocate automation resources effectively"
"Get test cases from suite 491 created in last month to plan review sessions"

Executive Reporting

code

"Generate executive dashboard with platform results and bug trends"
"Get quarterly testing metrics with milestone progress"
"Show me ROI analysis of automation vs manual testing efforts"
"Create board-ready testing status report with key metrics"
"Get testing velocity trends for project timeline assessment"

⬆️ Back to top

📖 Output Formats

All tools support multiple output formats:

json - Structured data (default)
markdown - Rich formatted output with sections and tables
string - Human-readable text summaries
dto - Raw data objects

Example:

code

"Get test case PROJ-123 in markdown format"
"Show me test suites as JSON"

⬆️ Back to top

⚙️ Configuration Options

Environment Variables

env

# Required (STDIO mode) / Optional (HTTP selfauth mode — see below)
ZEBRUNNER_URL=https://your-instance.zebrunner.com/api/public/v1
ZEBRUNNER_LOGIN=your.email@company.com
ZEBRUNNER_TOKEN=your_api_token

# Optional - HTTP Authentication Mode
MCP_AUTH_MODE=selfauth             # Enable per-user credential form (Mode 3)
MCP_TRANSPORT=http                 # Use HTTP transport
PORT=3000                          # HTTP server port
TOKEN_STORE_KEY=your-secret        # Encryption key for stored credentials
TOKEN_STORE_PATH=./tokens.enc      # Path for encrypted credential store

# Optional - Basic Settings
DEBUG=false                        # Enable detailed logging (default: false)
DEFAULT_PAGE_SIZE=100             # Default items per page (optional)
MAX_PAGE_SIZE=100                 # Maximum items per page (optional)

# Optional - Intelligent Rules System
ENABLE_RULES_ENGINE=true          # Enable intelligent rules (auto-detected if rules file exists)
MCP_RULES_FILE=custom-rules.md    # Custom technical rules file (optional)
MIN_COVERAGE_THRESHOLD=70         # Minimum coverage percentage (optional)
REQUIRE_UI_VALIDATION=true        # Require UI validation in tests (optional)
REQUIRE_API_VALIDATION=true       # Require API validation in tests (optional)

Instance Configuration File (`zebrunner-config.json`)

The MCP server ships with a zebrunner-config.json in the project root that contains instance-specific settings. Customize this file to adapt the server to your Zebrunner workspace. If the file is missing or contains invalid values, built-in defaults are used automatically.

json

{
  "projectAliases": {
    "web": "WEB",
    "android": "AND",
    "ios": "IOS",
    "api": "WEB"
  },
  "testConnectionProjectKey": "MCP",
  "widgetTemplates": {
    "RESULTS_BY_PLATFORM": 8,
    "TOP_BUGS": 4,
    "BUG_REVIEW": 9,
    "FAILURE_INFO": 6,
    "FAILURE_DETAILS": 10
  },
  "dashboardNames": {
    "weeklyResults": "Weekly results",
    "bugsReproRate": "Bugs repro rate"
  },
  "platformMap": {
    "web": [],
    "api": ["api"],
    "android": [],
    "ios": ["ios"]
  },
  "featureAreaKeywords": {
    "quicklog": "Search & Quick Log",
    "search": "Search & Quick Log",
    "notification": "Notifications"
  },
  "localeTestRunRules": {
    "enabled": true,
    "projectKeys": ["AND", "IOS", "WEB"],
    "enUsOnlyFeatureSuites": ["Plans", "Workout Routines", "Recipe Discovery"],
    "suiteNameMatch": "includes"
  },
  "relaunchFailures": {
    "excludeLaunchNamePatterns": ["Performance"],
    "maxLaunchesPerPlatform": 50
  }
}

Key	Description
`projectAliases`	Maps short names (`web`, `android`, `ios`, `api`, etc.) to Zebrunner project keys (`WEB`, `AND`, …). Used by reporting tools, the scaffold wizard picker, `adv_prepare_jira_automation_plan`, test-impact routing, and Jira platform inference when `platformByProjectKey` is not set.
`testConnectionProjectKey`	Project key used by the `adv_test_reporting_connection` tool when no env var is set.
`widgetTemplates`	Numeric IDs for SQL widget templates used by reporting tools. These IDs are tenant-specific — check your Zebrunner instance if reports return empty data.
`dashboardNames`	Dashboard display names used by widget SQL queries. Must match dashboard names in your Zebrunner workspace.
`platformMap`	Maps platform aliases to widget SQL `PLATFORM` filter values.
`featureAreaKeywords`	Keyword-to-label mapping used by regression stability reports to bucket test names into feature areas. Customize for your application's feature structure.
`localeTestRunRules`	Project-scoped Build Now rules — see below. Used by `adv_start_launch` when locale ≠ `en_US`.
`relaunchFailures`	Project-scoped rerun rules — see below. Used by `/relaunch-regression-failures` and referenced by `adv_rerun_launch_failures`.

Individual keys can be omitted — only the keys you include will override the defaults.

Project-specific automation rules (`localeTestRunRules` & `relaunchFailures`)

These optional blocks configure launch mutation workflows per project. They do not affect read-only tools, TCM tools, or projects outside the configured scope.

localeTestRunRules — adv_start_launch (Jenkins Build Now) when the effective locale is not en_US:

Sub-key	Description
`enabled`	Master switch. Set `false` to disable locale-based NOT_TAGS logic entirely.
`projectKeys`	Zebrunner project keys where rules apply (e.g. `["MCP", "DEF"]`). Other projects are unchanged.
`enUsOnlyFeatureSuites`	TCM feature suite names that are English-only; auto-excluded via `NOT_TAGS` in `test_run_rules` on preview.
`suiteNameMatch`	`"exact"` or `"includes"` — how suite names are matched when discovering feature suite IDs.

relaunchFailures — /relaunch-regression-failures prompt and batch rerun guidance:

Sub-key	Description
`excludeLaunchNamePatterns`	Launch names to skip when discovering failures (case-insensitive substring match). Default: `["Performance"]`.
`maxLaunchesPerPlatform`	Cap per platform in the prompt workflow (default `50`, matches `adv_rerun_launch_failures` max).

/feature-scoped-launch does not use zebrunner-config.json for Jenkins suite_path — the prompt resolves it from args, recent launches, or by asking the user.

Examples

CUSTOMER-style deployment (shipped defaults in repo zebrunner-config.json):

json

"localeTestRunRules": {
  "enabled": true,
  "projectKeys": ["MCP", "DEF", "WEB"],
  "enUsOnlyFeatureSuites": ["Plans", "Workout Routines", "Recipe Discovery"],
  "suiteNameMatch": "includes"
},
"relaunchFailures": {
  "excludeLaunchNamePatterns": ["Performance"],
  "maxLaunchesPerPlatform": 50
}

Generic / non-CUSTOMER deployment (e.g. only project MCP for demos, no locale exclusions):

json

"projectAliases": { "web": "WEB", "android": "AND", "ios": "IOS", "api": "WEB" },
"testConnectionProjectKey": "MCP",
"localeTestRunRules": { "enabled": false },
"relaunchFailures": {
  "excludeLaunchNamePatterns": [],
  "maxLaunchesPerPlatform": 50
}

Minimal override via env (Docker/K8s without mounting the file):

bash

ZEBRUNNER_CONFIG_JSON='{"localeTestRunRules":{"enabled":false},"relaunchFailures":{"excludeLaunchNamePatterns":["Benchmark"]}}'

See also: docs/RESOURCES_AND_PROMPTS.md for how prompts and tools consume these settings.

Per-User Zebrunner URL (v8.1.0+)

When running in HTTP mode with MCP_AUTH_MODE=selfauth and without setting ZEBRUNNER_URL, each user provides their own Zebrunner instance URL on the login form. This enables multi-tenant hosting where a single MCP server serves users across different Zebrunner organizations.

Login form shows a Zebrunner URL field (e.g., https://mcp.zebrunner.com)
Users can update their URL, credentials, or disconnect at /settings
Per-user URLs are stored encrypted alongside credentials in the token store
When ZEBRUNNER_URL IS set as an environment variable, the URL field is hidden and the env value is used globally (existing behavior, no change)

Rules System Configuration

The rules system automatically detects and uses rules files in your project root:

Automatic Detection

If you have a mcp-zebrunner-rules.md file in your project root, the rules engine will automatically enable itself.

Custom Rules Files

You can customize the three types of rules:

Test Case Review Rules (test_case_review_rules.md)

markdown

# Custom Test Case Review Rules

## Rule 1: Title Quality
- Titles must be descriptive and specific
- Minimum length: 10 characters
- Should not contain vague terms like "test", "check"

## Rule 2: Test Steps
- Each step must have clear action and expected result
- Steps should be numbered and sequential
- Avoid combining multiple actions in one step

Analysis Checkpoints (test_case_analysis_checkpoints.md)

markdown

# Custom Analysis Checkpoints

## Independence Assessment
- [ ] Can this test case run independently?
- [ ] Are all preconditions explicitly stated?
- [ ] No dependencies on other test cases?

## Automation Readiness
- [ ] All steps are unambiguous?
- [ ] Technical feasibility confirmed?
- [ ] Stable selectors available?

Technical Rules (mcp-zebrunner-rules.md)

markdown

# Technical Configuration

## Coverage Thresholds
- Overall Coverage: 80%
- Critical Steps: 95%
- UI Validation Steps: 85%

## Framework Detection
**Java/TestNG**:
- Keywords: @Test, TestNG, WebDriver
- File patterns: *Test.java, *Tests.java

⬆️ Back to top

🧪 Testing Your Setup

Run health checks

bash

npm run test:health

Test API connection

bash

npm run smoke

Run full test suite

bash

npm test

Run specific test types

bash

npm run test:unit           # Fast unit tests
npm run test:integration    # API integration tests
npm run test:e2e           # End-to-end tests

⬆️ Back to top

🔍 Troubleshooting

Common Issues

"Authentication failed" or 401 errors

✅ Check your ZEBRUNNER_LOGIN and ZEBRUNNER_TOKEN
✅ Verify your API token is still valid
✅ Ensure your user has proper permissions in Zebrunner

"Project not found" or 404 errors

✅ Check the project key spelling (e.g., "MYAPP", not "myapp")
✅ Verify you have access to the project in Zebrunner
✅ Some endpoints may not be available on all Zebrunner instances

"Connection timeout" errors

✅ Check your ZEBRUNNER_URL is correct
✅ Ensure your network can reach the Zebrunner instance
✅ Try increasing timeout in configuration

MCP integration not working

✅ Verify the path to dist/server.js is correct
✅ Check that the project built successfully (npm run build)
✅ Ensure environment variables are set in MCP configuration
✅ Look at Claude Desktop/Code logs for error messages

`adv_about_mcp_tools` shows "Total tools: 0"

✅ Upgrade to v9.2.9+ (embeds tool catalog in dist/ for npm/Docker installs)
✅ Rebuild after upgrade: npm run build (git clone) or reinstall the package / pull the Docker image

Rules engine not working

✅ Check that ENABLE_RULES_ENGINE=true in your .env file
✅ Verify rules files exist and have meaningful content
✅ Restart the MCP server after changing rules files
✅ Check debug logs for rules parsing errors

Debug Mode

Enable detailed logging to troubleshoot issues:

env

DEBUG=true

This will show:

API requests and responses
Error details and stack traces
Performance metrics
Feature availability
Rules parsing and validation details

Getting Help

Check the logs - Enable debug mode and look for error messages
Test your connection - Run npm run test:health
Verify your configuration - Double-check your .env file
Check Zebrunner permissions - Ensure your user has proper access
Validate rules files - Ensure rules files have meaningful content
Report issues - If you find a bug, please open an issue at https://github.com/maksimsarychau/mcp-zebrunner/issues

⬆️ Back to top

🎯 Example Workflows

Workflow 1: Test Case Review (Manual QA)

code

1. "Get test case PROJ-123 details"
2. "Validate test case PROJ-123"
3. "Improve test case PROJ-123 with specific suggestions"
4. "Check if test case PROJ-123 is ready for manual execution"

Workflow 2: Test Automation (SDET)

code

1. "Validate test case PROJ-456 for automation readiness"
2. "Generate Java/Carina test code for PROJ-456"
3. "Analyze coverage between test case and my implementation"
4. "Get automation readiness assessment"

Workflow 3: Implementation Validation (Developer)

code

1. "Get test case PROJ-789 details to understand requirements"
2. "Analyze coverage for PROJ-789 against my implementation"
3. "Generate unit tests based on test case requirements"
4. "Validate implementation completeness"

Workflow 4: Quality Management (Team Lead)

code

1. "Get quality metrics for all test cases in project MYAPP"
2. "Show me test cases that need improvement"
3. "Generate team quality report"
4. "Identify automation readiness across the project"

Workflow 5: Project Health (Product Manager)

code

1. "Get overall test coverage status for project MYAPP"
2. "Show me test execution results by platform"
3. "Generate project testing health report"
4. "Identify quality risks and improvement opportunities"

⬆️ Back to top

🔧 Advanced Features

Batch Operations

Process multiple test cases at once:

code

"Validate all test cases in suite 18708"
"Generate coverage report for all test cases in project MYAPP"
"Improve all test cases that have quality issues"

Custom Output Formats

Get data in the format you need:

code

"Get test cases as JSON for API integration"
"Show test suite hierarchy in markdown for documentation"
"Generate quality report in markdown for stakeholder presentation"

Filtering and Search

Find exactly what you need:

code

"Get test cases created after 2025-01-01"
"Find test cases with automation state 'Manual'"
"Show me test cases that are not ready for automation"

Rules-Based Analysis

Leverage intelligent validation:

code

"Validate test case PROJ-123 using custom rules from my-project-rules.md"
"Enhanced coverage analysis with framework-specific rules"
"Generate improvement suggestions based on team quality standards"

📚 Additional Documentation

📖 Tool References

TOOLS_CATALOG.md - Complete catalog of all 76 adv_* tools with natural language examples
docs/TEST_PROMPTS.md - Test prompts per tool; §18 covers all 22 dashboard widgets (MCP + API verify)
docs/archive/TCM_TAM_WIDGET_BACKLOG.md - Archived widget template ↔ MCP matrix (live: TEST_PROMPTS §18)
docs/RESOURCES_AND_PROMPTS.md - MCP Resources & Prompts — full usage guide, reference tables, and contributor guide
INSTALL-GUIDE.md - 📥 Step-by-step installation and setup guide

🧠 Intelligent Rules System

docs/INTELLIGENT_RULES_SYSTEM.md - 🧠 Complete guide to the 3-tier intelligent rules system
docs/archive/RULES_QUICK_REFERENCE.md - ⚡ Quick reference for rules system commands and configuration

📋 Rules Files (Customizable)

test_case_review_rules.md - 🎯 Core quality standards and writing guidelines
test_case_analysis_checkpoints.md - ✅ 100+ detailed validation checkpoints
mcp-zebrunner-rules.md - ⚙️ Technical configuration for test generation and coverage analysis

🔍 Specialized Guides

docs/archive/SCREENSHOT_ANALYSIS.md - 📸 Screenshot download and visual analysis guide
change-logs.md - 📝 Version history and feature updates
GitHub Release v9.1.0 - 🆕 v9.1.0 release notes — launch mutations, prompts, and config

🛠️ Feature Documentation

docs/TERMINOLOGY.md - 📖 Test vs Test Case vs Test Run vs Launch — glossary and counting rules
docs/archive/NEW_LAUNCHER_TOOL.md - Detailed information about launch and reporting tools
docs/archive/SUITE_HIERARCHY.md - Complete guide to suite hierarchy features
docs/archive/TEST_CASE_VALIDATION_IMPLEMENTATION.md - Test case validation system details
docs/archive/ENHANCED_VALIDATION_FEATURES.md - Advanced validation and improvement features

⬆️ Back to top

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes with appropriate tests
Ensure all tests pass: npm test
Submit a pull request

📄 License

License

This project is licensed under AGPL-3.0 to ensure that all improvements to the MCP server remain open-source, especially when the software is deployed as a network service.

If you modify and run the server in a way that users interact with it over a network (e.g., Claude Desktop / Cursor clients), you must make the full modified source code available to those users.

Commercial usage is allowed. For closed-source modifications or enterprise licensing, please contact the author. See LICENSE.md file for details.

🎉 You're Ready!

Once you've completed the setup:

Test your connection with npm run test:health
Configure your AI assistant with the MCP server
Start asking questions about your test cases!

Example first commands to try:

"List test suites for project [YOUR_PROJECT_KEY]"
"Get test case [YOUR_TEST_CASE_KEY] details"
"Validate test case [YOUR_TEST_CASE_KEY]"
"Show me the test suite hierarchy"

The intelligent rules system will help ensure your test cases meet quality standards and are ready for both manual execution and automation. Happy testing! 🚀

First push was: Mon Sep 22 00:54:41 2025 +0200

Install

Configuration

Environment variables

ZEBRUNNER_URLrequired

Base URL for your Zebrunner instance (e.g., https://your-instance.zebrunner.com)

ZEBRUNNER_LOGINrequired

Your Zebrunner username/login

ZEBRUNNER_TOKENrequiredsecret

Your Zebrunner API authentication token (Personal API Token from Settings → API Tokens, or refreshToken from SSO session)

TIMEOUT

API request timeout in milliseconds (default: 30000)

RETRY_ATTEMPTS

Number of retry attempts for failed API requests (default: 3)

RETRY_DELAY

Delay between retry attempts in milliseconds (default: 1000)

MAX_PAGE_SIZE

Maximum page size for paginated API requests (default: 100, max: 1000)

DEFAULT_PAGE_SIZE

Default page size for paginated API requests (default: 10)

DEBUG

Enable debug logging (default: false)

ENABLE_RULES_ENGINE

Enable the rules engine for test case validation (default: auto-detected from mcp-zebrunner-rules.md file)

STRICT_URL_VALIDATION

Enable strict URL validation for security (default: true)

SKIP_URL_VALIDATION_ON_ERROR

Skip URL validation if it fails (less secure, more permissive) (default: false)

ENABLE_RATE_LIMITING

Enable rate limiting for API calls (default: true)

MAX_REQUESTS_PER_SECOND

Maximum API requests per second (default: 5, max: 100)

RATE_LIMITING_BURST

Allow burst of API requests (default: 10, max: 200)

PORTrequired

HTTP server port (required for StreamableHTTP mode)

MCP_TRANSPORT

Transport mode: stdio, http, or auto (default: auto)

MCP_AUTH_MODE

Authentication mode: headers, oauth, or both (default: headers)

MCP_SERVER_URL

Public URL of this MCP server (for OAuth metadata)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-zebrunner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-zebrunner@9.2.1"
      ],
      "env": {
        "ZEBRUNNER_URL": "<YOUR_ZEBRUNNER_URL>",
        "ZEBRUNNER_LOGIN": "<YOUR_ZEBRUNNER_LOGIN>",
        "ZEBRUNNER_TOKEN": "<YOUR_ZEBRUNNER_TOKEN>",
        "TIMEOUT": "<YOUR_TIMEOUT>",
        "RETRY_ATTEMPTS": "<YOUR_RETRY_ATTEMPTS>",
        "RETRY_DELAY": "<YOUR_RETRY_DELAY>",
        "MAX_PAGE_SIZE": "<YOUR_MAX_PAGE_SIZE>",
        "DEFAULT_PAGE_SIZE": "<YOUR_DEFAULT_PAGE_SIZE>",
        "DEBUG": "<YOUR_DEBUG>",
        "ENABLE_RULES_ENGINE": "<YOUR_ENABLE_RULES_ENGINE>",
        "STRICT_URL_VALIDATION": "<YOUR_STRICT_URL_VALIDATION>",
        "SKIP_URL_VALIDATION_ON_ERROR": "<YOUR_SKIP_URL_VALIDATION_ON_ERROR>",
        "ENABLE_RATE_LIMITING": "<YOUR_ENABLE_RATE_LIMITING>",
        "MAX_REQUESTS_PER_SECOND": "<YOUR_MAX_REQUESTS_PER_SECOND>",
        "RATE_LIMITING_BURST": "<YOUR_RATE_LIMITING_BURST>"
      }
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Advanced Zebrunner MCP Server

🔥 Why This Server

📑 Table of Contents

🎯 What is this tool?

🧠 Intelligent Rules System

What Makes This Tool Special

🎯 Test Case Review Rules (test_case_review_rules.md)

✅ Test Case Analysis Checkpoints (test_case_analysis_checkpoints.md)

⚙️ MCP Zebrunner Rules (mcp-zebrunner-rules.md)

How the Rules Work Together

Why This Matters

Customizing Rules for Your Project

📋 Prerequisites

What you need to know

Software requirements

How to check if you have Node.js

🚀 Quick Start Guide

Step 1: Get the code

Option A: Clone from repository (recommended)

Option B: Download and extract

Step 2: Install dependencies

Step 3: Configure your Zebrunner connection

How to get your Zebrunner API token:

Step 4: Build the project

Step 5: Test your connection

🔄 Updating to New Version

Check current version

Update steps

🔧 Usage Methods

Method 1: Use with Claude Desktop/Code (Recommended)

Alternative: Command Line Integration (Claude Code)

Method 2: Run as standalone server

Development mode (with auto-reload)

Production mode

Method 3: Smart URL-Based Analysis 🚀

📋 Supported URL Patterns

✨ Advanced Usage

📖 URL Pattern Reference

🎯 Why Use URL-Based Analysis?

💡 Pro Tips

🤝 Dual-MCP setup (official zebrunner + Advanced)

🛠️ Available Tools

Token-efficient reads

📋 Test Case Management

Core Test Case Tools

Batch Test Case Operations

Test Case Change History

🌳 Test Suite Hierarchy & Organization

Suite Management

Suite Analysis Tools

🔧 Mutation Tools

Suite Mutations

Test Case Mutations

🔍 Test Coverage & Analysis

Test Impact (PR / code changes) (v9.2.8)

Coverage Analysis

Duplicate Analysis

🧪 Test Code Generation & Validation

AI-Powered Tools

🚀 Launch & Execution Management

Launch Operations ⭐ Essential for Managers

📊 Reporting & Analytics

Test Failure Analysis 🆕 Game Changer

Screenshot Analysis & Visual Forensics 🎯 Enhanced in v4.11.0

Platform & Results Analysis ⭐ Critical for Management

Project Discovery

🏃 Test Run Management

Public API Test Runs ⭐ Powerful for Analysis

Configuration Management

📎 MCP Resources & Prompts (NEW)

Resources — @ Context Injection

Prompts — / Workflow Commands

🎯 Management-Focused Quick Commands

📈 Daily Standup Reports

🔍 Test Suite Optimization

📊 Weekly Management Reports

🎯 Test Case Review Rules (`test_case_review_rules.md`)

✅ Test Case Analysis Checkpoints (`test_case_analysis_checkpoints.md`)

⚙️ MCP Zebrunner Rules (`mcp-zebrunner-rules.md`)

🤝 Dual-MCP setup (official `zebrunner` + Advanced)

Resources — `@` Context Injection

Prompts — `/` Workflow Commands

Instance Configuration File (`zebrunner-config.json`)

Project-specific automation rules (`localeTestRunRules` & `relaunchFailures`)

`adv_about_mcp_tools` shows "Total tools: 0"