# agent-config

> agent-config is an open-source MCP server for developer tools. Skills, rules and slash commands that push coding agents to verify before saying done. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Website:** https://event4u-app.github.io/agent-config
- **Repository:** https://github.com/event4u-app/agent-config
- **MCP Registry name:** io.github.event4u-app/agent-config
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agent-config": {
      "command": "npx",
      "args": [
        "-y",
        "@event4u/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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agent-config
