Skip to content

/validate-mcp

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

From plugin
claudelint
129 skills13 agents1 command1 hook
Install
$ npx -y skills add pdugan20/claudelint --skill validate-mcp --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/validate-mcp

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

SKILL.md

validate-mcp.SKILL.md
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](../validate-all/SKILL.md) - Run all validators
Ships withclaudelint

A linter for Claude Code projects. Validates CLAUDE.md files, skills, settings, hooks, MCP servers, plugins, and more.

Get the whole plugin, auto-invoked

Other skills on claudelint.