Skip to the content

Capsid menu

capsid_open_pr

Open or comment on a pull request, on Capsid. Needs the write grant.

Adds, never removesReaches GitHub or Cloudflare

What it does

Open a pull request, or comment on one. Needs the write grant; a comment also needs the can_comment_pr flag.

What a client is told

The MCP hints it carries, so a client can ask before it acts (src/tool-annotations.ts).

Its 2 actions

Chosen by the action argument.

open Open a pull request.

Open a pull request in a namespace's GitHub repo. Base defaults to the repo's default branch. Needs the write grant.

Takes namespace, title, head, base, body, repo.

comment Comment on a pull request.

Merge, close or comment on an open pull request in a namespace's repo. action 'merge' uses merge_method (default 'squash') and needs the can_merge flag; with sha, it merges only if the head is still that commit and is otherwise refused with nothing merged. action 'close' closes it and needs the can_merge flag. action 'comment' posts comment and changes nothing else; it needs the can_comment_pr flag. Merge and close delete the head branch and return head_branch and head_branch_deleted, plus head_branch_note when the delete was declined: the default branch and a fork's branch are never deleted, and a failed delete does not fail the merge or close. A merge can trigger a deploy workflow. Needs the write grant.

Takes namespace, number, comment, repo.

Arguments

The arguments of capsid_open_pr
ArgumentTypeNeededWhat it is
actionone of: open, commentalwaysopen | comment.
namespacestringalways
titlestringno
headstringno
basestringno
bodystringno
repostringnoA repo label or mapped "owner/name". Defaults to the primary repo.
numberwhole numberno
commentstringnoFor action 'comment': the comment body. Required for that action and refused for the others.