← Rule catalog
lowexperimentalactionability

WebMCP surface present but its tools could not be enumerated

WEBMCP-002 · v1.0

What it detects

A WebMCP surface was detected on the page, but no tools could be enumerated from it (empty tool list or an enumeration error).

Why it matters

An agent that detects the surface still has nothing it can act on — a WebMCP surface with no discoverable tools is functionally absent to an agent.

How to fix

- Verify `navigator.modelContext.getTools()` (or its tools collection) returns the page's registered tools by the time the page finishes loading and settles (networkidle). - Check for a race between tool registration and page-load completion, or an unhandled error thrown inside the registration code — either will present as an empty or unreadable tool list to any agent. - Verify: load the page in a real browser and evaluate `navigator.modelContext.getTools()` (or equivalent) in the console after the page settles; confirm it returns a non-empty array.

References

Last reviewed: 2026-09-01 · rule v1.0