Zephyr Scale MCP Server

This MCP server exposes a single tool to fetch a Zephyr Scale test case by key, returning its title, owner, priority, status, and all test steps in a readable format.

It uses Zephyr Scale REST API v2 and requires only one environment variable:

• API_KEY - your Zephyr Scale API key

Endpoints used

• GET /v2/testcases/{testCaseKey}
• GET /v2/testcases/{testCaseKey}/testscript (primary for steps)
• GET /v2/testcases/{testCaseKey}/teststeps (fallback when Zephyr returns the known 422 guidance error)

Available MCP tools

get_zephyr_test_case

• Input: { "testCaseKey": "PROJECT-T1" }
• Fetches the test case metadata and steps in parallel
• Returns a formatted summary:

Title:    Login flow validation
Owner:    abc123
Priority: High
Status:   Active

Test Steps:
----------
  Step 1: Navigate to login page
    Expected Result: Login page is displayed
  Step 2: Enter valid credentials
    Test Data:       [email protected] / password123
    Expected Result: User is redirected to dashboard

Install

npm install -g zephyr-mcp-server

Or use via npx:

API_KEY="your-zephyr-api-key" npx zephyr-mcp-server

Run locally

npm install
API_KEY="your-zephyr-api-key" npm start

Example MCP configuration

Using the globally installed binary:

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "zephyr-mcp-server",
      "env": {
        "API_KEY": "your-zephyr-api-key"
      }
    }
  }
}

Using npx:

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "npx",
      "args": ["zephyr-mcp-server"],
      "env": {
        "API_KEY": "your-zephyr-api-key"
      }
    }
  }
}