Skip to content
This repository was archived by the owner on Aug 15, 2026. It is now read-only.

Repository files navigation

@rethunk/github-mcp

CInpmLicense: MIT

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 surface

Read-only analysis tools

ToolWhat it does
repo_statusMulti-repo dashboard: branch HEAD, CI, PRs, issues, latest commit — up to 64 repos in one call
my_workCross-repo personal queue: your open PRs, review requests, assigned issues; blockedOnMe lens for action items
pr_preflightPre-merge safety check: mergeable, reviews, CI, behind-base, commit granularity, computed safe verdict; batch-capable
release_readinessWhat would ship now, across up to 64 repos: unreleased commits, associated PRs, CI on head, diff stats, and release-asset checksum coverage
ci_diagnosisWhy is CI red: failed run logs (tail-truncated), trigger commit, run URL
org_pulseOrg-wide dashboard: failing CI, stale PRs, unreviewed PRs across recently active repos
pin_driftAudit upstream pins in a local repo: how far are go.mod, submodule, versions.env, and package.json pins behind upstream?
ecosystem_activityMerged commit feed across multiple repos since a given timestamp or "48h" / "7d" duration
module_pin_hintReturn the correct Go pseudo-version string (v0.0.0-YYYYMMDDHHMMSS-sha12) for any repo ref
changelog_draftDraft a CHANGELOG.md section for unreleased commits, grouped by PR metadata, across up to 64 repos
gh_auth_statusCheck whether the server currently has usable GitHub credentials
actions_runs_filterList and filter GitHub Actions runs by workflow, status, conclusion, branch, and time window
security_alertsRoll up Dependabot and Code Scanning alerts by severity across a repository
branch_protection_statusCheck branch protection rules for a branch (defaults to the repo default branch)
deployment_statusCheck deployment status and latest state per environment
issue_dedupFind likely-duplicate issues by title similarity before opening a new one

Write-capable GitHub tools

ToolWhat it does
pr_comment_batchSubmit a single PR review with inline comments in one call, including multi-line ranges and left-side comments
pr_createOpen a pull request from an existing head branch
issue_from_templateCreate an issue by rendering a repository issue template, including YAML Issue Forms
release_createCreate a GitHub release, optionally asking GitHub to generate notes
workflow_dispatchTrigger a GitHub Actions workflow_dispatch event
labels_syncConverge a repository's labels to a declared set
check_run_createPublish a synthetic check run against a commit SHA
pr_review_thread_opsList, resolve, or unresolve PR review threads; resolveOutdated bulk-resolves outdated threads

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.

Documentation

DocAudience
docs/install.mdClient wiring, stdio config shape, prerequisites, troubleshooting
docs/mcp-tools.mdCanonical tool ids, parameters, JSON shapes, error codes, idempotency
HUMANS.mdOperator guide: auth, quick start, common operations, publishing
CONTRIBUTING.mdDev setup, verification commands, hooks, PR checklist
AGENTS.mdLLM and contributor implementation map, contracts, CI/release notes
SECURITY.mdVulnerability disclosure, token-risk model, secure operating guidance
TODO.mdRemaining feature backlog only
specs/README.mdSpec workflow entrypoints and current active/done/parked state

About

Rollup GitHub MCP tools — composite reads/writes replacing multiple API round-trips for agents.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages