Free · Runs in your browser
MCP config validator
Paste your mcp.json and find out why a server will not start. Nothing you paste leaves this tab.
Results appear here as you type.
What it checks
- Duplicate server names. JSON keeps only the last of a repeated key, so adding the same server twice silently throws away your earlier edit. Nothing that validates the parsed object can see this, because by then the duplicate is gone.
- Missing or doubled transport. A server needs a
commandor aurl. Having neither starts nothing; having both means the client picks one and ignores the other. - Remote servers Claude Desktop drops. A server with a
urland nocommanddoes not pass the Claude Desktop config schema. It is dropped, and the only warning is a generic one about invalid servers being skipped, not a message naming this server. Configure remote servers in the app instead. Other clients accept this shape. Checked against Claude Desktop 1.40609.0. - Secrets in env. Env keys that look like tokens with a literal value. The tool names the key and never shows the value. It only looks at
env, so a token sitting inheaders,args, or a URL will not be flagged. - ${VAR} references that never expand. Claude Desktop copies
envvalues to the server as written and starts it without a shell, so a placeholder arrives as its own literal text and the server fails auth with an error that points nowhere near the config. It does not inherit your shell environment either, onlyHOME,LOGNAME,PATH,SHELL,TERMandUSER. The one exception is${PATH}insidePATH, which is substituted, so that is not flagged. Other clients differ: VS Code and Cursor expand${env:VAR}and predefined variables like${workspaceFolder}and${userHome}. Checked against Claude Desktop 1.40609.0. - Types and absolute paths.
argsthat is not an array of strings,envvalues that are not strings, and machine-specific paths that break the moment you sync the config elsewhere.
Where your config goes
Nowhere. The validator is a plain function running in your browser. There is no upload, no request, no analytics on what you paste, and no way to link to a pre-filled version of this page. Close the tab and it is gone.
Set your agent up properly, not just its servers
A working mcp.json is the easy half. The Claude Code Master Bundle is the rules files, prompts, and review gates that stop the agent making a mess once it can reach your tools.
See the bundle