Skip to content
MCP server

agent-config

Skills, rules and slash commands that push coding agents to verify before saying done

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
20.4.0
Listing updated
3 days ago

About agent-config

agent-config is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Agent Config installs a library of skills, always-on rules, slash commands and subagents into the AI coding tools you already use. The aim is to make an agent plan before it codes, run something to check its work, and report evidence. A read-only MCP server serves this governed content to clients.

Commands include /work to refine, plan, implement, test and verify a change, /review:changes for a local diff review, and /commit and /pr:create for Conventional Commits and pull request text. A @production-validator subagent reads the code that would ship and answers READY or NOT READY. On Claude Code the package can also refuse to end a turn on done if files changed and nothing was run.

It installs to your user-level configuration and leaves only an agents/overrides/ folder in the repository. The site is open about cost: about 1.7x to 3.3x tokens on Claude Haiku, not measured on larger models, and on a strong model its own test showed no improvement.

Install

Run in a terminal

claude mcp add agent-config -- npx -y @event4u/agent-config

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "agent-config": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@event4u/agent-config"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-config": {
      "command": "npx",
      "args": [
        "-y",
        "@event4u/agent-config"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agent-config": {
      "command": "npx",
      "args": [
        "-y",
        "@event4u/agent-config"
      ]
    }
  }
}

What it does

Slash-command workflows
Plan, implement, review and commit through commands.
Production validator
A subagent reports whether a branch is really finished.
Code graph map
Draws who calls what as a browser page.
20 supported tools
Writes configuration in each tool's own format.
Clean uninstall
Removes only its own entries.
Published cost
States the token overhead measured on Haiku.

Good for

  • Stop an agent claiming done on unrun code
  • Review a diff for bugs, security and tests before a PR
  • Turn an idea into a feature plan
  • Map a codebase before changing it

Pricing

Open source

Free, MIT licence

Prices change. Check event4u-app.github.io before you buy.

agent-config FAQ

How do I install it?

Run `npx -y @event4u/agent-config init`; Node 22.6 or newer on macOS, Linux or WSL2.

Does it cost more tokens?

Yes. The site reports roughly 1.7x to 3.3x on Claude Haiku.

Which licence?

MIT, free to use.

Is agent-config free?

Yes. agent-config is open source, so you can use and self-host it for free.

How do I add agent-config to Claude Code?

Run this command in your terminal: claude mcp add agent-config -- npx -y @event4u/agent-config

What are the best alternatives to agent-config?

The closest alternatives to agent-config are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to agent-config

  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