WebMCP schema validity
Stay organized with collections
Save and categorize content based on your preferences.
A valid schema ensures that the AI agent understands the structure of the data
it needs to provide.
How the WebMCP schema validity audit fails
The audit fails if:
- A form has a
tooldescription but is missing the toolname attribute.
- A form has a
toolname but is missing the tooldescription attribute.
- A required form field is missing a
name attribute.
Lighthouse also issues a warning if an optional field has a name but is
missing a toolparamdescription or an associated <label>.
How to fix
- Ensure symmetry: Always provide both a name and a description for every
tool.
- Add names to inputs: Verify that every input element within a tool form has
a unique
name attribute.
- Provide parameter context: Add
toolparamdescription to inputs to help the
agent understand what value is expected.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-05 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-05-05 UTC."],[],[]]
