Validation Tools

Complete MCP Feed Validation Ecosystem

Validation at Every Stage

From development to production, ensure feed quality and compliance

🎯 Why Validation Matters

  • • Agent compatibility: Ensure feeds work across all agents
  • • Early error detection: Catch issues before deployment
  • • Compliance verification: Meet MCP specification standards
  • • Performance optimization: Identify bottlenecks and inefficiencies

🚀 Validation Stages

  • • Development: IDE integration + real-time feedback
  • • Testing: CLI validation + automated testing
  • • Deployment: CI/CD pipelines + quality gates
  • • Production: Monitoring + health checks

🔧 Validation Ecosystem Overview

IDE Integration

Real-time validation while coding

CLI Tools

Command-line validation automation

Browser Tools

Web-based validation interface

CI/CD Pipeline

Automated deployment validation

✅ Available Now

Schema Validation

JSON Schema validation for all feed types

Use Tool

Canonical Schema

Complete specification validation

  • • All required fields validated
  • • Type checking and constraints
  • • Cross-field validation rules

Annotated Schema

Detailed error messages and guidance

  • • Human-readable error descriptions
  • • Fix suggestions and examples
  • • Best practice recommendations

Lite Schema

Fast validation for CI/CD pipelines

  • • Core validation only
  • • Optimized for speed
  • • Perfect for automated testing

LLMFeedHub

Web-based validation and testing platform

Open Hub

🔍 Validation Features

  • Drag & drop file validation
  • URL-based feed testing
  • Real-time error highlighting
  • Agent simulation testing

🚀 Testing Capabilities

  • Agent interpretation preview
  • Signature verification
  • Performance analysis
  • Feed dependency checking

Verification API

Programmatic validation for automated workflows

Try API
# Validate a feed via API
curl -X POST https://wellknownmcp.org/api/verify \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/.well-known/mcp.llmfeed.json"}'

# Response
{
  "valid": true,
  "score": 95,
  "checks": {
    "schema": "pass",
    "signature": "pass", 
    "performance": "pass"
  },
  "warnings": [],
  "recommendations": ["Add capabilities feed"]
}
Real-time validation
JSON response format
Rate limit friendly

🚧 In Development

CLI Validation Tools

Command-line tools for developer workflows

Coming Q3 2025

🔧 Planned Features

  • • mcp validate - Single feed validation
  • • mcp test - Agent simulation testing
  • • mcp lint - Code style and best practices
  • • mcp watch - Continuous validation mode

📦 Installation Preview

# Installation (coming soon)
npm install -g @wellknownmcp/cli
# or
pip install wellknownmcp-cli

# Usage
mcp validate ./feeds/
mcp test --agent-simulation
mcp lint --fix

IDE Integration

Real-time validation in VS Code, JetBrains, and more

Coming Q4 2025

VS Code Extension

  • • Real-time schema validation
  • • Autocomplete for feed properties
  • • Error highlighting and fixes
  • • Built-in agent simulation

JetBrains Plugin

  • • IntelliJ IDEA support
  • • WebStorm integration
  • • PyCharm compatibility
  • • Unified validation experience

Language Servers

  • • LSP protocol support
  • • Vim/Neovim integration
  • • Emacs support
  • • Universal editor compatibility

Browser Extension

Validate feeds directly in the browser

Coming 2026

🌐 Browser Features

  • • Auto-detect MCP feeds on websites
  • • One-click validation from context menu
  • • Visual indicators for feed quality
  • • Export feeds for agent testing

🔧 Developer Tools

  • • DevTools panel integration
  • • Network request monitoring
  • • Performance profiling
  • • Agent behavior simulation

🔄 CI/CD Integration Patterns

Automated Validation Workflows

Integrate MCP feed validation into your deployment pipeline to catch issues early and ensure production quality.

🚀 GitHub Actions

name: Validate MCP Feeds
on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Validate Feeds
        uses: wellknownmcp/validate-action@v1
        with:
          path: '.well-known/'
          strict: true
          agent_simulation: true

🐳 Docker Integration

# Dockerfile validation step
FROM wellknownmcp/validator:latest AS validator
COPY .well-known/ /feeds/
RUN mcp validate /feeds/ --strict

# Your app build...
FROM node:18-alpine
COPY --from=validator /feeds/ .well-known/
# Continue build...
✅ Pre-merge Validation

Validate feeds before code reaches main branch

🚫 Quality Gates

Block deployment if validation fails

📊 Performance Monitoring

Track feed quality metrics over time

🧰 SDK Integration

SDK Documentation Coming Soon

Comprehensive SDK documentation for programmatic validation will be added here.

JavaScript SDK

@wellknownmcp/validator

Python SDK

wellknownmcp-validator

Go SDK

github.com/wellknownmcp/validator

SDK documentation will cover programmatic validation, custom rules, and integration patterns.

Explore SDK (Coming Soon)

🚀 Getting Started

📋 Quick Start Checklist

🗺️ Validation Roadmap

Q2 2025 - Foundation (Complete)

Schema validation, LLMFeedHub, and Verification API

Q3 2025 - CLI Tools

Command-line validation suite for developer workflows

Q4 2025 - IDE Integration

VS Code extension and JetBrains plugin for real-time validation

2026 - Advanced Tools

Browser extension, advanced analytics, and AI-powered validation

📤 Export This Guide