Groundrule
Gives coding agents your repo's engineering standards and checks their changes
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.23.1
- Listing updated
- 2 days ago
About Groundrule
Groundrule is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Groundrule's MCP server runs from the CLI inside your repository and reads .groundrule/config.yaml. It gives an agent three tools: list_standards shows the rules in effect, check tests the agent's changes against them locally, and propose_rule sends a suggested rule to your team's inbox for review. The idea is that a correction you make in a session can turn into a proposed standard.
Standards are small YAML files kept in git. The wider tool writes AGENTS.md, CLAUDE.md, Cursor rules and Copilot instructions containing only the standards that apply, and runs deterministic checks, Semgrep and optional AI checks in CI. Offline mode needs no account and nothing leaves your machine; proposing rules requires a connected workspace with a sign-in or token.
Node.js 22 or later is required. A hosted server at mcp.groundrule.dev is also offered for cloud agents and web IDEs that cannot run the CLI. The README labels the project 0.x with a format that may still change.
Install
Run in a terminal
claude mcp add groundrule -- npx -y @groundrule/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"groundrule": {
"command": "npx",
"args": [
"-y",
"@groundrule/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"groundrule": {
"command": "npx",
"args": [
"-y",
"@groundrule/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"groundrule": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@groundrule/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"groundrule": {
"command": "npx",
"args": [
"-y",
"@groundrule/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"groundrule": {
"command": "npx",
"args": [
"-y",
"@groundrule/cli"
]
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- list_standards
- Reads the rules in effect in the repository.
- check
- Checks the agent's changes against the standards.
- propose_rule
- Sends a proposed rule to the team's inbox for review.
What it does
- List rules in effect
- `list_standards` returns the standards that apply in the repository.
- Check own changes
- `check` tests an agent's changes against the standards before it finishes.
- Rule proposals
- `propose_rule` sends a rule to the team inbox for review.
- Offline mode
- With no platform set, checks run locally and nothing is uploaded.
- Hosted option
- A hosted server serves a workspace's latest rules to agents that cannot run the CLI.
- Agent instruction files
- `sync` writes AGENTS.md, CLAUDE.md, Cursor and Copilot instructions.
Good for
- Keep an agent within a team's dependency and import rules
- Check an agent's diff before it opens a PR
- Turn a code-review correction into a reusable standard
- Generate consistent agent instruction files across tools
- Enforce the same rules locally and in CI
Pricing
Open source
Open-source CLI and MCP server; paid platform features not priced in the docs
Prices change. Check docs.groundrule.dev before you buy.
Groundrule FAQ
What does it need to run?
Node.js 22 or later on the agent's PATH, started from inside the repository.
Does it send my code anywhere?
In offline mode nothing leaves your computer. In a connected workspace only per-rule counts are reported from checks.
Which agents are covered?
Claude Code, Cursor and VS Code have setup steps, and any client that can start a stdio server works.
Is there a hosted version?
Yes, at https://mcp.groundrule.dev/mcp.
Is Groundrule free?
Yes. Groundrule is open source, so you can use and self-host it for free.
How do I add Groundrule to Claude Code?
Run this command in your terminal: claude mcp add groundrule -- npx -y @groundrule/cli
What are the best alternatives to Groundrule?
The closest alternatives to Groundrule are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Groundrule

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools