Free tool

Windsurf MCP Config Generator

Paste your MCP server URL and get a config Windsurf will actually read — correct file, correct root key, correct transport. Nothing is uploaded.

Paste the endpoint your server is deployed at. A name is optional — it is just the label Windsurf shows.
Runs entirely in your browser. Nothing you paste is uploaded, stored or logged.

The config works. Nobody can still tell what your server does.

A config file gets your server connected. It does not show a customer what it is for. MCP Showcase turns the same URL into a live playground with documentation for every tool.

Start for Free Explore the MCP server directory

How it works

link
Paste your server URL

Everything happens in your browser. Your URL and any token stay on your machine.

play_circle
We use Windsurf's actual format

The right file, the right root key and the right way to express a remote endpoint — which differs more between clients than you would expect.

checklist
Copy it into place

Paste the result into your config file, restart Windsurf, and the server appears in its tool list.

Where the Windsurf MCP config lives

~/.codeium/windsurf/mcp_config.json

Getting the location right matters as much as the contents. A correct config in the wrong file does nothing at all, and no client reports an error for a file it never looked at — which is why "it just does not show up" is the usual symptom rather than a message you can search for.

What Windsurf expects

  • Format: JSON.
  • Root key: mcpServers.
  • Remote endpoint: serverUrl, connected to directly.

Remote servers use serverUrl, not url

Windsurf reads "serverUrl" for a hosted endpoint. A config that says "url" -- which is what every other JSON-based client uses -- is accepted without complaint and the server never connects. It is a one-word difference that produces no error message.

Why a generator rather than the docs

Because the ten clients people actually use disagree about all four of the things above, and every disagreement fails quietly. The root key is mcpServers in most, but servers in VS Code and context_servers in Zed. The remote endpoint is url in most, serverUrl in Windsurf and httpUrl in Gemini CLI. Two clients do not use JSON at all. A config copied between any two of them will usually parse and connect to nothing.

After the config

Restart Windsurf — most clients read their MCP config only at startup. If the server appears but lists no tools, the problem has moved from the config file to the server, and the MCP Inspector will show whether it completes a handshake and which transport it answers on.

Related tools

A config connects you. It does not explain anything.

Everything on this page exists to get one machine talking to one server. It does nothing for the person deciding whether your server is worth connecting in the first place — they cannot read a config file either. MCP Showcase turns the same URL into a live playground with generated documentation for every tool, so evaluating your server takes a click rather than a config file and a restart.

Frequently asked questions

The exact path is shown with the generated config below, because it differs by client and by operating system. Getting the location right matters as much as the contents: a correct config in the wrong file does nothing at all and produces no error.

Because they disagree in ways that fail silently. The root key differs (mcpServers, servers, context_servers), the key for a remote URL differs (url, serverUrl, httpUrl), and two clients do not use JSON at all. A config copied across usually parses fine and simply never connects.

No. This tool makes no network request. The config is built in your browser, nothing is stored, and you can confirm it in your browser's network tab.

Usually yes. Most clients read their MCP config at startup, so a change takes effect on the next launch. If the server still does not appear, check the file path first — that is the most common cause.

That is a connection or transport problem rather than a config-format problem. Run the URL through the MCP Inspector to confirm the server responds and to see which transport it answers on.

More free MCP tools

MCP Inspector Online

Paste an MCP server URL and see every tool, resource and prompt it exposes, with full schemas and the raw request log. Nothing to install.
MCP Server Tester

Check that your MCP server actually works. Paste the URL and get a pass/fail report on the connection, the handshake, the transport and the tools it advertises.
MCP Security Scanner

Before you point an agent at an MCP server, see what it is asking for. Graded A–F on transport, authentication, tool-poisoning markers and dangerous parameters.
MCP Token Calculator

Tool definitions are sent on every request, not once. Paste your MCP server URL to see how many tokens that is, which tools are the heaviest, and what it costs.
See all free tools