capsid_open_pr
Open or comment on a pull request, on Capsid. Needs the write grant.
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).
- Writes: some action changes state.
- Never overwrites or removes.
- A repeat can change things again.
- Reaches GitHub, Cloudflare or a live site.
Its 2 actions
Chosen by the action argument.
openOpen 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.
commentComment 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' postscommentand 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.
Arguments
| Argument | Type | Needed | What it is |
|---|---|---|---|
action | one of: open, comment | always | open | comment. |
namespace | string | always | |
title | string | no | |
head | string | no | |
base | string | no | |
body | string | no | |
repo | string | no | A repo label or mapped "owner/name". Defaults to the primary repo. |
number | whole number | no | |
comment | string | no | For action 'comment': the comment body. Required for that action and refused for the others. |