knock.app WebMCP audit

Name: knock.app WebMCP audit
Creator: ora

Rescan

audited Aug 28, 2026in 6s

41/ 100

4 tools registered. Strongest in WebMCP use, weakest in human experience.

WebMCP use62

Usefulness35

Human experience0

about:blank

No agent run recorded yet.

No steps recorded

Tools

search_pages

Search the Knock marketing site for pages matching a free-text query. Returns matching pages with their path, title, and description. Use this to help a user find the right page before navigating.Answers a question. Declared read only.

pagehttps://knock.app/

implementation

viaimperative

entry pointnavigator

registered after436ms

executepresent

api surface

queryrequired

limitoptional

annotations

read onlytrue

destructivenot declared

idempotentnot declared

open worldnot declared

untrusted contentnot declared

titlenot declared

2 findings

failCanonical entry point

0 / 4

Every tool registers through the deprecated navigator.modelContext alias; move them to document.modelContext before the alias is removed.

fix

// Use the canonical entry point - navigator.modelContext is deprecated.
document.modelContext.provideContext({ tools: [/* ... */] });

warningHuman parity

0 / 8

4 of 4 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_pages, navigate_to_page, subscribe_to_newsletter, open_contact_sales

fix

<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_pages" tooldescription="...">
  <!-- the same action, as UI -->
</form>

tool json

{
  "name": "search_pages",
  "description": "Search the Knock marketing site for pages matching a free-text query. Returns matching pages with their path, title, and description. Use this to help a user find the right page before navigating.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search query. Matches title, description, path, and keywords (case-insensitive)."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 25,
        "default": 10,
        "description": "Maximum number of results to return."
      }
    },
    "required": [
      "query"
    ]
  },
  "annotations": {
    "readOnlyHint": true
  }
}

Findings

WebMCP use

62 / 100 · weight 50

passTools registered

4 / 4

4 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 435.7000000476837ms of navigation.

toolnavigate_to_page

failCanonical entry point

0 / 4

Every tool registers through the deprecated navigator.modelContext alias; move them to document.modelContext before the alias is removed.

toolsearch_pages

fix

// Use the canonical entry point - navigator.modelContext is deprecated.
document.modelContext.provideContext({ tools: [/* ... */] });

passSchema validity

5 / 5

All 4 tools declare a structurally valid object input schema.

passSchema quality

4 / 4

All 4 tool schemas describe their parameters and stay within Chrome's size guidance.

passStub detection

5 / 5

All 4 tools declare an execute handler.

warningAnnotations present

1 / 4

3 of 4 tools declare no readOnlyHint, so an agent cannot tell a read from a write without guessing from the name.

toolnavigate_to_page

navigate_to_page, subscribe_to_newsletter, open_contact_sales

fix

{
  name: "navigate_to_page",
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
}

passAnnotation mismatch

3 / 3

No tool claims to be read-only while its name says it writes (1 declared hint checked).

warningUntrusted content hint

0 / 2

1 of 1 tools look like they return text written by other people but declare no untrustedContentHint, so an agent will treat the response as the site speaking.

toolsubscribe_to_newsletter

subscribe_to_newsletter: user, email

fix

{ name: "subscribe_to_newsletter", annotations: { untrustedContentHint: true } }

passRegistration errors

2 / 2

No tool registration threw during the capture.

warningToolchange coherence

1 / 2

4 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

35 / 100 · weight 30

warningNaming quality

1.5 / 2

Tool naming makes selection harder than it needs to be: 2 names do not start with a verb (navigate_to_page).

toolnavigate_to_page

fix

{ name: "navigate_to_page" /* 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.

failCoverage vs. site type

2 / 8

The tool set covers 1 of the 4 things an agent needs on a saas site; it cannot read one item in detail or create a record or start a job or update or move an existing record.

Human experience

0 / 100 · weight 20

warningHuman parity

0 / 8

toolsearch_pages

search_pages, navigate_to_page, subscribe_to_newsletter, open_contact_sales

fix

<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_pages" 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: 4
run time: 6s
finished: Aug 28, 2026