---
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

```bash
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

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

## See Also

- [validate-all](../validate-all/SKILL.md) - Run all validators
