# Agent Config Bridge

> Agent Config Bridge is an open-source MCP server for ai models and llm tooling. MCP server that converts instruction files and MCP configs between coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://getaicodingagent.com
- **Repository:** https://github.com/onehumanbeing/agent-config-bridge
- **MCP Registry name:** io.github.onehumanbeing/agent-config-bridge
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-15

## About

Moving between coding agents usually means rewriting the same instructions by hand. This server reads setup files for Claude Code, Codex CLI, Cursor and Gemini CLI and produces the equivalents for the others, including CLAUDE.md, AGENTS.md, Cursor `.mdc` rules, `.cursorrules` and GEMINI.md.

It handles MCP server settings too, translating between `mcpServers` JSON, Codex `config.toml` and Gemini `settings.json`. A project scan reports which agent configs and skills folders exist and which tools have none yet. Migration runs as a dry run by default, skips existing files unless told to overwrite, and merges Gemini settings.

It runs locally over stdio, makes no network calls and sends no telemetry. The README says it writes files only when `migrate_project` is called with `write: true`. The same converter is offered as a browser tool on the maker's site.

## Features

- **Rules conversion:** Turns one tool's instruction text into files and paths for the others, or shares one AGENTS.md by symlink or import.
- **MCP config translation:** Converts between JSON, Codex TOML and Gemini settings formats.
- **Config detection:** Scans a project read-only for agent config files and skills folders.
- **Safe migration:** Dry run by default; existing files are skipped unless overwrite is set.
- **Compatibility matrix:** Returns where each tool reads config, with doc links and a verified date.
- **Local and private:** Stdio only, no network calls or telemetry.

## Good for

- Switching a repo from Claude Code to Codex or Cursor
- Generating an AGENTS.md for teammates on other tools
- Porting MCP server settings to Gemini CLI
- Auditing which agents a project already supports

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-config-bridge -- npx -y https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-config-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-config-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-config-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-config-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-config-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `convert_rules`: Convert instruction text from one tool into files and paths for the others.
- `convert_mcp_config`: Convert MCP server configs between Claude, Cursor, Codex TOML and Gemini formats.
- `detect_agent_configs`: Scan a project read-only for agent config files and skills folders.
- `migrate_project`: Generate missing configs from existing ones; dry run by default.
- `compat_matrix`: Show where each tool reads its config, with doc links.

## FAQ

### Does it send my files anywhere?

No. The README says it makes no network calls and sends no telemetry.

### Does it overwrite my files?

Not by default. Migration is a dry run, and files are written only with write: true; existing files are skipped unless overwrite is true.

### How do I install it?

Run it with npx from GitHub, add it with claude mcp add or codex mcp add, or install the MCPB bundle.

### Which tools are supported?

Claude Code, Codex CLI, Cursor and Gemini CLI.

### Is Agent Config Bridge free?

Yes. Agent Config Bridge is open source, so you can use and self-host it for free.

### How do I add Agent Config Bridge to Claude Code?

Run this command in your terminal: claude mcp add agent-config-bridge -- npx -y https://github.com/onehumanbeing/agent-config-bridge/releases/download/v0.1.0/agent-config-bridge-0.1.0.mcpb

### What are the best alternatives to Agent Config Bridge?

The closest alternatives to Agent Config Bridge 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-bridge
