What does the warnings-as-errors flag do?

This flag forces the validator to treat minor warnings as critical failures, ensuring your configuration meets the highest standards of correctness.

What transport types does this skill support?

It validates standard transport protocols including stdio, sse, http, and websocket to ensure your server can communicate with Claude.

Why is my MCP server not working in Claude Code?

Use the validate-mcp skill to check for JSON syntax errors, incorrect transport types, or missing environment variables in your .mcp.json file.

How does it handle environment variables?

The skill checks for proper expansion patterns like ${VAR} or ${VAR:-default} to ensure variables are resolved correctly during server initialization.

Can I validate a configuration file in a custom location?

Yes, you can use the --path flag to point the validator to any specific .mcp.json file on your system.

MCP Configuration Validator

Name: MCP Configuration Validator
Author: pdugan20

bypdugan20

•

Developer Tools

Ensures Model Context Protocol (MCP) server configurations are syntactically correct and functional for Claude Code projects.

The Validate MCP skill provides automated linting and verification for .mcp.json configuration files, helping developers troubleshoot connection issues and configuration errors. It performs deep checks on transport types like stdio and SSE, validates environment variable expansion, ensures unique server names, and verifies command execution paths. This skill is essential for streamlining the integration of external tools and data sources into the Claude environment, preventing runtime failures caused by malformed configuration files.

Key Features

01Validates JSON syntax and schema for .mcp.json files

02Verifies transport protocols including stdio, sse, http, and websocket

03Validates stdio command paths and SSE URL formatting

04Detects duplicate server names and configuration conflicts

052 GitHub stars

06Checks environment variable expansion patterns and consistency

Use Cases

01Verifying complex environment variable setups before deploying new tools

02Auditing server transport configurations for protocol compliance

03Troubleshooting 'MCP connection failed' errors within Claude Code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pdugan20/claudelint validate-mcp

For use in Claude.ai and ChatGPT

Download Skill