feat(pull_requests): add MCP tools for GitHub Stacked PRs (#2905)

README.md

@@ -1296,6 +1296,24 @@ The following sets of tools are available:
   - `repo`: Repository name (string, required)
   - `threadId`: The node ID of the review thread (e.g., PRRT_kwDOxxx). Required for resolve_thread and unresolve_thread methods. Get thread IDs from pull_request_read with method get_review_comments. (string, optional)
 
+- **pull_request_stack_read** - Read pull request stacks
+  - **OAuth Challenge Scopes**: `repo`
+  - `method`: The read operation: `get` retrieves one stack by stackNumber; `list` lists repository stacks and can filter by pullNumber. (string, required)
+  - `owner`: Repository owner (string, required)
+  - `page`: Page number for pagination (min 1) (number, optional)
+  - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
+  - `pullNumber`: Filter listed stacks to the stack containing this repository pull request number. Used only when method is `list`. (number, optional)
+  - `repo`: Repository name (string, required)
+  - `stackNumber`: Stack number. Required when method is `get`. (number, optional)
+
+- **pull_request_stack_write** - Manage pull request stack
+  - **OAuth Challenge Scopes**: `repo`
+  - `method`: The write operation: `create`, `add`, or `unstack`. (string, required)
+  - `owner`: Repository owner (string, required)
+  - `pullNumbers`: Repository pull request numbers in bottom-to-top order. Required for `create` and `add`. (number[], optional)
+  - `repo`: Repository name (string, required)
+  - `stackNumber`: Stack number. Required for `add` and `unstack`. (number, optional)
+
 - **search_pull_requests** - Search pull requests
   - **OAuth Challenge Scopes**: `repo`
   - `fields`: Subset of fields to return for each pull request result. If omitted, all fields are returned. Use this to reduce response size when you only need specific fields; omitting 'body', 'reactions', and 'labels' in particular drops the largest per-result data. (string[], optional)

pkg/github/__toolsnaps__/pull_request_stack_read.snap

@@ -0,0 +1,56 @@
+{
+  "annotations": {
+    "idempotentHint": false,
+    "readOnlyHint": true,
+    "title": "Read pull request stacks"
+  },
+  "description": "Read native GitHub pull request stacks. Use `get` for a stack number or `list` to enumerate stacks and optionally resolve the stack containing a pull request.",
+  "inputSchema": {
+    "properties": {
+      "method": {
+        "description": "The read operation: `get` retrieves one stack by stackNumber; `list` lists repository stacks and can filter by pullNumber.",
+        "enum": [
+          "get",
+          "list"
+        ],
+        "type": "string"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "page": {
+        "description": "Page number for pagination (min 1)",
+        "minimum": 1,
+        "type": "number"
+      },
+      "perPage": {
+        "description": "Results per page for pagination (min 1, max 100)",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "number"
+      },
+      "pullNumber": {
+        "description": "Filter listed stacks to the stack containing this repository pull request number. Used only when method is `list`.",
+        "minimum": 1,
+        "type": "number"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "stackNumber": {
+        "description": "Stack number. Required when method is `get`.",
+        "minimum": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "method",
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "pull_request_stack_read"
+}

pkg/github/__toolsnaps__/pull_request_stack_write.snap

@@ -0,0 +1,53 @@
+{
+  "annotations": {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": true,
+    "readOnlyHint": false,
+    "title": "Manage pull request stack"
+  },
+  "description": "Create, extend, or unstack a native GitHub pull request stack. `create` accepts 2-100 pullNumbers ordered bottom-to-top. `add` accepts 1-100 pullNumbers to append above the current top. `unstack` removes every removable unmerged pull request and may leave locked or queued pull requests in the stack. All pull requests must belong to the target repository, use branches in that repository, and form a linear base/head chain. These operations manage stack metadata only; they do not create pull requests, retarget bases, rebase commits, push branches, or merge.",
+  "inputSchema": {
+    "properties": {
+      "method": {
+        "description": "The write operation: `create`, `add`, or `unstack`.",
+        "enum": [
+          "create",
+          "add",
+          "unstack"
+        ],
+        "type": "string"
+      },
+      "owner": {
+        "description": "Repository owner",
+        "type": "string"
+      },
+      "pullNumbers": {
+        "description": "Repository pull request numbers in bottom-to-top order. Required for `create` and `add`.",
+        "items": {
+          "minimum": 1,
+          "type": "number"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "repo": {
+        "description": "Repository name",
+        "type": "string"
+      },
+      "stackNumber": {
+        "description": "Stack number. Required for `add` and `unstack`.",
+        "minimum": 1,
+        "type": "number"
+      }
+    },
+    "required": [
+      "method",
+      "owner",
+      "repo"
+    ],
+    "type": "object"
+  },
+  "name": "pull_request_stack_write"
+}