Skip to content
MCP server

Groundrule

Gives coding agents your repo's engineering standards and checks their changes

Runs locallyStatus and history
Install
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/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "groundrule": {
      "command": "npx",
      "args": [
        "-y",
        "@groundrule/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "groundrule": {
      "command": "npx",
      "args": [
        "-y",
        "@groundrule/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools