com.vaadin/docs-mcp

{
  "checks": {
    "action_safety_probe": {
      "details": {
        "auth_present": false,
        "confirmation_signals": [],
        "safeguard_count": 0,
        "summary": {
          "bulk_access_tools": 0,
          "capability_distribution": {
            "admin": 3,
            "filesystem": 2,
            "network": 1,
            "read": 10,
            "secrets": 1,
            "write": 1
          },
          "destructive_tools": 0,
          "egress_tools": 0,
          "exec_tools": 0,
          "high_risk_tools": 0,
          "risk_distribution": {
            "critical": 0,
            "high": 0,
            "low": 7,
            "medium": 3
          },
          "secret_tools": 1,
          "tool_count": 10
        }
      },
      "latency_ms": null,
      "status": "ok"
    },
    "advanced_capabilities_probe": {
      "details": {
        "capabilities": {
          "completions": false,
          "elicitation": false,
          "prompts": false,
          "resource_links": false,
          "resources": false,
          "roots": false,
          "sampling": false,
          "structured_outputs": false
        },
        "enabled": [],
        "enabled_count": 0,
        "initialize_capability_keys": [
          "tools"
        ]
      },
      "latency_ms": null,
      "status": "missing"
    },
    "connector_publishability_probe": {
      "details": {
        "blockers": [
          "server_card"
        ],
        "criteria": {
          "action_safety": true,
          "auth_flow": true,
          "connector_replay": true,
          "initialize": true,
          "protocol_version": true,
          "remote_transport": true,
          "request_association": true,
          "server_card": false,
          "session_resume": true,
          "step_up_auth": true,
          "tool_surface": true,
          "tools_list": true,
          "transport_compliance": true
        },
        "high_risk_tools": 0,
        "tool_count": 10,
        "transport": "streamable-http"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "connector_replay_probe": {
      "details": {
        "added_tools": [],
        "additive_output_changes": [],
        "backward_compatible": true,
        "output_breaks": [],
        "removed_tools": [],
        "required_arg_breaks": [],
        "would_break_after_refresh": false
      },
      "latency_ms": null,
      "status": "ok"
    },
    "determinism_probe": {
      "details": {
        "attempts": 2,
        "baseline_signature": "e5f812a6c1d8314fd8825310b9e94ad398e17d6bb52c4705a34ab89cb2120d88",
        "errors": [],
        "matches": 2,
        "stable_ratio": 1.0,
        "successful": 2
      },
      "latency_ms": 197.76,
      "status": "ok"
    },
    "initialize": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=15552000"
        },
        "http_status": 200,
        "payload": {
          "id": 1,
          "jsonrpc": "2.0",
          "result": {
            "capabilities": {
              "tools": {
                "listChanged": true
              }
            },
            "protocolVersion": "2025-03-26",
            "serverInfo": {
              "name": "vaadin-mcp",
              "version": "0.8.0"
            }
          }
        },
        "url": "https://mcp.vaadin.com/docs/"
      },
      "latency_ms": 315.52,
      "status": "ok"
    },
    "interactive_flow_probe": {
      "details": {
        "oauth_supported": false,
        "prompt_available": false,
        "risk_hits": [],
        "safe_hits": [
          "browser"
        ]
      },
      "latency_ms": null,
      "status": "ok"
    },
    "oauth_authorization_server": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "oauth_protected_resource": {
      "details": {
        "error": "Client error '404 Not Found' for url 'https://mcp.vaadin.com/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
        "url": "https://mcp.vaadin.com/.well-known/oauth-protected-resource"
      },
      "latency_ms": 288.11,
      "status": "error"
    },
    "official_registry_probe": {
      "details": {
        "direct_match": true,
        "official_peer_count": 1,
        "registry_identifier": "com.vaadin/docs-mcp",
        "registry_source": "official_registry"
      },
      "latency_ms": null,
      "status": "ok"
    },
    "openid_configuration": {
      "details": {
        "reason": "no_authorization_server"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "probe_noise_resilience": {
      "details": {
        "headers": {
          "content-type": "text/plain; charset=utf-8"
        },
        "http_status": 404,
        "url": "https://mcp.vaadin.com/robots.txt"
      },
      "latency_ms": 290.5,
      "status": "ok"
    },
    "prompt_get": {
      "details": {
        "reason": "not_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "prompts_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=15552000"
        },
        "http_status": 200,
        "payload": {
          "error": {
            "code": -32601,
            "message": "Method not found"
          },
          "id": 3,
          "jsonrpc": "2.0"
        },
        "reason": "not_supported",
        "url": "https://mcp.vaadin.com/docs/"
      },
      "latency_ms": 290.9,
      "status": "missing"
    },
    "protocol_version_probe": {
      "details": {
        "claimed_version": "2025-03-26",
        "lag_days": 244,
        "latest_known_version": "2025-11-25",
        "releases_behind": 2,
        "validator_protocol_version": "2025-03-26"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "provenance_divergence_probe": {
      "details": {
        "direct_official_match": true,
        "drift_fields": [],
        "metadata_document_count": 1,
        "registry_homepage": null,
        "registry_repository": null,
        "registry_title": null,
        "registry_version": null,
        "server_card_homepage": null,
        "server_card_repository": null,
        "server_card_title": null,
        "server_card_version": null
      },
      "latency_ms": null,
      "status": "ok"
    },
    "request_association_probe": {
      "details": {
        "reason": "no_request_association_capabilities_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "resource_read": {
      "details": {
        "reason": "not_advertised"
      },
      "latency_ms": null,
      "status": "missing"
    },
    "resources_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=15552000"
        },
        "http_status": 200,
        "payload": {
          "error": {
            "code": -32601,
            "message": "Method not found"
          },
          "id": 5,
          "jsonrpc": "2.0"
        },
        "reason": "not_supported",
        "url": "https://mcp.vaadin.com/docs/"
      },
      "latency_ms": 314.5,
      "status": "missing"
    },
    "server_card": {
      "details": {
        "error": "Client error '404 Not Found' for url 'https://mcp.vaadin.com/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
        "url": "https://mcp.vaadin.com/.well-known/mcp/server-card.json"
      },
      "latency_ms": 323.29,
      "status": "error"
    },
    "session_resume_probe": {
      "details": {
        "protocol_version": "2025-03-26",
        "reason": "no_session_id",
        "resume_expected": true,
        "transport": "streamable-http"
      },
      "latency_ms": null,
      "status": "warning"
    },
    "step_up_auth_probe": {
      "details": {
        "auth_required_checks": [],
        "broad_scopes": [],
        "challenge_headers": [],
        "minimal_scope_documented": false,
        "oauth_present": false,
        "scope_specificity_ratio": 0.0,
        "step_up_signals": [],
        "supported_scopes": []
      },
      "latency_ms": null,
      "status": "missing"
    },
    "tool_snapshot_probe": {
      "details": {
        "added": [],
        "changed_outputs": [],
        "current_tool_count": 10,
        "previous_tool_count": 10,
        "removed": [],
        "similarity": 1.0
      },
      "latency_ms": null,
      "status": "ok"
    },
    "tools_list": {
      "details": {
        "headers": {
          "content-type": "text/event-stream",
          "strict-transport-security": "max-age=15552000"
        },
        "http_status": 200,
        "payload": {
          "id": 2,
          "jsonrpc": "2.0",
          "result": {
            "tools": [
              {
                "description": "IMPORTANT: Always use this tool FIRST before working with Vaadin. Returns a comprehensive primer document with current (2025+) information about modern Vaadin development. This addresses common AI misconceptions about Vaadin and provides up-to-date information about Java vs React development models, project structure, components, and best practices. Essential reading to avoid outdated assumptions. For legacy versions (7, 8, 14), returns guidance on version-specific resources.",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\". For legacy versions (7, 8, 14), returns guidance on version-specific resources.",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_vaadin_primer",
                "title": "Vaadin Primer"
              },
              {
                "description": "Search Vaadin documentation for relevant information about Vaadin development, components, and best practices. Uses hybrid semantic + keyword search. USE THIS TOOL for questions about: Vaadin components (Button, Grid, Dialog, etc.), TestBench, UI testing, unit testing, integration testing, @BrowserCallable, Binder, DataProvider, validation, styling, theming, security, Push, Collaboration Engine, PWA, production builds, Docker, deployment, performance, and any Vaadin-specific topics. When using this tool, try to deduce the correct development model from context: use \"java\" for Java-based views, \"react\" for React-based views, or \"common\" for both. Use get_full_document with file_paths containing the result's file_path when you need complete context.",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "max_results": {
                      "description": "Maximum number of results to return (default: 5)",
                      "maximum": 20,
                      "minimum": 1,
                      "type": "number"
                    },
                    "max_tokens": {
                      "description": "Maximum number of tokens to return (default: 1500)",
                      "maximum": 5000,
                      "minimum": 100,
                      "type": "number"
                    },
                    "question": {
                      "description": "The search query or question about Vaadin. Will be used to query a vector database with hybrid search (semantic + keyword).",
                      "type": "string"
                    },
                    "ui_language": {
                      "description": "The UI implementation language: \"java\" for Java-based views, \"react\" for React-based views, or \"common\" for both. If not specified, the agent should try to deduce the correct language from context or asking the user for clarification.",
                      "enum": [
                        "java",
                        "react",
                        "common"
                      ],
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "question",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "search_vaadin_docs",
                "title": "Search Vaadin Documentation"
              },
              {
                "description": "Retrieves complete documentation pages for one or more file paths. Use this when you need full context beyond what search results provide. Provide file_paths only (array).",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "file_paths": {
                      "description": "Array of file paths from search results. Use this to fetch one or more documents in a single call.",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    }
                  },
                  "required": [
                    "file_paths"
                  ],
                  "type": "object"
                },
                "name": "get_full_document",
                "title": "Get Full Document"
              },
              {
                "description": "Returns the latest stable version of Vaadin Core as a simple JSON object. This is useful when setting up new projects, checking for updates, or when helping with dependency management. Returns: {version, released}.",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {},
                  "type": "object"
                },
                "name": "get_vaadin_version",
                "title": "Get Vaadin Version"
              },
              {
                "description": "Returns a comprehensive list of components available in a specific Vaadin version, including component names, React component names, Java class names, and npm packages.",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "version": {
                      "description": "The Vaadin version as a minor version (e.g., '24.8', '24.9', '25.0')",
                      "type": "string"
                    }
                  },
                  "required": [
                    "version"
                  ],
                  "type": "object"
                },
                "name": "get_components_by_version",
                "title": "Get Components by Version"
              },
              {
                "description": "Returns the Java API documentation for a specific Vaadin component. The component name can be in any format (e.g., 'Button', 'button', 'vaadin-button').",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "component_name": {
                      "description": "The name of the component (e.g., 'Button', 'button', 'TextField', 'text-field')",
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "component_name",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_component_java_api",
                "title": "Get Component Java API"
              },
              {
                "description": "Returns the React API documentation for a specific Vaadin component. The component name can be in any format (e.g., 'Button', 'button', 'vaadin-button').",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "component_name": {
                      "description": "The name of the component (e.g., 'Button', 'button', 'TextField', 'text-field')",
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "component_name",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_component_react_api",
                "title": "Get Component React API"
              },
              {
                "description": "Returns the Web Component/TypeScript API documentation for a specific Vaadin component by fetching from external TypeScript API docs. The component name can be in any format (e.g., 'Button', 'button', 'vaadin-button').",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "component_name": {
                      "description": "The name of the component (e.g., 'Button', 'button', 'TextField', 'text-field')",
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "component_name",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_component_web_component_api",
                "title": "Get Component Web Component (TypeScript) API"
              },
              {
                "description": "Returns the styling/theming documentation for a specific Vaadin component. Returns both Java and React styling documentation when available. The component name can be in any format (e.g., 'Button', 'button', 'vaadin-button').",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "component_name": {
                      "description": "The name of the component (e.g., 'Button', 'button', 'TextField', 'text-field')",
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "component_name",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_component_styling",
                "title": "Get Component Styling"
              },
              {
                "description": "Returns CSS custom properties documentation for a specific Vaadin theme (Aura, Lumo, or Base styles). Use this to look up the correct CSS variables for the theme the application is using. Base style properties (--vaadin-*) are available in all themes.",
                "inputSchema": {
                  "$schema": "http://json-schema.org/draft-07/schema#",
                  "additionalProperties": false,
                  "properties": {
                    "theme": {
                      "description": "The theme to get CSS custom properties for: \"aura\" (Vaadin 25+ default), \"lumo\" (classic theme), or \"base\" (base styles available in all themes, Vaadin 25+ only).",
                      "enum": [
                        "aura",
                        "lumo",
                        "base"
                      ],
                      "type": "string"
                    },
                    "vaadin_version": {
                      "description": "Required. Vaadin version: \"7\", \"8\", \"14\", \"24\", \"25.0\", \"25.1\", or \"25.2\".",
                      "enum": [
                        "7",
                        "8",
                        "14",
                        "24",
                        "25.0",
                        "25.1",
                        "25.2"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "theme",
                    "vaadin_version"
                  ],
                  "type": "object"
                },
                "name": "get_theme_css_properties",
                "title": "Get Theme CSS Properties"
              }
            ]
          }
        },
        "url": "https://mcp.vaadin.com/docs/"
      },
      "latency_ms": 315.64,
      "status": "ok"
    },
    "transport_compliance_probe": {
      "details": {
        "bad_protocol_error": null,
        "bad_protocol_headers": {
          "strict-transport-security": "max-age=15552000"
        },
        "bad_protocol_payload": {
          "error": {
            "code": -32000,
            "message": "Bad Request: Unsupported protocol version (supported versions: 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07)"
          },
          "id": null,
          "jsonrpc": "2.0"
        },
        "bad_protocol_status_code": 400,
        "delete_error": null,
        "delete_status_code": null,
        "expired_session_error": null,
        "expired_session_status_code": null,
        "issues": [
          "missing_session_id",
          "missing_protocol_header"
        ],
        "last_event_id_visible": false,
        "protocol_header_present": false,
        "requested_protocol_version": "2025-03-26",
        "session_id_present": false,
        "transport": "streamable-http"
      },
      "latency_ms": 297.67,
      "status": "warning"
    },
    "utility_coverage_probe": {
      "details": {
        "completions": {
          "advertised": false,
          "live_probe": "not_executed",
          "sample_target": null
        },
        "initialize_capability_keys": [
          "tools"
        ],
        "pagination": {
          "metadata_signal": false,
          "next_cursor_methods": [],
          "supported": false
        },
        "tasks": {
          "advertised": true,
          "http_status": 200,
          "probe_status": "error"
        }
      },
      "latency_ms": 97.97,
      "status": "warning"
    }
  },
  "failures": {
    "oauth_authorization_server": {
      "reason": "no_authorization_server"
    },
    "oauth_protected_resource": {
      "error": "Client error '404 Not Found' for url 'https://mcp.vaadin.com/.well-known/oauth-protected-resource'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
      "url": "https://mcp.vaadin.com/.well-known/oauth-protected-resource"
    },
    "openid_configuration": {
      "reason": "no_authorization_server"
    },
    "server_card": {
      "error": "Client error '404 Not Found' for url 'https://mcp.vaadin.com/.well-known/mcp/server-card.json'\nFor more information check: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404",
      "url": "https://mcp.vaadin.com/.well-known/mcp/server-card.json"
    }
  },
  "remote_url": "https://mcp.vaadin.com/docs/",
  "server_card_payload": null,
  "server_identifier": "com.vaadin/docs-mcp"
}