What it does
gatefile reads a repository's contribution rules from CONTRIBUTING.md, PR and issue templates, DCO and CLA workflow files, lefthook hooks and CLA files, either through the GitHub API or from a local directory. It writes each gate it finds, with a quoted line from the source as evidence. Gates are classed as blockers, which can get a PR closed before review, or warnings, which can be fixed after the PR opens. In API mode, a repository without its own CONTRIBUTING file or PR template inherits the organization default from its owner's .github repository, and a repository file takes precedence.
Someone would reach for it when contributors keep finding out about requirements only after a bot closes their PR, or when maintainers want those rules in a file that tools and CI can read. The validate command compares a committed contribution-gates.json against a fresh extraction and reports drift, exiting with code 1 when drift is found, so CI can enforce it. The badge command renders a README snippet that states the gates in plain language. The file format is consumed by Greenlight, one of four companion tools for open-source contribution work.
It can run as a CLI, or as a stdio MCP server through a Docker container image published on GHCR. The MCP server exposes extract_gates, validate_gates and gates_badge tools, and any CLI command can be passed to the container in place of the default mcp argument. A GitHub Actions example shows how to run validation in CI. The codebase is TypeScript (ESM) and targets Node 20 or later.
Limitations and requirements
Running from source requires Node 20 or later. Running as a container requires Docker. Extraction needs either GitHub API access or a local copy of the repository.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/gatefile
Extract a repo's contribution gates into machine-readable contribution-gates.json.
v0.1.4As shown on registry.modelcontextprotocol.io when we last read it