MCP Config Validator

Runs in browser

Validate MCP server configs with instant error and warning feedback.

Validate Model Context Protocol (MCP) server configuration files in real time. Catches JSON errors, missing keys, invalid types, duplicate names, bad URLs, and sensitive credential warnings.

MCP Config Validator tool

✓ Valid

Warnings

mcpServers.github.env.GITHUB_PERSONAL_ACCESS_TOKEN

"GITHUB_PERSONAL_ACCESS_TOKEN" looks like a sensitive credential — avoid committing real tokens. Use environment variables or a secrets manager.

Schema Reference
FieldTypeRequiredDescription
mcpServersobjectYesMap of server name → server config
commandstringor urlExecutable to run (stdio transport)
urlstringor commandHTTP/SSE endpoint URL
type"stdio"|"sse"|"http"NoTransport type (optional, inferred)
argsstring[]NoArguments passed to the command
envRecord<string,string>NoEnvironment variables for the server

🔒 Runs in your browser · No uploads · Your data never leaves your device

How to use

  1. Paste your config

    Paste your MCP config JSON into the editor. Validation runs automatically as you type.

  2. Fix errors

    Errors (red) must be resolved for the config to work. Each error shows the exact field path and a plain-English explanation.

  3. Review warnings

    Warnings (yellow) flag potential issues like hardcoded credentials in env fields — these won't break MCP but indicate security risks.

  4. Apply auto-fix

    If an auto-fixable issue is detected (like a missing mcpServers wrapper), click 'Apply Fix' to correct it automatically.

Common use cases

  • Catching JSON errors before loading Claude DesktopPaste your config to find syntax errors and missing required keys before your app fails to start.
  • Detecting hardcoded credentialsWarnings flag tokens and passwords placed directly in env fields — reminding you to move them to a secrets manager.

Examples

  • Valid filesystem server config

    npx-based MCP server for local filesystem access

    Output
    ✓ Valid — no issues found
  • Missing mcpServers key

    Config with servers at root level instead of inside mcpServers

    Output
    1 error: Missing required key mcpServers. Auto-fix available.

Frequently asked questions

What is MCP?
Model Context Protocol (MCP) is an open standard by Anthropic that lets AI assistants like Claude connect to tools and data sources. It's used in Claude Desktop, Cursor, and other AI-powered IDEs.
Where is my MCP config file?
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json for Claude Desktop. In Cursor: ~/.cursor/mcp.json. Check your app's documentation for the exact path.
What does stdio vs sse vs http mean?
stdio: the MCP server runs as a subprocess. sse: connects to a Server-Sent Events endpoint. http: connects to an HTTP endpoint. Most community MCP servers use stdio.

Key concepts

MCP config
A JSON file specifying MCP server names, commands, arguments, and environment variables for Claude Desktop or Cursor.
Linting
Static analysis of configuration or code to catch errors and bad practices without running it.

You might find these useful too.

More ai tools