Skip to content
MCP server

Agent Config Bridge

MCP server that converts instruction files and MCP configs between coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Agent Config Bridge

Agent Config Bridge is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

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

{
  "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 this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; the web converter is free

Prices change. Check getaicodingagent.com before you buy.

Agent Config Bridge 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 to Agent Config Bridge

  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