pr-close
Closes a pull request with an optional comment and optional branch deletion. Returns structured data with PR number, state, URL, and deleted-branch flag.
This record as markdown: /tools/io-github-dave-london-build/pr-close.md
What pr-close does on Build
AI agents use pr-close to create or update resources in Build, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Build environment.
Why pr-close is rated Medium
Closing a pull request modifies repository state (changes PR status from open to closed) and optionally deletes a branch. While branch deletion is technically destructive, the primary action is a reversible state change (PRs can be reopened). This fits Write rather than Destructive since PR closure is reversible. However, optional branch deletion elevates severity to medium.
From the tool's definition Tool description states it 'Closes a pull request' and includes 'optional branch deletion'. Closing a PR is a state modification operation; branch deletion is destructive but presented as optional.
Attacks that exploit this kind of access
The rule that runs pr-close safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Build, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For pr-close, this is the rule to start with:
pr-close stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Build, apply this rule, and every pr-close call is checked against it from then on.
Questions about pr-close
Closes a pull request with an optional comment and optional branch deletion. Returns structured data with PR number, state, URL, and deleted-branch flag. It is categorised as a Write tool in the Build MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
Register the Build MCP server in PolicyLayer and add a rule for pr-close: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Build. Nothing to install.
pr-close is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the pr-close rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for pr-close. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
pr-close is provided by the Build MCP server (Dave-London/Pare). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Build, and thousands of servers like it.
This server
Across the catalogue