🔍 Complete JSON Data
{
"feed_type": "capabilities",
"metadata": {
"origin": "https://wellknownmcp.org",
"title": "Enhanced MCP Declaration for wellknownmcp.org",
"description": "Technical capabilities focusing on HTML-embedded JSON format, feed validation, multi-format support, and LLM tool compatibility. Revolutionary approach to agent-web interaction.",
"lang": "en",
"feed_type": "capabilities",
"version": "2.2.0",
"last_updated": "2025-06-24T07:46:51.865070Z"
},
"trust": {
"signed_blocks": [
"feed_type",
"metadata",
"trust",
"agent_guidance",
"data",
"references"
],
"trust_level": "demonstration",
"agent_hint": "Enhanced capabilities with HTML-embedded JSON format for maximum LLM tool compatibility. This addresses a critical gap in agent-web interaction.",
"public_key_hint": "https://wellknownmcp.org/.well-known/public.pem",
"canonicalization": "https://llmca.org/mcp-canonical-json/v1",
"scope": "full",
"warning": "This feed is fully signed.",
"algorithm": "Ed25519"
},
"signature": {
"value": "uza7yms/KFFZd682kbmN8Rm1HCa9V8jWCWdYECIg9yLiAMw48Gyund5krGKOJ9lpGjzmfKp8QW050mUceSCkDQ==",
"created_at": "2025-06-25T21:27:49.537202+00:00"
},
"_meta": {
"signed_at": "2025-06-25T21:27:49.537202+00:00"
},
"agent_guidance": {
"on_load": "This domain offers universal feed loading with both JSON and HTML formats. Use HTML-embedded format when JSON navigation fails in web tools. IMPORTANT: The HTML API only serves valid LLMFeed structures.",
"suggested_actions": [
"Try HTML format (/api/feed-html) if JSON endpoints fail in web tools",
"Use the enhanced LLMFeedHub for universal feed analysis",
"Leverage multi-format support to maximize compatibility",
"HTML format provides same JSON data with better tool navigation",
"Validate feeds before expecting HTML format to work"
],
"format_selection_guidance": {
"for_web_tools": "Use HTML-embedded format for reliable navigation of valid LLMFeeds",
"for_apis": "Use JSON format for programmatic access",
"for_humans": "HTML format provides visual inspection capabilities",
"for_seo": "HTML format enhances search engine discovery",
"for_validation": "HTML API will reject invalid LLMFeed structures with helpful error pages"
},
"validation_awareness": {
"api_requirements": "The /api/feed-html endpoint requires valid LLMFeed structure",
"minimum_fields": "feed_type and metadata must be present",
"error_handling": "Invalid feeds receive 422 status with fix suggestions",
"quality_assurance": "This validation maintains feed ecosystem integrity"
}
},
"data": [
{
"type": "site_capabilities",
"llm_readable": true,
"human_readable": true,
"agent_invocable": true,
"feeds_signed": true,
"educational": true,
"editable": true,
"trust_level": "certified-by-llmca.org",
"universal_feed_loading": true,
"cors_proxy_enabled": true,
"external_url_support": true,
"feed_validation": "advanced",
"signature_verification": true,
"multi_format_support": true,
"html_embedded_json": true,
"llm_tool_optimized": true,
"instant_training_system": true,
"agent_compatibility_testing": true,
"preview_and_validation": true
},
{
"type": "revolutionary_training_system",
"name": "Instant LLM Training & Agent Onboarding",
"description": "Revolutionary 30-second training system that transforms any LLM into an MCP expert with 99%+ success rate",
"url": "https://wellknownmcp.org/train",
"prompt_feed": "https://wellknownmcp.org/.well-known/prompts/shortcut.llmfeed.json",
"technical_specs": {
"training_duration": "30 seconds",
"success_rate": "99%+",
"feed_sources": 3,
"fallback_methods": 2,
"total_timeout": "3 minutes maximum"
},
"training_protocol": {
"phase_1": "Knowledge acquisition (fault-tolerant feed loading)",
"phase_2": "Confirmation response ('🥋 I know kung fu' message)",
"phase_3": "Immediate assistance offer (specific MCP services)",
"phase_4": "Adaptive behavior based on success/failure"
},
"validation_test": {
"name": "Kung Fu Compatibility Test",
"trigger": "Say 'I know kung fu' to trained LLM",
"expected_response": "MCP-aware expert response with implementation offers",
"purpose": "Verify successful knowledge acquisition and understanding"
}
},
{
"type": "new_feature",
"name": "HTML-Embedded JSON Format with LLMFeed Validation",
"description": "Revolutionary approach to serve validated LLMFeed files wrapped in LLM-friendly HTML for maximum tool compatibility and ecosystem integrity",
"benefits": [
"Resolves LLM web tool navigation failures",
"Provides visual inspection for humans",
"Includes semantic metadata and SEO optimization",
"Ensures only valid LLMFeed content is served"
],
"target_problem": "ChatGPT, Claude and other LLM web tools often fail with raw JSON endpoints",
"solution": "Serve only validated LLMFeeds as semantic HTML with embedded JSON and strict validation"
},
{
"type": "api_endpoint",
"name": "feed-html-format",
"description": "Serves ONLY valid LLMFeed files as HTML-embedded JSON for LLM tool compatibility. Validates feed structure before serving.",
"url": "https://wellknownmcp.org/api/feed-html",
"method": "GET",
"validation_required": true,
"parameters": {
"slug": "Local export file slug (without .llmfeed.json extension)",
"wellknown": "Well-known file name (without .llmfeed.json extension)",
"external": "External URL to fetch via CORS proxy"
},
"validation_rules": {
"required_fields": [
"feed_type (or feedtype)",
"metadata object"
],
"valid_feed_types": [
"mcp",
"export",
"capabilities",
"session",
"prompt",
"credential",
"index",
"llm-index",
"news",
"spec"
],
"rejection_criteria": [
"Missing feed_type/feedtype field",
"Missing metadata object",
"Invalid JSON structure"
]
},
"response_format": "text/html",
"error_responses": {
"400": "Bad Request - Missing parameters",
"422": "Unprocessable Entity - Invalid LLMFeed structure with detailed validation errors",
"500": "Internal Server Error - Fetch or processing failure"
}
},
{
"type": "endpoint",
"name": "agent-training-system",
"description": "Complete training infrastructure for instant LLM expertise",
"url": "https://wellknownmcp.org/train",
"capabilities": [
"universal-prompt-generation",
"multi-llm-compatibility",
"success-rate-tracking"
],
"related_endpoints": {
"prompt_feed": "/.well-known/prompts/shortcut.llmfeed.json",
"training_sources": [
"/.well-known/exports/spec-essential.llmfeed.json",
"/.well-known/llm-index.llmfeed.json",
"/.well-known/exports/news-lite.llmfeed.json"
]
}
},
{
"type": "endpoint",
"name": "agent-compatibility-testing",
"description": "Test and preview system for agent-website compatibility",
"url": "https://wellknownmcp.org/preview",
"capabilities": [
"ai-readability-analysis",
"token-efficiency-measurement",
"compatibility-scoring"
],
"features": [
"Website AI compatibility analysis",
"Token efficiency scoring (targets 99.7%)",
"Agent readability assessment",
"Implementation recommendations"
]
},
{
"type": "endpoint",
"name": "llmfeedhub-enhanced",
"description": "Universal feed analyzer with multi-format support",
"url": "https://wellknownmcp.org/llmfeedhub/",
"capabilities": [
"local-file-loading",
"external-url-loading",
"cors-proxy",
"feed-validation",
"signature-verification"
],
"supported_formats": [
"application/json",
"application/llmfeed+json",
"text/html (with embedded JSON)",
"text/plain"
]
},
{
"type": "endpoint",
"name": "external-feed-proxy-enhanced",
"description": "Secure CORS proxy supporting both JSON and HTML output formats",
"url": "https://wellknownmcp.org/api/external-feed",
"enhanced_capabilities": [
"Multi-format output",
"Content-Type negotiation",
"LLM tool optimization"
],
"security_features": [
"URL validation",
"Private network blocking",
"15-second timeout",
"Content-Type validation"
]
},
{
"type": "compatibility_matrix",
"title": "LLM Tool Compatibility",
"tools": [
{
"name": "ChatGPT Web Tool",
"json_support": "unreliable",
"html_support": "excellent",
"recommendation": "Use HTML-embedded format"
},
{
"name": "Claude Web Tool",
"json_support": "moderate",
"html_support": "excellent",
"recommendation": "HTML format preferred"
},
{
"name": "Programmatic APIs",
"json_support": "excellent",
"html_support": "not_needed",
"recommendation": "Use JSON format"
}
]
},
{
"type": "routing_patterns",
"title": "Multi-Format Feed Access Patterns",
"patterns": [
{
"format": "JSON (original)",
"local": "/exports/{slug}.llmfeed.json",
"wellknown": "/.well-known/{name}.llmfeed.json"
},
{
"format": "HTML-Embedded (new)",
"local": "/api/feed-html?slug={slug}",
"wellknown": "/api/feed-html?wellknown={name}"
}
]
}
],
"references": [
{
"title": "Instant LLM Training System",
"url": "https://wellknownmcp.org/train",
"description": "Revolutionary 30-second training with 99%+ success rate"
},
{
"title": "Training Prompt Feed",
"url": "https://wellknownmcp.org/.well-known/prompts/shortcut.llmfeed.json",
"description": "Signed prompt feed for robust multi-LLM training"
},
{
"title": "Agent Compatibility Testing",
"url": "https://wellknownmcp.org/preview",
"description": "Test and optimize website AI readability"
},
{
"title": "HTML-Embedded JSON Demo",
"url": "https://wellknownmcp.org/api/feed-html?wellknown=mcp",
"description": "Site's MCP declaration in LLM-friendly HTML format"
}
]
}