{"id":"ia.webmcp-form-quality","name":"Declarative form quality","verify":{"command":null,"rescan":"isagentready results {domain} --checkpoint ia.webmcp-form-quality","expect":null},"fix":{"steps":[{"action":"Use a snake_case toolname that names the action.","order":1,"language":null,"code_example":null},{"action":"Add toolparamdescription and a label to each field.","order":2,"language":"html","code_example":"<form toolname=\"search_products\" tooldescription=\"Search products by keyword and category\">\n  <label for=\"q\">Query</label>\n  <input id=\"q\" name=\"q\" toolparamdescription=\"Search keywords\">\n</form>"}],"summary":"Give each WebMCP form a clear tool name, a description and parameter descriptions.","skill":{"name":"agent-protocols","anchor":"ia.webmcp-form-quality"}},"category":"agent_protocols","aggregate":null,"references":[{"title":"WebMCP specification","kind":"guide","url":"https://webmachinelearning.github.io/webmcp/"},{"title":"WebMCP Chrome Early Preview","kind":"guide","url":"https://developer.chrome.com/blog/webmcp-epp"}],"stage":"act","lifecycle":{"introduced":"2026-08-24","revised":[],"retired":null,"replaced_by":null},"methodology_version":"2026-10-22","evidence_tier":"experimental","evidence_source":{"title":"agentready.org AR-ACT-07","url":"https://www.agentready.org/#act"},"why":"High-quality declarative annotations help AI agents understand form purpose, field semantics, and expected input - reducing errors and improving tool invocation accuracy.","profiles":["browser_agent_usability","api_tool_readiness"],"score_role":"informational","legacy_id":"4.7","i18n":{"nl":{"name":"Kwaliteit van declaratieve formulieren","steps":["Gebruik een toolname in snake_case die de actie noemt.","Voeg toolparamdescription en een label toe aan elk veld."],"why":"Goede declaratieve annotaties helpen AI-agents om het doel van een formulier, de velden en de verwachte input te begrijpen. Dat geeft minder fouten bij het aanroepen van tools.","fix_summary":"Geef elk WebMCP-formulier een duidelijke toolnaam, een beschrijving en parameterbeschrijvingen.","verify_expect":null}},"ar_practice_ids":["AR-ACT-07"],"strength":"SHOULD","ar_mapping":"full","evidence_type":"recommendation","detail_url":"https://isagentready.com/en/methodology/checkpoints/ia.webmcp-form-quality","maturity":"emerging","applicability":{"mode":"detected_surface","condition":null,"surfaces":["mcp"]}}