Add issue dependency read/write MCP tools - #2751
Merged
SamMorrowDrums merged 3 commits intoJun 26, 2026
Merged
Conversation
Copy link
Copy Markdown
Contributor
Sorry, something went wrong.
Add two feature-flagged tools for issue blocked-by / blocking relationships, gated behind the issue_dependencies flag so they stay off the default tool surface (auto-enabled for insiders only): - issue_dependency_read: get_blocked_by / get_blocking via the Issue.blockedBy / Issue.blocking GraphQL connections, cursor-paginated. - issue_dependency_write: add / remove x blocked_by / blocking via the addBlockedBy / removeBlockedBy mutations. Accepts issue numbers and resolves them to node IDs in a single aliased query; "blocking" is the inverse of "blocked_by" with the subject/related roles swapped. Closes the MCP gap behind the gh CLI dependency verbs (cli/cli#13057). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Reject a write where the subject and related issue are identical before resolving node IDs or issuing a mutation, avoiding two API round-trips. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copy link
Copy Markdown
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new, opt-in “issue dependencies” capability to the GitHub MCP Server by introducing two feature-flagged MCP tools for reading and mutating native GitHub issue dependency edges (blocked-by / blocking) via GraphQL, including snapshots, tests, and generated docs updates.
Changes:
- Added issue_dependency_read (cursor-paginated) to list blockedBy / blocking relationships for an issue via GraphQL connections.
- Added issue_dependency_write to add/remove dependency edges via addBlockedBy / removeBlockedBy, resolving issue numbers to node IDs in a single aliased query and rejecting self-dependencies early.
- Introduced the issue_dependencies feature flag and documented the newly gated tools in generated docs.
| File | Description |
|---|---|
| pkg/github/tools.go | Registers the new dependency tools in the overall tool inventory (feature-gated). |
| pkg/github/issue_dependencies.go | Implements issue_dependency_read + issue_dependency_write using GraphQL queries/mutations and cursor pagination. |
| pkg/github/issue_dependencies_test.go | Adds tool schema snapshot tests and behavioral tests for read/write operations and validation paths. |
| pkg/github/feature_flags.go | Introduces FeatureFlagIssueDependencies and wires it into allowed + insiders feature flag sets. |
| pkg/github/toolsnaps/issue_dependency_read_ff_issue_dependencies.snap | Adds the toolsnap for the feature-flagged read tool schema. |
| pkg/github/toolsnaps/issue_dependency_write_ff_issue_dependencies.snap | Adds the toolsnap for the feature-flagged write tool schema. |
| docs/insiders-features.md | Generated docs: documents the new issue_dependencies gated tools under insiders. |
| docs/feature-flags.md | Generated docs: documents the new issue_dependencies flag and its gated tools. |
Copilot's findings
- Files reviewed: 8/8 changed files
- Comments generated: 0
Sorry, something went wrong.
Comment thread
docs/insiders-features.md
Outdated
SamMorrowDrums
approved these changes
Jun 26, 2026
This was referenced Jun 27, 2026
Closed
syf2211
added a commit
to syf2211/github-mcp-server
that referenced
this pull request
Jun 27, 2026
* Add issue dependency read/write MCP tools Add two feature-flagged tools for issue blocked-by / blocking relationships, gated behind the issue_dependencies flag so they stay off the default tool surface (auto-enabled for insiders only): - issue_dependency_read: get_blocked_by / get_blocking via the Issue.blockedBy / Issue.blocking GraphQL connections, cursor-paginated. - issue_dependency_write: add / remove x blocked_by / blocking via the addBlockedBy / removeBlockedBy mutations. Accepts issue numbers and resolves them to node IDs in a single aliased query; "blocking" is the inverse of "blocked_by" with the subject/related roles swapped. Closes the MCP gap behind the gh CLI dependency verbs (cli/cli#13057). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Fail fast on self-dependency in issue_dependency_write Reject a write where the subject and related issue are identical before resolving node IDs or issuing a mutation, avoiding two API round-trips. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Revert addition of `any of` for required ui_get scopes --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
6 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add two feature-flagged MCP tools for issue dependencies: issue_dependency_read (list an issue's blocked-by / blocking relationships) and issue_dependency_write (add / remove a blocked-by or blocking relationship).
Why
github-mcp-server had no way to read or edit issue dependencies, although the GitHub API supports them and the gh CLI shipped the verbs in v2.94.0. This closes that MCP gap.
Closes #2391
Refs #950
What changed
MCP impact
Prompts tested (tool changes only)
Security / limits
Tool renaming
Lint & tests
Docs
Split out from #2726, which now contains only the always-on issue_read → get_parent method.