Methodology
WebMCP declarative API
ia.webmcp-declarative · 4.1
Act
SHOULD
Recommendation
AR-ACT-07
AgentReady requirement
Why it matters
WebMCP form annotations describe potential browser tools. Static source inspection does not execute the tools or verify that a signed-in task can finish.
How to fix it
Annotate your main forms with WebMCP toolname and tooldescription attributes.
-
Add toolname and tooldescription to each form that agents may use.
<form toolname="search" tooldescription="Search products by keyword"> <input name="q" toolparamdescription="Search keywords"> </form> -
Or register tools in JavaScript with document.modelContext.registerTool().
document.modelContext.registerTool({ name: "search", description: "Search products", inputSchema: {type: "object", properties: {q: {type: "string"}}}, execute: async ({q}) => ({content: []}) });
Verify
curl -sf https://{domain}/
Expected: The HTML contains a form with toolname and tooldescription attributes
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.webmcp-declarative
Details Mapping, lifecycle and references
- AR mapping
- Direct relation
- Evidence source
- agentready.org AR-ACT-07
- Score role
- Informational
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-30