Zephyr MCP Server

Model Context Protocol (MCP) server for Zephyr Scale test case management with comprehensive STEP_BY_STEP, PLAIN_TEXT, and BDD support

Remote serverstreamable-http

What is the Zephyr MCP Server?

Model Context Protocol (MCP) server for Zephyr Scale test case management with comprehensive STEP_BY_STEP, PLAIN_TEXT, and BDD support

What the server does

Model Context Protocol server for Zephyr Scale test management, supporting both Jira Cloud and Data Center. Create, read, and manage test cases through the Atlassian REST API with official API-compliant schemas. Access live test case data, example payloads, and file resources through a unified resource system.

  • ✅ Jira Cloud & Data Center Support: Seamlessly connects to both Jira Cloud (using API v2) and self-hosted Data Center instances (using API v1) with automatic configuration detection
  • ✅ Official API-Compliant Schemas: Tools and data structures match the official Zephyr Scale REST API, ensuring compatibility and reliability
  • ✅ Unified Test Case Creation: A single create_test_case tool handles all script types (BDD, Step-by-Step, Plain Text) for a simplified workflow
  • ✅ Full Test Lifecycle Management: Comprehensive tools to create, read, delete test cases, and manage test runs, executions, and folders
  • ✅ Live Templating System: Use real test cases from your Zephyr instance as templates (zephyr://testcase/KEY) to ensure consistency and correct project-specific fields
  • ✅ Unified Resource System: Access live Zephyr data, local files (file://), and built-in examples through a consistent URI-based system

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_test_caseGet detailed information about a specific test case.
create_test_caseCreate test cases with STEP_BY_STEP, PLAIN_TEXT, or BDD content.
delete_test_caseDelete a specific test case.
update_test_case_bddUpdate an existing test case with BDD content (optionally update the test case name).
create_test_runCreate a new test run.
get_test_runGet detailed information about a specific test run, including resolved status name.
update_test_runUpdate an existing test cycle — set owner, name, description, dates, or status. (Cloud only)
get_test_run_casesGet test case keys from a test run.
add_test_cases_to_runAdd test cases to an existing test run. (Cloud only)
get_test_executionGet detailed individual test execution results.
list_executions_by_cycleList all test executions for a specific test cycle with status, executor, and date. (Cloud only)
update_test_executionUpdate a test case execution's status within a cycle (Pass/Fail/etc.), add a comment, and attach bug(s) as Jira issue links. Identify the execution by execution
search_test_cases_by_folderSearch for test cases in a specific folder. Automatically paginates through all results.
search_test_runsSearch for test runs by project key and/or folder path.
get_test_cycles_for_issueGet the Zephyr test cycles linked to a Jira issue (story/epic). Resolves each cycle ID to its key (e.g. PROJ-R123) and name so you can feed it straight into lis
create_folderCreate a new folder in Zephyr Scale.
get_foldersList folders, optionally filtered by project, type, and path. When folder_path is given, returns the matching folder and its full subtree at every depth.

How to install the Zephyr MCP Server

{
  "mcpServers": {
    "zephyr-server": {
      "command": "npx",
      "args": [
        "zephyr-scale-mcp-server@latest"
      ],
      "env": {
        "ZEPHYR_BASE_URL": "https://your-company.atlassian.net",
        "ZEPHYR_API_KEY": "YOUR_ZEPHYR_API_KEY",
        "JIRA_USERNAME": "your-email@company.com",
        "JIRA_API_TOKEN": "YOUR_JIRA_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
ZEPHYR_BASE_URLDeclared in the maintainer’s client configuration.Check documentation
ZEPHYR_API_KEYDeclared in the maintainer’s client configuration.Check documentation
JIRA_USERNAMEDeclared in the maintainer’s client configuration.Yes
JIRA_API_TOKENDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Zephyr to Organization.”

Frequently asked questions

Model Context Protocol (MCP) server for Zephyr Scale test case management with comprehensive STEP_BY_STEP, PLAIN_TEXT, and BDD support Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.