Variable

Required

Default

Description

JIRA_BASE_URL

✅

—

Jira base URL, e.g. https://jira.company.com (no /rest suffix).

JIRA_PAT

one of

—

Personal Access Token → Authorization: Bearer … (recommended for DC).

JIRA_USERNAME + JIRA_PASSWORD

one of

—

Basic-auth fallback (password or API token). Used only if JIRA_PAT is empty.

ZEPHYR_API_PATH

/rest/zapi/latest

ZAPI base path on the Jira host.

ZEPHYR_TIMEOUT

30

Per-request timeout (seconds).

ZEPHYR_VERIFY_SSL

true

Verify TLS certs. Set false only for trusted internal self-signed hosts.

Tool

What it does

list_cycles

List test cycles for a project/version.

get_cycle

Get one cycle's details (id -1 = the Ad hoc cycle).

create_cycle

Create a test cycle.

update_cycle

Update a cycle's fields (id is sent in the body).

delete_cycle

Delete a cycle (async; auto-polls to completion by default).

export_cycle

Get a CSV download link for a cycle's executions.

copy_executions_to_cycle

Copy executions into a cycle (async; auto-polls to completion by default).

move_executions_to_folder

Move executions from a cycle into a folder (async; auto-polls to completion by default).

list_cycle_folders

List folders within a cycle.

create_folder

Create a folder under a cycle.

update_folder

Update a folder's name/description.

delete_folder

Delete a folder from a cycle (async; auto-polls to completion by default).

list_executions

List executions in a cycle (optionally a folder).

update_execution

Set an execution's status (PASS/FAIL/WIP/BLOCKED/…).

list_test_steps

List the test steps of a test issue.

create_test_step

Add a test step to a test issue.

list_step_results

List per-step results for an execution.

search_executions

Run a ZQL query and return matching executions.

get_execution_status_counts

Status-count rollup for a project/version (by cycle).

get_execution_status_counts_by_assignee

Per-assignee status counts for cycle(s).

list_executions_by_issue

A single test's executions across all cycles.

list_execution_defects

Defects linked to an execution.

get_tests_by_requirement

Tests covering requirement(s); flags orphans.

get_executions_by_test

Executions for a test (coverage history).

get_executions_by_defect

Executions linked to a defect.

get_defect_statistics

Per-defect execution/req/test rollups.

update_test_step

Edit a test step's action/data/result.

delete_test_step

Delete a test step.

create_execution

Schedule a test into a cycle.

add_tests_to_cycle_from_list

Bulk-add an explicit list of tests to a cycle as new UNEXECUTED executions (async).

add_tests_to_cycle_from_filter

Bulk-add tests matched by a saved ZQL filter to a cycle as new UNEXECUTED executions (async).

add_tests_to_cycle_from_cycle

Add tests from another cycle as new UNEXECUTED executions (async).

update_step_result

Set a step result's status/comment.

link_execution_defects

Link Jira defects to executions (async).

assign_execution

Assign an execution to a user.

delete_execution

Delete an execution by id.

get_job_progress (helper)

Manually poll any async job by token.

list_projects (helper)

List projects (name → id discovery).

list_versions (helper)

List a project's versions (name → id discovery).

get_zephyr_test_issue_type (helper)

Discover the Zephyr Test issue-type id per project (use case 1.1).