Free tool

MCP Config Converter

Paste a config from any MCP client and get it back in the format another one reads — including the format changes nobody documents.

Same server, every client. Still nothing your customers can see.

Config files are for the people who already bought. MCP Showcase gives you one link that shows anyone what your server does, without configuring anything.

How it works

link
Pick the client you are moving to

The target decides the file, the format and the field names.

play_circle
Paste your existing config

From any client. The source format is detected for you.

checklist
Copy it across

The result is in the target's own format, ready to paste into the right file.

Every client, and where they disagree

MCP standardises the protocol, not the configuration. These ten clients read different files, in three different formats, with different key names for the same thing. The table below is the whole problem in one place — and the reason a config copied from one client into another usually parses cleanly and connects to nothing.

ClientFormatRoot keyRemote endpoint
Claude Desktop JSON mcpServers via local bridge
Claude Code JSON mcpServers url
Cursor JSON mcpServers url
VS Code JSON servers url
Windsurf JSON mcpServers serverUrl
Codex CLI TOML mcp_servers url
Gemini CLI JSON mcpServers httpUrl
Cline JSON mcpServers url
Zed JSON context_servers url
Continue YAML mcpServers url

The three mistakes that cause most of the pain

  • The root key. Most clients read mcpServers. VS Code reads servers, Zed reads context_servers, Codex CLI reads mcp_servers. Wrong key, valid file, no servers, no error.
  • The endpoint field. url for most, serverUrl for Windsurf, httpUrl for Gemini CLI when the transport is streamable HTTP.
  • Assuming a hosted URL works everywhere. Claude Desktop launches local processes only; a remote server has to be bridged through mcp-remote, which is a completely different config shape.

Related tools

None of this is visible to your customers

Everything here serves people who already decided to use your server. MCP Showcase is for the ones who have not: point it at the same URL and it produces a live playground with documentation for every tool, so evaluating your server takes a click rather than a config file and a restart.

Frequently asked questions

Rarely without changes. The root key, the field for a remote endpoint and sometimes the entire file format differ, and each mismatch fails silently rather than raising an error.

Any JSON-based config can be read — Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Zed and others — and output is produced for all ten covered clients, including the TOML and YAML ones.

Some clients cannot reach a hosted MCP endpoint directly and need a local bridge process. When that applies, the converted config runs mcp-remote and passes your URL to it, and the page says so under the result.

Whatever is in the config you paste comes across, headers and environment variables included. Nothing is uploaded, but if you would rather, strip the token first and add it back afterwards.

They convert across largely unchanged — same command, same arguments. What changes is the wrapper around them: the root key and, for TOML or YAML clients, the whole file syntax.

More free MCP tools