Skip to content
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.

  1. 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>
  2. 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
Score role
Informational
Introduced
2026-08-24
Methodology version
2026-10-30

Checkpoint data (JSON)