Skip to main content
Glama

agent-config-bridge

An MCP server that moves your coding-agent setup between Claude Code, Codex CLI, Cursor and Gemini CLI: instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc, .cursorrules, GEMINI.md) and MCP server configs (mcpServers JSON ⇄ Codex config.toml ⇄ Gemini settings.json).

Runs locally over stdio. No network calls, no telemetry. It writes files only when you call migrate_project with write: true.

Prefer a web UI? Use the same converter in your browser at getaicodingagent.com.

Tools

Tool

What it does

convert_rules

Instruction text from one tool → files and paths for the others. Can also share one AGENTS.md through a symlink or an @AGENTS.md import

convert_mcp_config

MCP servers: Claude Code / Claude Desktop / Cursor JSON ⇄ Codex [mcp_servers.*] TOML ⇄ Gemini httpUrl/url

detect_agent_configs

Scans a project read-only for every agent config file and skills folder, and lists which tools have no config yet

migrate_project

Generates the missing configs from the existing ones. Dry run by default. Existing files are skipped unless overwrite: true; .gemini/settings.json is merged

compat_matrix

Where each tool reads its config, with official doc links and a verified date. Anything the official docs don't state is returned as unknown

Related MCP server: codex-mcp-tool

Install

You need Node.js 18 or later and npm 10 or later (npm 9.2 fails to run GitHub packages through npx). The package is not on npm. Run it straight from GitHub (dist/ is committed, so there's no build step):

npx -y github:onehumanbeing/agent-config-bridge

Claude Code

claude mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge

Codex CLI

codex mcp add agent-config-bridge -- npx -y github:onehumanbeing/agent-config-bridge

or add this to ~/.codex/config.toml:

[mcp_servers.agent-config-bridge]
command = "npx"
args = ["-y", "github:onehumanbeing/agent-config-bridge"]

Cursor: .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). Gemini CLI: .gemini/settings.json or ~/.gemini/settings.json:

{ "mcpServers": { "agent-config-bridge": { "command": "npx", "args": ["-y", "github:onehumanbeing/agent-config-bridge"] } } }

MCPB bundle: download agent-config-bridge-0.1.0.mcpb from the v0.1.0 release and open it in an MCPB-compatible client (for example, double-click it to install in Claude Desktop). Dependencies are bundled.

From a clone

git clone https://github.com/onehumanbeing/agent-config-bridge && cd agent-config-bridge
claude mcp add agent-config-bridge -- node "$PWD/dist/index.js"

MCP Registry name: io.github.onehumanbeing/agent-config-bridge

Example prompts

  • "Detect the agent configs in this repo and migrate them to Codex and Cursor (dry run first)."

  • "Convert this Claude Desktop config to Codex TOML."

  • "Where does Gemini CLI read its MCP config? Use compat_matrix."

Develop

npm install && npm test   # builds, then runs unit tests plus an MCP client smoke test

MIT © onehumanbeing

Available Tools

5 tools
compat_matrixConfig compatibility matrixA
Read-only

Where Claude Code, Codex CLI, Cursor and Gemini CLI read instructions, MCP config and skills, with official doc links and the date each was verified. 'unknown' means not stated in the official docs.

Inputs: no named parameters.

convert_mcp_configConvert MCP server configA

Convert MCP server definitions between Claude Code/Claude Desktop/Cursor JSON (mcpServers), Gemini CLI settings.json (httpUrl/url) and Codex config.toml [mcp_servers.*]. Returns target files; writes nothing.

Inputs: text (required), format, targets.

convert_rulesConvert instruction filesA

Convert agent instructions (CLAUDE.md, AGENTS.md, .cursor/rules/*.mdc, .cursorrules, GEMINI.md) into the files Claude Code, Codex CLI, Cursor and Gemini CLI read. Returns file paths + contents and a shell command; writes nothing.

Inputs: text (required), link, source, targets.

detect_agent_configsDetect agent configs in a projectA
Read-only

Scan a project directory (read-only) for CLAUDE.md, AGENTS.md, GEMINI.md, .cursor/rules, .cursorrules, .mcp.json, .cursor/mcp.json, .gemini/settings.json, .codex/config.toml and skills folders.

Inputs: dir (required).

migrate_projectMigrate a project's agent configA
Destructive

Generate target-tool config files from the project's existing instructions and MCP config. DRY RUN by default: returns the plan. Files are written only when write=true; existing files are skipped unless overwrite=true (Gemini settings.json is merged).

Inputs: dir (required), targets (required), from, link, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation4/5

    convert_rules and convert_mcp_config target clearly different artifacts (instruction files vs MCP server definitions), and detect_agent_configs is unambiguously read-only discovery. migrate_project partially overlaps with the two convert_* tools since it composes them into a write-capable plan, but its description makes the distinction (orchestration + optional writes) explicit.

    Naming Consistency4/5

    Four of five tools follow a verb_noun snake_case pattern (convert_rules, convert_mcp_config, detect_agent_configs, migrate_project). compat_matrix breaks the pattern as a noun phrase, but the convention is otherwise predictable and readable.

    Tool Count5/5

    Five tools is well-scoped for a config-bridge server: discovery, two artifact-specific conversions, an orchestration/write path, and a reference lookup. Each tool occupies a distinct role with no filler.

    Completeness4/5

    The surface covers discovery, conversion, migration and a reference matrix for instructions and MCP config across four agents, which is strong lifecycle coverage. Minor gap: skills are detected and documented in compat_matrix but there is no dedicated skills conversion/write path, leaving that artifact half-covered.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables conversion of coding agent sessions between Claude Code, Codex CLI, and OpenCode, including full support for OpenCode's SQLite storage.
      4
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      MCP server connecting Claude/Cursor to Codex CLI, enabling code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode.
      13
      107 npm
      24
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP-compatible AI clients like Claude Code, Cursor, and Codex to invoke Google Antigravity's Gemini coding agent for repository-aware file operations, command execution, code review, test generation, and quota checks, while also providing a standalone dual-mode CLI.
      7
      MIT