Declarative form quality

Why it matters

High-quality declarative annotations help AI agents understand form purpose, field semantics, and expected input - reducing errors and improving tool invocation accuracy.

How to fix it

Give each WebMCP form a clear tool name, a description and parameter descriptions.

1. Use a snake_case toolname that names the action.

2. Add toolparamdescription and a label to each field.

   <form toolname="search_products" tooldescription="Search products by keyword and category">
     <label for="q">Query</label>
     <input id="q" name="q" toolparamdescription="Search keywords">
   </form>

Verify

Run a new scan for this checkpoint: