MCP Schema Validator: Test & Debug MCP Server Schemas

Popular Developer Tools tools

• JWT DecoderDecode, inspect, and validate JWT tokens with claim and signature analysis.
• Cron ParserParse, validate, explain, and build cron expressions with next run times and visual timeline.
• Regex TesterTest, debug, and explain regular expressions with real-time match highlighting.
• Regex ExplainerBreak down any regex into plain English, token by token.
• AI Prompt BuilderBuild structured LLM prompts with per-section token counting, variable injection, and provider-aware exports for OpenAI, Anthropic, and Google.

How to MCP Schema Validator Online

1. 1

   Paste or upload your Model Context Protocol (MCP) server definition, manifest, or tools/list JSON-RPC payload into the editor (supports JSON and YAML).

2. 2

   Select an action mode from the top toolbar: Validate (⌘⇧V) to check compliance, Format (⌘⇧F) to standardize formatting, Summary (⌘⇧S) to inspect server metadata, or Test to simulate parameter validation.

3. 3

   Configure indentation and target serialization format (JSON, YAML, or match input) to match your development workflow.

4. 4

   Review the interactive Issues panel highlighting validation errors, severity ratings (ERROR / WARNING), and exact JSON pointer paths (e.g., tools[0].inputSchema.properties.query).

5. 5

   Click on any detected issue to jump directly to the relevant line in your schema and apply recommended corrections for tool names or JSON Schema constraints.

6. 6

   Copy the validated and formatted manifest to your clipboard (⌘⇧C) or export it directly into your claude_desktop_config.json or Cursor MCP server settings.

MCP Schema Validator Features

• ✓

  Official MCP 2024-11 Specification Compliance: Validates server initialization manifests, protocol versions, capabilities maps, and tool array structures against Anthropic MCP standards.

• ✓

  Strict Tool Naming Regex Validation: Enforces the mandatory ^[a-zA-Z0-9_-]+$ naming pattern across all tool identifiers to prevent client-side registration failures in Claude and Cursor.

• ✓

  AJV-Powered JSON Schema Draft 07 Engine: Compiles and validates each tool inputSchema using AJV with comprehensive ajv-formats support (e.g., email, uri, date-time, uuid, ipv4).

• ✓

  Object-Root inputSchema Enforcement: Flags common anti-patterns such as primitive string or array root schemas, verifying that inputSchema is always a well-formed JSON object.

• ✓

  Bidirectional JSON & YAML Conversion: Seamlessly converts and formats MCP specifications between JSON and YAML with customizable indentation (2, 4, or 8 spaces).

• ✓

  Interactive Parameter Testing Sandbox: Simulates tool execution by testing sample argument payloads against your tool inputSchema definitions before deploying to production.

• ✓

  Server Metadata & Summary Extraction: Aggregates server name, semantic version, capabilities (tools, resources, prompts), and tool catalogs into a clear readable overview.

• ✓

  Deep Object Tree Traversal: Calculates structural nesting depth and byte size metrics to prevent token bloat and context window exhaustion in LLM agent workflows.

• ✓

  Multi-Document & Anchor YAML Parsing: Safely parses complex YAML manifests utilizing reusable anchors, aliases, and multi-line literal block scalar descriptions.

• ✓

  Required Properties & Nullability Checks: Verifies that properties declared in the required array correspond to existing definitions in the properties dictionary.

• ✓

  Enum & Pattern Constraint Auditing: Validates string enum arrays, numeric minimum/maximum boundaries, and ECMA-262 regular expression patterns within tool arguments.

• ✓

  Real-Time Live Auto-Validation: Asynchronous input debouncing provides immediate visual feedback and line-level error highlights as you draft tool contracts.

• ✓

  Productive Keyboard Navigation: Accelerate agent development with ⌘↵ to execute, ⌘⇧V to validate, ⌘⇧F to format, ⌘⇧S to summarize, and ⌘⇧C to copy results.

• ✓

  Programmatic Node.js REST API: Integrates with CI/CD validation pipelines via GET and POST endpoints at /api/tools/mcp-schema-validator for automated linting.

• ✓

  Zero-Telemetry Confidential Privacy: 100% client-side JavaScript execution guarantees that proprietary tool signatures, database schemas, and API definitions never leave your machine.

• ✓

  Seamless AI Tooling Ecosystem Handshake: Directly cross-compatible with DevFlow LLM JSON Schema Generator, Prompt Injection Scanner, and AI Token Counter.

Supported Formats & Dialects

The MCP Schema Validator supports 6 syntax formats and dialects for accurate parsing and processing.

MCP 2024-11-05 Core Specification

The foundational release of the Model Context Protocol specifying JSON-RPC 2.0 handshake structures, serverInfo objects (name, version), protocolVersion strings, and capability matrices.

Tool inputSchema (JSON Schema Draft 07)

The parameter contract dialect used within MCP tool definitions, requiring root object types, named property definitions, type constraints, and explicit required argument arrays validated via AJV.

Server Capabilities Declaration

Structural capability maps defining whether an MCP server provides tools (executable functions), resources (passive file/context data), prompts (reusable templates), or logging endpoints.

JSON-RPC 2.0 tools/list & tools/call Messages

Standardized JSON-RPC request and response envelopes exchanged over stdio or Server-Sent Events (SSE) transports between host AI clients and local or remote MCP servers.

YAML Server Manifests

Human-readable YAML representations of MCP server configurations commonly used in container definitions, Kubernetes manifests, and developer dotfiles.

Host Client Configurations (Claude Desktop & Cursor)

Configuration files (such as claude_desktop_config.json and .cursor/mcp.json) that register MCP server command-line invocations, environment variables, and tool bindings.

Frequently Asked Questions

What is the Model Context Protocol (MCP) and how does it standardize AI agent integrations?

The Model Context Protocol (MCP) is an open-source, vendor-neutral standard introduced by Anthropic in late 2024. Modeled after the Language Server Protocol (LSP) in software development, MCP replaces fragmented, custom tool-calling integrations with a unified JSON-RPC 2.0 interface. It enables AI clients—such as Claude Desktop, Cursor, and DevFlow agents—to discover, inspect, and invoke tools, query external data resources, and execute pre-configured prompts across local and remote servers without writing bespoke API connectors.

What structural properties does the MCP 2024-11 specification require?

A valid MCP 2024-11 server initialization manifest must contain: (1) schema or protocolVersion set to "2024-11-05" or a recognized specification string; (2) serverInfo as an object containing at least a name and version; (3) capabilities as an object advertising supported features such as tools, resources, or prompts; and (4) tools as an array or object containing valid tool declarations with name, optional description, and inputSchema.

Why does MCP enforce the strict ^[a-zA-Z0-9_-]+$ tool naming regex?

MCP tool names must match the regular expression ^[a-zA-Z0-9_-]+$, permitting only alphanumeric characters, underscores, and hyphens. Spaces, periods, slashes, colons, and special characters are strictly prohibited because host AI clients map tool names directly into programming language function calls and LLM grammar tokenizers. Invalid names (such as "get weather" or "db.query") cause runtime schema compilation exceptions in client environments.

How does AJV validate tool inputSchema definitions against JSON Schema Draft 07?

Each tool parameter contract is evaluated using AJV (Another JSON Schema Validator) configured with Draft 07 meta-schema rules and ajv-formats extensions. AJV validates that property types (string, number, integer, boolean, array, object) are valid, checks structural keywords (properties, required, additionalProperties, enum), and validates semantic format strings (such as email, uri, date-time, uuid, and ipv4). If a schema contains malformed syntax, AJV returns line and instance path pointers for rapid correction.

How should optional vs required parameters be modeled in an MCP inputSchema?

In JSON Schema Draft 07 for MCP, all parameters declared in the properties map are considered optional by default unless explicitly listed in the top-level required array. To mark a parameter as mandatory for the LLM to provide, add its exact key name to required: ["parameterName"]. For nullable optional parameters, define the type as a union (e.g., "type": ["string", "null"]) or provide a default value so the LLM understands expected fallback behavior.

What is the distinction between MCP Tools, Resources, and Prompts capabilities?

MCP divides server functionality into three primary capabilities: (1) Tools represent executable actions with side effects (such as database writes, git commits, or API calls) that require structured JSON Schema parameters and user confirmation; (2) Resources represent passive, read-only data feeds (such as local file contents, server logs, or schema documentation) that an LLM can attach to its context window; and (3) Prompts represent pre-built, parameterized interaction templates that guide user conversations.

Does the MCP Schema Validator support both JSON and YAML server configurations?

Yes. The validator includes an automatic format detection engine that transparently recognizes JSON and YAML inputs. You can paste a YAML server specification and format or validate it directly, or convert it to standard JSON with 2, 4, or 8 space indentation. The parser fully supports YAML 1.2 features including block scalars, reusable anchors (&) and aliases (*), and multi-line descriptive strings.

How can developers test tool parameter validation prior to server deployment?

The validator features an interactive Test action mode that compiles your tool inputSchema definitions and runs simulated argument payloads against AJV validation rules. You can provide mock arguments in JSON format and instantly observe whether the arguments pass or fail validation, complete with detailed error messages explaining which properties were missing, invalid, or out of range.

How do you handle $ref and $defs schema references inside MCP tool parameters?

Under the MCP specification, host clients often evaluate each tool inputSchema in isolation without an external network resolver. Therefore, any internal reusable definitions referenced via $ref: "#/$defs/MyType" must be co-located directly inside the tool inputSchema $defs or definitions dictionary. Self-contained schemas prevent unresolvable pointer errors during client-side LLM tool dispatching.

Why is 100% client-side zero-telemetry validation essential for MCP development?

MCP servers frequently expose proprietary enterprise capabilities—such as internal microservice endpoints, production database schemas, custom business logic, and private environment variables. Sending tool schemas to third-party web servers introduces severe data exposure risks. DevFlow runs the entire parsing, linting, and AJV compilation pipeline directly inside your browser sandbox, guaranteeing zero network transmission of your architecture.

How does the MCP Schema Validator integrate with LLM JSON Schema and Prompt Scanner?

The MCP Schema Validator is part of DevFlow's AI developer toolkit. When designing structured AI tool outputs, developers can use the LLM JSON Schema Generator to synthesize strict schemas, validate tool definitions with the MCP Schema Validator, check prompt safety with the Prompt Injection Scanner, and calculate prompt token usage with the AI Token Counter before deploying MCP servers to production.

How do you troubleshoot common MCP handshake errors in Claude Desktop and Cursor?

Common MCP connection failures in Claude Desktop and Cursor typically stem from three issues: (1) Schema errors where inputSchema is missing "type": "object" or contains invalid tool names; (2) Environment path misconfigurations in claude_desktop_config.json where node or python binary paths are not absolute; and (3) Unhandled stdout logging in stdio servers where debugging console.log statements corrupt the JSON-RPC message stream. Use this validator to eliminate all schema and naming errors first.

Related Developer Tools

• LLM JSON Schema GeneratorGenerate JSON Schema for LLM structured outputs — OpenAI, Anthropic, Gemini, Ollama.
• JSON Schema Visualizer & Tree ExplorerRender Draft-07 / 2020-12 JSON Schemas into interactive visual trees, documentation diagrams, and realistic mock data.
• Prompt Injection & Secret ScannerScan prompts, code, and text for prompt injection patterns, secret leaks, unsafe instructions, and PII exposure.
• AI Token CounterCount tokens and estimate API costs for 100+ LLMs with exact BPE and provider tokenization.
• AI Cost CalculatorModel and compare LLM API spend across 120+ providers for any workload with prompt caching and batch pricing.
• JSON to TypeScript & Schema GeneratorGenerate TypeScript interfaces, Zod schemas, and Valibot schemas from JSON.
• OpenAPI ValidatorValidate, format, and summarize OpenAPI/Swagger specifications.
• YAML ConverterConvert between JSON and YAML with validation, formatting, and multi-document support.
• JSON Repair ToolRepair and fix malformed JSON data from AI outputs, API responses, and copy-paste.
• JSON FormatterPrettify, minify, and validate JSON data instantly.