Rollup GitHub tools over MCP — high-value GitHub reads and writes packaged as concise MCP tools for agents. The server focuses on composite operations that replace several API round-trips with one call.
npm: @rethunk/github-mcp · GitHub Packages (on each tag): @rethunk-ai/github-mcp — see docs/install.md and HUMANS.md Publishing.
| Tool | What it does |
|---|---|
repo_status |
Multi-repo dashboard: branch HEAD, CI, PRs, issues, latest commit — up to 64 repos in one call |
my_work |
Cross-repo personal queue: your open PRs, review requests, assigned issues; blockedOnMe lens for action items |
pr_preflight |
Pre-merge safety check: mergeable, reviews, CI, behind-base, commit granularity, computed safe verdict; batch-capable |
release_readiness |
What would ship now: unreleased commits, associated PRs, CI on head, diff stats, and release-asset checksum coverage |
ci_diagnosis |
Why is CI red: failed run logs (tail-truncated), trigger commit, run URL |
org_pulse |
Org-wide dashboard: failing CI, stale PRs, unreviewed PRs across recently active repos |
pin_drift |
Audit upstream pins in a local repo: how far are go.mod, submodule, versions.env, and package.json pins behind upstream? |
ecosystem_activity |
Merged commit feed across multiple repos since a given timestamp or "48h" / "7d" duration |
module_pin_hint |
Return the correct Go pseudo-version string (v0.0.0-YYYYMMDDHHMMSS-sha12) for any repo ref |
changelog_draft |
Draft a CHANGELOG.md section for unreleased commits, grouped by PR metadata |
gh_auth_status |
Check whether the server currently has usable GitHub credentials |
actions_runs_filter |
List and filter GitHub Actions runs by workflow, status, conclusion, and branch |
| Tool | What it does |
|---|---|
pr_comment_batch |
Submit a single PR review with inline comments in one call |
pr_create |
Open a pull request from an existing head branch |
issue_from_template |
Create an issue by rendering a repository issue template |
release_create |
Create a GitHub release, optionally asking GitHub to generate notes |
workflow_dispatch |
Trigger a GitHub Actions workflow_dispatch event |
labels_sync |
Converge a repository's labels to a declared set |
check_run_create |
Publish a synthetic check run against a commit SHA |
Read-only rollup tools default to compact JSON and usually accept format: "markdown" for human-readable output. Write-capable tools always return compact JSON and mutate GitHub state.
Local-repo read tools (repo_status, pr_preflight, pin_drift, ecosystem_activity) follow the active MCP workspace root when the client exposes roots support, so one global install can target whichever repository is currently open.
| Doc | Audience |
|---|---|
| docs/install.md | Client wiring, stdio config shape, prerequisites, troubleshooting |
| docs/mcp-tools.md | Canonical tool ids, parameters, JSON shapes, error codes, idempotency |
| HUMANS.md | Operator guide: auth, quick start, common operations, publishing |
| CONTRIBUTING.md | Dev setup, verification commands, hooks, PR checklist |
| AGENTS.md | LLM and contributor implementation map, contracts, CI/release notes |
| SECURITY.md | Vulnerability disclosure, token-risk model, secure operating guidance |
| TODO.md | Remaining feature backlog only |
| specs/README.md | Spec workflow entrypoints and current active/done/parked state |