SCM create pull request
scm_create_pull_requestOpen a pull request with file changes on a GitHub repository, automatically (no confirmation) - the pull request is itself the human review gate. Use this in agent mode to land a pipeline-failure fix or other change as a reviewable PR: creates a new branch from the base branch, commits the files, and opens the PR. This tool is only available in agent mode; in ask mode, propose the change and ask the user to switch to agent mode. Requires the exact owner from github_list_repositories - never guess it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"owner": "<owner>",
"repo": "<repo>",
"title": "<title>",
"head_branch": "<head_branch>",
"files": "<files>",
"commit_message": "<commit_message>"
},
"name": "scm_create_pull_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | Pull request description in markdown. | |
| repo | Yes | Repository name. Also accepts the combined 'owner/name' form. | |
| draft | No | If true, create as a draft PR. | |
| files | Yes | Files to create or update. Each entry has a 'path' and 'content'. | |
| owner | Yes | Repository owner (e.g. 'octocat'). Prefer the exact owner from a prior github_list_repositories call. May be embedded in 'repo' as 'owner/name'. | |
| title | Yes | Pull request title. | |
| base_branch | No | Target branch to merge into. Defaults to the repository's default branch. | |
| head_branch | Yes | Name for the new branch (e.g. 'fix/ci-build'). Must not already exist. | |
| commit_message | Yes | Git commit message for the changes. | |
| confirm_large_deletions | No | Paths from 'files' whose new content is intentionally much shorter than the file it replaces. A commit that would replace an existing file with less than half of its content is refused unless that path is listed here. Leave this out unless a refusal named the path and removing that much is the change you intend. |