validate-mcp

name	validate-mcp
description	Validates MCP server configuration files (.mcp.json). Use when user asks to "check my .mcp.json", "why isn't my MCP working", ".mcp.json errors", "validate MCP servers", or "MCP connection failed". Validates transport types (stdio, sse, http, websocket), server names, and environment variables.
version	1.0.0
argument-hint	[flags]
allowed-tools	["Bash(claudelint:*)"]

Validate MCP Servers

Runs claudelint validate-mcp to validate .mcp.json configuration files.

Usage

claudelint validate-mcp $ARGUMENTS

Options

• --path <path> - Custom path to .mcp.json
• --verbose - Show detailed output
• --warnings-as-errors - Treat warnings as errors

What Gets Validated

• JSON syntax
• Server name uniqueness and consistency
• Transport type (stdio, sse)
• Stdio transport (command validation)
• SSE transport (URL validation)
• Variable expansion patterns (${VAR}, ${VAR:-default})
• Environment variables

Examples

claudelint validate-mcp
claudelint validate-mcp --path /path/to/.mcp.json

See Also

• validate-all - Run all validators