📐 LLMFeed Schema

Official JSON Schema validation for .llmfeed.json files

Why Use Schemas?

JSON schemas ensure your .llmfeed.json files are correctly structured, helping agents understand your data reliably and preventing validation errors.

Validation

Catch errors before agents see them

IntelliSense

Auto-completion in VS Code & IDEs

Compliance

Follow MCP standard requirements

Available Schema Files

Canonical

Production-ready schema for all LLMFeed validation

schema.llmfeed.json

Official validation standard

Annotated

Schema with developer comments and guidance

schema.annotated.llmfeed.json

Learning & documentation

Lite

Minimal schema for drafts and prompts

schema.lite.llmfeed.json

Rapid prototyping

Quick Downloads

Schema Usage Examples

Basic Export Feed with Schema

Reference the canonical schema in your .llmfeed.json files:

{
  "$schema": "https://wellknownmcp.org/.well-known/schema.llmfeed.json",
  "feed_type": "export",
  "metadata": {
    "title": "My Documentation Export",
    "origin": "https://mysite.com/docs",
    "created_at": "2025-06-19T10:30:00Z",
    "description": "Complete API documentation with examples"
  },
  "content": {
    "documentation": "...",
    "examples": [...]
  },
  "trust": {
    "signed_blocks": ["metadata", "content"],
    "trust_level": "self-declared"
  }
}

Advanced MCP Feed with Capabilities

Use the annotated schema for complex capabilities and trust validation:

{
  "$schema": "https://wellknownmcp.org/.well-known/schema.annotated.llmfeed.json",
  "feed_type": "mcp",
  "metadata": {
    "title": "API Service Capabilities",
    "origin": "https://api.myservice.com"
  },
  "capabilities": [
    {
      "name": "search_documents",
      "description": "Search through document database",
      "input_schema": {
        "type": "object",
        "properties": {
          "query": { "type": "string" },
          "limit": { "type": "number", "maximum": 100 }
        },
        "required": ["query"]
      },
      "output_schema": {
        "type": "array",
        "items": { "$ref": "#/definitions/Document" }
      }
    }
  ],
  "trust": {
    "signed_blocks": ["all"],
    "trust_level": "certified",
    "certifier": "https://llmca.org"
  }
}

IDE Integration & Tools

VS Code Setup

Add to your settings.json for automatic validation:

{
  "json.schemas": [
    {
      "fileMatch": ["*.llmfeed.json"],
      "url": "https://wellknownmcp.org/.well-known/schema.llmfeed.json"
    }
  ]
}

CLI Validation

Validate feeds using ajv-cli:

# Install AJV CLI
npm install -g ajv-cli

# Validate your feed
ajv validate -s schema.llmfeed.json -d my-feed.llmfeed.json

🛠️ Development Tools

VS Code IntelliSense

JetBrains IDEs support

CLI validation tools

CI/CD integration

Pre-commit hooks

Browser extensions

Schema Validation Tool

Coming Soon: Interactive Validator

Drop your .llmfeed.json file here and validate it against our schemas with real-time feedback, structure suggestions, and compliance checking.

Features in Development:

Live validation with error highlighting

Structure suggestions and auto-fixes

MCP compliance checking

Advanced Features:

Trust signature verification

Performance optimization hints

Security best practices audit

Want early access?

The validator is in active development. Join our community to get early access and help shape the tool.