Skip to content
Shipper

shipper_merge

shipper_merge

Section titled “shipper_merge”

Run the merge queue once for shipper:ready PRs. If an issue number is provided, merges only that PR; otherwise processes all ready PRs. Always runs —once (never polls).

When to use

Section titled “When to use”

Use this when ready PRs should be processed by the merge queue once. Use shipper_get_pr_checks first when CI status is uncertain.

Behavior hints

Section titled “Behavior hints”
  • openWorldHint: true — The tool reaches GitHub or other external systems outside the MCP server.

Input schema

Section titled “Input schema”
NameTypeRequiredDefaultDescription
issueintegerno-GitHub issue number.

Example call

Section titled “Example call”
{}

Example result

Section titled “Example result”
[exit 0] shipper merge --once
--- stdout ---
Merged PR #17 for issue #42.

Error modes

Section titled “Error modes”
  • Timed out merge: [timed out] shipper merge —once
  • Failed merge: [exit ] shipper merge —once
  • Spawn failure: spawn shipper ENOENT
Section titled “Related tools”