1. Docs
2. /
3. Tool reference
4. /
5. GitHub & Code
6. /
7. refreshPullRequestBranch

GitHub & Code

refreshPullRequestBranch

Refresh Pull Request Branch

Refresh one or many open pull requests with their base branch: GitHub's update-branch, which merges the base into the head, the rail lever that re-gates an armed set after main moves.

writeexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "refresh with main", and it calls refreshPullRequestBranch.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "owner": "<owner>",
    "pullNumbers": [
      1
    ],
    "repo": "<repo>"
  },
  "name": "refreshPullRequestBranch"
}

Arguments

• accountstringoptionalConnected GitHub login to act as. Defaults to the repo's deploy identity when it names one, else the Primary account. On a repo with a deploy identity, any other login is refused.
• ownerstringrequiredRepository owner
• pullNumbersinteger[]requiredThe pull requests to refresh, 1 to 20
• repostringrequiredRepository name

Returns

The registry does not declare a return shape.

Declared limits

• owner: minimum length 1
• pullNumbers: minimum items 1
• pullNumbers: maximum items 20
• repo: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• refresh with main
• update branch
• update PR N with main
• re-gate the armed set
• bring these PRs up to date

Pair it with

The verbs that finish the job.

• listArmedMerges
• mergePullRequest
• getPullRequest
• closePullRequest

Questions

• What does refreshPullRequestBranch do?

  Refresh one or many open pull requests with their base branch: GitHub's update-branch, which merges the base into the head, the rail lever that re-gates an armed set after main moves. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use refreshPullRequestBranch from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "refresh with main", and it calls refreshPullRequestBranch.

• Is refreshPullRequestBranch safe to let an AI call?

  refreshPullRequestBranch changes your workspace. What an AI creates is Private until you share it. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.