Repository navigation
Use the GitHub MCP server in the issue tracker doc - #484
Merged
Merged
Conversation
Replace every gh CLI invocation in docs/agents/issue-tracker.md with the mcp__github__* tools: issue_write/issue_read/sub_issue_write for issue lifecycle, issue_dependency_write for wayfinder blocking (feature-flagged, with the Blocked-by body line as fallback), pull_request_read/ merge_pull_request for the PR side, and search_* with field filters for listing. Verified against the live server and the merged tool schemas in github/github-mcp-server#2751.
hcrohland
approved these changes
Oct 8, 2026
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
docs/agents/issue-tracker.mdis the one repo file that tells agents how to work with GitHub issues and PRs. EveryghCLI invocation becomes themcp__github__*tool that does the same job; conventions (feature labels, Closes collection, sync-never-force-push, squash-title rule, wayfinder flow) are unchanged.issue_dependency_*is feature-flagged in the GitHub MCP server (issue_dependencies, github/github-mcp-server#2751) — the doc keeps theBlocked by:body line as fallback where the tools are absent from the toolset.Evidence
ghfor everything; the session MCP toolset had no dependency tools.After: every tool the doc names was probed live against the running server this session —
issue_read get/get_sub_issues(entries carry the DBidandissue_dependencies_summary), fullsearch_issuesentries (carryidforsub_issue_write), and themerge/update/search_pull_requestsschemas; merged #2751 schema for the flag-gated pair. Pre-commit suite (fmt + full backend/frontend tests) green on the commit.Merge Danger
Door: two-way
Docs-only; reverting restores the
ghinstructions.Blast radius: agent behaviour on issue/PR work — one agent-facing doc, no code.