create_pull_request
Create a pull request to merge code changes from one branch to another in a GitHub repository.
Instructions
Create a new pull request in a GitHub repository
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | Yes | Repository owner (username or organization) | |
| repo | Yes | Repository name | |
| title | Yes | Pull request title | |
| body | No | Pull request body/description | |
| head | Yes | The name of the branch where your changes are implemented | |
| base | Yes | The name of the branch you want the changes pulled into | |
| draft | No | Whether to create the pull request as a draft | |
| maintainer_can_modify | No | Whether maintainers can modify the pull request |
Implementation Reference
- src/operations/pulls.ts:206-222 (handler)The core handler function that executes the create_pull_request tool logic by parsing inputs, making a POST request to GitHub's /pulls endpoint, and parsing the response.
export async function createPullRequest( github_pat: string, params: z.infer<typeof CreatePullRequestSchema> ): Promise<z.infer<typeof GitHubPullRequestSchema>> { const { owner, repo, ...options } = CreatePullRequestSchema.parse(params); const response = await githubRequest( github_pat, `https://api.github.com/repos/${owner}/${repo}/pulls`, { method: "POST", body: options, } ); return GitHubPullRequestSchema.parse(response); } - src/index.ts:446-453 (handler)The top-level dispatcher handler in the MCP server that handles the create_pull_request tool call, parses arguments with PAT, delegates to pulls.createPullRequest, and formats the response.
case "create_pull_request": { const argsWithPat = pulls._CreatePullRequestSchema.parse(params.arguments); const { github_pat, ...args } = argsWithPat; const pullRequest = await pulls.createPullRequest(github_pat, args); return { content: [{ type: "text", text: JSON.stringify(pullRequest, null, 2) }], }; } - src/operations/pulls.ts:79-92 (schema)Zod schemas defining the input parameters for create_pull_request: CreatePullRequestSchema (public inputs) and _CreatePullRequestSchema (with github_pat for internal use).
export const CreatePullRequestSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), title: z.string().describe("Pull request title"), body: z.string().optional().describe("Pull request body/description"), head: z.string().describe("The name of the branch where your changes are implemented"), base: z.string().describe("The name of the branch you want the changes pulled into"), draft: z.boolean().optional().describe("Whether to create the pull request as a draft"), maintainer_can_modify: z.boolean().optional().describe("Whether maintainers can modify the pull request") }); export const _CreatePullRequestSchema = CreatePullRequestSchema.extend({ github_pat: z.string().describe("GitHub Personal Access Token"), }); - src/index.ts:108-112 (registration)Tool registration in the MCP server's listTools response, specifying name, description, and input schema.
{ name: "create_pull_request", description: "Create a new pull request in a GitHub repository", inputSchema: zodToJsonSchema(pulls.CreatePullRequestSchema), },