specification.website WebMCP audit

Rescan
audited Aug 28, 2026in 4s
60/ 100

5 tools registered. Strongest in usefulness, weakest in human experience.

WebMCP use73
Usefulness80
Human experience0
about:blank

No agent run recorded yet.

No steps recorded

Tools

/
search_spec: warning

search_spec

Search The Website Specification for matching topics. Returns ranked results with title, status, category, canonical URL, and a one-line summary. Use this when the user asks about a topic by keyword (e.g. "CSP", "alt text", "llms.txt").Answers a question. Declared read only.
pagehttps://specification.website/
implementation
viaimperative
entry pointdocument
registered after259ms
executepresent
api surface
queryrequired
limitoptional
annotations
read onlytrue
destructivenot declared
idempotentnot declared
open worldnot declared
untrusted contentnot declared
titlenot declared
2 findings
warningSchema quality
0.8 / 4
4 of 5 tool schemas are harder for an agent to use than they need to be: search_spec 1 parameter has no description (limit).
search_spec: 1 parameter has no description (limit); list_topics: declares no required list, so an agent cannot tell which parameters are mandatory; open_search: declares no required list, so an agent
fix
{
  name: "search_spec",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "What to search for" }
    },
    required: ["query"]
  }
}
warningHuman parity
0 / 8
5 of 5 tools run through the JavaScript API with no visible counterpart, so the person co-browsing cannot see what the agent is offered. Declarative forms (or at least a title annotation) close the gap.
search_spec, list_topics, get_topic, open_search, open_checklist
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_spec" tooldescription="...">
  <!-- the same action, as UI -->
</form>
tool json
{
  "name": "search_spec",
  "description": "Search The Website Specification for matching topics. Returns ranked results with title, status, category, canonical URL, and a one-line summary. Use this when the user asks about a topic by keyword (e.g. \"CSP\", \"alt text\", \"llms.txt\").",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text query.",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 25,
        "default": 5
      }
    },
    "required": [
      "query"
    ]
  },
  "annotations": {
    "readOnlyHint": true
  }
}
Showing search_spec

Findings

WebMCP use

73 / 100 · weight 50
passTools registered
4 / 4
5 tools registered across 1 page.
failReal-browser eligible
0 / 8
The page's code registers these tools, but a real visitor's browser does not get them yet: WebMCP needs a native modelContext or a current origin trial token, and this page has neither.
passRegistration timing
4 / 4
Every measured tool registered within 259.09999990463257ms of navigation.
toollist_topics
passCanonical entry point
4 / 4
All 5 tools register on the canonical document.modelContext entry point.
passSchema validity
5 / 5
All 5 tools declare a structurally valid object input schema.
warningSchema quality
0.8 / 4
4 of 5 tool schemas are harder for an agent to use than they need to be: search_spec 1 parameter has no description (limit).
toolsearch_spec
search_spec: 1 parameter has no description (limit); list_topics: declares no required list, so an agent cannot tell which parameters are mandatory; open_search: declares no required list, so an agent
fix
{
  name: "search_spec",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "What to search for" }
    },
    required: ["query"]
  }
}
passStub detection
5 / 5
All 5 tools declare an execute handler.
passAnnotations present
4 / 4
All 5 tools declare a readOnlyHint, so an agent knows which calls change state.
passAnnotation mismatch
3 / 3
No tool claims to be read-only while its name says it writes (5 declared hints checked).
not applicableUntrusted content hint
0 / 2
No tool's contract suggests it returns text written by somebody other than the site, so there is nothing to flag as untrusted.
passRegistration errors
2 / 2
No tool registration threw during the capture.
warningToolchange coherence
1 / 2
5 tools were registered but the page never dispatched a toolchange event, so an agent subscribed to registry updates never learns they exist.
fix
document.modelContext.dispatchEvent(new Event("toolchange"));
not applicableInjection surface
0 / 3
The injection-surface model hop returned no usable result, so tool contracts were not reviewed for injection surface.

Usefulness

80 / 100 · weight 30
warningNaming quality
1.6 / 2
Tool naming makes selection harder than it needs to be: 2 names do not start with a verb (open_search).
toolopen_search
fix
{ name: "open_search" /* short, unique, verb-based */ }
not applicableDescription quality
0 / 6
The description-quality model hop returned no usable result, so descriptions were not rated.
not applicableTool selection
0 / 14
The tool-selection model hop returned no usable result.
not applicableCoverage vs. site type
0 / 8
This tool set does not place the site in a category with a known expected tool shape, so there is no coverage baseline to score it against.

Human experience

0 / 100 · weight 20
warningHuman parity
0 / 8
5 of 5 tools run through the JavaScript API with no visible counterpart, so the person co-browsing cannot see what the agent is offered. Declarative forms (or at least a title annotation) close the gap.
toolsearch_spec
search_spec, list_topics, get_topic, open_search, open_checklist
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_spec" tooldescription="...">
  <!-- the same action, as UI -->
</form>
not applicablePage experience
0 / 12
The page-experience model hop returned no usable result, so the page was not graded.

Tool selection

The tool-selection model hop returned no usable result.
how this was captured
chrome
148.0.7778.96
capture shim
v1
spec snapshot
2026-08
mode
fast
pages
1
tools
5
run time
4s
finished
Aug 28, 2026