MCP Server

Access Kubernetes and CRD schemas programmatically via the Model Context Protocol

Back to Home

Overview

The r35 Schemas MCP server exposes all Kubernetes core resource schemas, CRD schemas, and r35 Network custom schemas through the Model Context Protocol. This allows AI assistants and developer tools to look up, search, and validate against these schemas directly.

Server URL: https://schemas-mcp.r35.dev

Available Tools

list_schemas

List all available schema categories and versions. Returns an overview of Kubernetes versions, CRD groups, and r35 schemas.

get_schema

Retrieve a specific schema by type and name. Supports Kubernetes core resources, CRDs by API group, and r35 custom schemas.

find_schema

Search for schemas by keyword. Useful when you know what you're looking for but not the exact name or API group.

validate_url

Validate and return the schema URL for a given resource. Useful for YAML language server configuration and editor integration.

Setup

Claude Code

CLI

Add the MCP server to your Claude Code project using the CLI:

claude mcp add kube-schemas https://schemas-mcp.r35.dev/mcp

This adds the server to your project's .mcp.json configuration.

Claude Desktop

App

Add to your Claude Desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "kube-schemas": {
      "url": "https://schemas-mcp.r35.dev/mcp"
    }
  }
}

MCPHub / mcphub.nvim

Neovim

Add to your servers.json or MCPHub configuration:

{
  "kube-schemas": {
    "url": "https://schemas-mcp.r35.dev/mcp"
  }
}

Cursor

IDE

Add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "kube-schemas": {
      "url": "https://schemas-mcp.r35.dev/mcp"
    }
  }
}

Windsurf

IDE

Add to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kube-schemas": {
      "serverUrl": "https://schemas-mcp.r35.dev/mcp"
    }
  }
}

Other MCP Clients

Generic

For any MCP-compatible client, use the Streamable HTTP endpoint:

https://schemas-mcp.r35.dev/mcp

Transport: Streamable HTTP. No authentication required.

Use Cases

YAML Validation

Ask your AI assistant to validate Kubernetes manifests against the correct schema version. The MCP server provides the exact schema URL for any resource type.

CRD Discovery

Search across hundreds of CRD schemas from popular operators like cert-manager, ArgoCD, Flux, Crossplane, and more.

Manifest Authoring

Let your AI assistant look up the correct field names, types, and required properties when writing Kubernetes resources.

Editor Integration

Get schema URLs for configuring YAML language servers in VS Code, Neovim, or any editor with YAML schema support.