Skip to content
Shipper

shipper_stop_issue

shipper_stop_issue

Section titled “shipper_stop_issue”

Ask the current checkpoint-capable issue worker to stop after its current safe unit. This never changes operator pause or Auto-ship intent and does not wait for completion.

When to use

Section titled “When to use”

Use to ask the current registered worker to stop after its current safe unit. The call acknowledges signal registration without polling for completion and never changes operator pause or Auto-ship intent.

Behavior hints

Section titled “Behavior hints”
  • readOnlyHint: false — The tool may intentionally modify repository or workflow state.
  • 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
issueinteger | stringyes-Shipper issue reference. S# (GitHub #) accepts ordinary surrounding whitespace and requires the current mirror. Bare numbers are Shipper local IDs first; S# is accepted; gh: and # explicitly target a mapped GitHub issue; GitHub issue URLs are accepted. Responses return S# first with GitHub # second when mapped.

Output schema

Section titled “Output schema”

object

Example call

Section titled “Example call”
{
  "issue": "S#42"
}

Example result

Section titled “Example result”
{
  "status": "accepted",
  "issue": "S#42",
  "pause": { "state": "none" },
  "holder": {
    "worker_id": "<worker>",
    "session_id": "<session>",
    "surface": "mcp",
    "command": "next",
    "pid": 1234,
    "lock_acquired_at": "2026-09-04T12:00:00.000Z",
    "worker_started_at": "2026-09-04T12:00:00.000Z",
    "checkpoint": "operation-boundary",
    "checkpoint_behavior": "Stops after the current operation-boundary."
  }
}

Error modes

Section titled “Error modes”
  • Not applicable: Queued work and awaiting-answer sessions are not current stoppable workers.
  • Not stoppable: Unregistered workers receive guarded forced-Stop guidance.
  • Registration refused: A failed signal write is reported as refused, never pending.
Section titled “Related tools”