Skip to content
Shipper

shipper_list_operator_pauses

shipper_list_operator_pauses

Section titled “shipper_list_operator_pauses”

List pending and durable operator pauses in the selected repository. Grooming sessions awaiting answers are intentionally excluded. Optional repository_path selects an existing local git checkout for this call only; omit repository_path to use the active repository. Target preparation uses that checkout’s local identity and settings without changing active server state, and successful result payloads are unchanged.

When to use

Section titled “When to use”

Omit repository_path to use the active repository, or supply a local checkout path in repository_path to select that repository for this call only. Explicit targets remain usable when active startup is degraded, do not count as active-repository work, and never change ambient server state. The successful response shape is identical for active and targeted calls. Use to discover pending and durable operator pauses in the active repository or an explicitly selected local checkout. Awaiting-answer grooming sessions are excluded; inspection or legacy reconciliation failure returns unavailable rather than a partial list.

Behavior hints

Section titled “Behavior hints”
  • readOnlyHint: true — The tool only reads state and does not intentionally modify the repository.
  • destructiveHint: false — The tool is not expected to remove or rewrite workflow artifacts.
  • idempotentHint: true — Retrying the same call is expected to be safe once the target state is reached.
  • openWorldHint: false — The tool does not reach GitHub or other external systems outside the MCP server.

Input schema

Section titled “Input schema”
NameTypeRequiredDefaultDescription
repository_pathstringno-Optional repository path to an existing local git checkout to select for this read only. Omit it to read the active repository.

Output schema

Section titled “Output schema”

object

Example call

Section titled “Example call”
{
  "repository_path": "/absolute/path/to/selected/checkout"
}

Example result

Section titled “Example result”
{
  "status": "available",
  "pauses": [
    {
      "shipper_id": "S#42",
      "github_issue_number": 2147,
      "title": "Example",
      "stage": "shipper:planned",
      "paused_at": "2026-09-04T12:00:00.000Z",
      "state": "pending"
    }
  ]
}

Error modes

Section titled “Error modes”
  • Unavailable discovery: The response is unavailable with a reason and never presents partial results as complete.
  • Invalid or unready repository target: Repository identity could not be established for . The repository has no commits. Create an initial commit. Correct this condition and retry the repository read with repository_path.
Section titled “Related tools”