Zephyr Scale MCP Server

by vilaaboio.github.vilaabo/zephyr-scale-mcpv1.0.0

Zephyr Scale on self-hosted Jira Server/DC: test cases, cycles, executions, plans and attachments

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Zephyr Scale MCP server

claude mcp add zephyr-scale -e JIRA_BASE_URL='<jira-base-url>' -e JIRA_PAT='<jira-pat>' -e JIRA_PASSWORD='<jira-password>' -- npx -y zephyr-scale-mcp

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<jira-base-url>",
        "JIRA_PAT": "<jira-pat>",
        "JIRA_PASSWORD": "<jira-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<jira-base-url>",
        "JIRA_PAT": "<jira-pat>",
        "JIRA_PASSWORD": "<jira-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "zephyr-scale": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<jira-base-url>",
        "JIRA_PAT": "<jira-pat>",
        "JIRA_PASSWORD": "<jira-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "zephyr-scale": {
      "command": "npx",
      "args": [
        "-y",
        "zephyr-scale-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<jira-base-url>",
        "JIRA_PAT": "<jira-pat>",
        "JIRA_PASSWORD": "<jira-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
JIRA_BASE_URL	yes	—	Jira base URL without a trailing slash, e.g. https://jira.example.com
JIRA_PAT	—	yes	Jira Data Center Personal Access Token (used when JIRA_AUTH=pat, the default)
JIRA_AUTH	—	—	Authentication mode: pat (default) or basic
JIRA_USERNAME	—	—	Username for JIRA_AUTH=basic
JIRA_PASSWORD	—	yes	Password for JIRA_AUTH=basic
ZEPHYR_DEFAULT_PROJECT_KEY	—	—	Project key used when a tool is called without projectKey
ZEPHYR_ALLOW_INTERNAL_API	—	—	true registers 11 UNOFFICIAL tools backed by the internal /rest/tests/1.0 API the vendor does not support: editing a test cycle in place (rename/move, add/remove/reorder its cases), editing or DELETING individual executions, linking a cycle to a test plan, the folder tree, folder deletion, exact status names and custom field definitions
ZEPHYR_READONLY	—	—	true disables all write tools
JIRA_TLS_REJECT_UNAUTHORIZED	—	—	false allows self-signed certificates (disables TLS verification)
JIRA_TIMEOUT_MS	—	—	Timeout of a single HTTP request in milliseconds (default 30000)
JIRA_MAX_RETRIES	—	—	Retries for GET requests and for 429/503 responses, honoring Retry-After (default 2)
ZEPHYR_LOG_LEVEL	—	—	Log verbosity: debug \| info \| warn \| error (default info; all logs go to stderr)

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-31 · 2mo ago · GitHub
Latest release
2026-07-31 · 2mo ago · GitHub · v1.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-31 · 2mo ago · official registry · v1.0.0

FAQ

›How do I install the Zephyr Scale MCP server in Claude Code?

Run: claude mcp add zephyr-scale -e JIRA_BASE_URL='<jira-base-url>' -e JIRA_PAT='<jira-pat>' -e JIRA_PASSWORD='<jira-password>' -- npx -y zephyr-scale-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Zephyr Scale require an API key?

Yes. It expects JIRA_BASE_URL, JIRA_PAT, JIRA_PASSWORD, of which 2 are secrets.

›Can I use Zephyr Scale as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Zephyr Scale in the official MCP registry?

Yes, as io.github.vilaabo/zephyr-scale-mcp.