GitHub create pr

github__create_pr

Access

Requires a project integration connection for github.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
ownerstringYesRepository owner
repostringYesRepository name
titlestringYesPR title
bodystringNoPR description (markdown)
headstringYesBranch to merge from (e.g. feature-branch or owner:feature-branch)
basestringYesBranch to merge into (e.g. main)
draftbooleanNoCreate as draft PR

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "github__create_pr",
    "arguments": {
      "owner": "example",
      "repo": "example",
      "title": "example",
      "head": "example",
      "base": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the github integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "owner": {
      "type": "string",
      "description": "Repository owner"
    },
    "repo": {
      "type": "string",
      "description": "Repository name"
    },
    "title": {
      "type": "string",
      "description": "PR title"
    },
    "body": {
      "type": "string",
      "description": "PR description (markdown)"
    },
    "head": {
      "type": "string",
      "description": "Branch to merge from (e.g. feature-branch or owner:feature-branch)"
    },
    "base": {
      "type": "string",
      "description": "Branch to merge into (e.g. main)"
    },
    "draft": {
      "type": "boolean",
      "description": "Create as draft PR"
    }
  },
  "required": [
    "owner",
    "repo",
    "title",
    "head",
    "base"
  ],
  "description": "Arguments for the github__create_pr tool."
}