Skip to content

Use the GitHub MCP server in the issue tracker doc - #484

Merged
hcrohland merged 1 commit into
mainfrom
feature/github-mcp-issue-tracker
Oct 8, 2026
Merged

hcrohland merged 1 commit into
mainfrom
feature/github-mcp-issue-tracker

Conversation

@laios-r

@laios-r laios-r commented Oct 8, 2026

Copy link
Copy Markdown
Collaborator

Summary

docs/agents/issue-tracker.md is the one repo file that tells agents how to work with GitHub issues and PRs. Every gh CLI invocation becomes the mcp__github__* tool that does the same job; conventions (feature labels, Closes collection, sync-never-force-push, squash-title rule, wayfinder flow) are unchanged.

- Use the `gh` CLI for all operations.
+ Use the GitHub MCP server for all operations — the `mcp__github__*` tools, not the `gh` CLI.

- `gh issue create` / `gh issue edit` / `gh issue close`
+ `issue_write` (`create` / `update` — close is `state` + `state_reason`)
- `gh issue view --json …` + `jq`
+ `issue_read` (`get` / `get_comments`)
- `gh issue list --json … --jq …`
+ `list_issues` with `state` / `labels` / `fields` filters
- `gh issue comment`
+ `add_issue_comment`
- `gh api …/dependencies/blocked_by -F issue_id=<db-id>` (+ the id-lookup dance)
+ `issue_dependency_write` (method `add`, type `blocked_by`) — takes issue numbers
- `gh pr view` / `gh pr merge --squash`
+ `pull_request_read` / `merge_pull_request` (`merge_method: "squash"`)

issue_dependency_* is feature-flagged in the GitHub MCP server (issue_dependencies, github/github-mcp-server#2751) — the doc keeps the Blocked by: body line as fallback where the tools are absent from the toolset.

Evidence

  • Before: doc instructed gh for 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 DB id and issue_dependencies_summary), full search_issues entries (carry id for sub_issue_write), and the merge/update/search_pull_requests schemas; 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 gh instructions.

Blast radius: agent behaviour on issue/PR work — one agent-facing doc, no code.

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
hcrohland merged commit b1bcb84 into main Oct 8, 2026
6 checks passed
@hcrohland
hcrohland deleted the feature/github-mcp-issue-tracker branch October 8, 2026 13:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants