mattpyle.com WebMCP audit

Rescan
audited Aug 28, 2026in 6s
73/ 100

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

WebMCP use87
Usefulness98
Human experience0
about:blank

No agent run recorded yet.

No steps recorded

Tools

/
describe_site: fail

describe_site

Describe mattpyle.com: who the author is, what the site is, and which sections it has. Call this first for context about the site you're on.Takes an action on the site.
pagehttps://www.mattpyle.com/
implementation
viaimperative
entry pointdocument
registered after816ms
executepresent
api surfaceTakes no parameters.
annotations
read onlynot declared
destructivenot declared
idempotentnot declared
open worldnot declared
untrusted contentnot declared
titlenot declared
2 findings
failAnnotations present
0 / 4
6 of 6 tools declare no readOnlyHint, so an agent cannot tell a read from a write without guessing from the name.
describe_site, get_recent_writing, search_content, set_appearance, sign_guestbook
fix
{
  name: "describe_site",
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
}
warningHuman parity
0 / 8
6 of 6 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.
describe_site, get_recent_writing, search_content, set_appearance, sign_guestbook
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="describe_site" tooldescription="...">
  <!-- the same action, as UI -->
</form>
tool json
{
  "name": "describe_site",
  "description": "Describe mattpyle.com: who the author is, what the site is, and which sections it has. Call this first for context about the site you're on.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "annotations": {}
}
Showing describe_site

Findings

WebMCP use

87 / 100 · weight 50
passTools registered
4 / 4
6 tools registered across 1 page.
passReal-browser eligible
8 / 8
A real browser exposes modelContext natively on this page, so the tools registered here are visible to an agent today.
passRegistration timing
4 / 4
Every measured tool registered within 816.1000001430511ms of navigation.
toolget_recent_writing
passCanonical entry point
4 / 4
All 6 tools register on the canonical document.modelContext entry point.
passSchema validity
5 / 5
All 6 tools declare a structurally valid object input schema.
warningSchema quality
3.3 / 4
1 of 6 tool schemas are harder for an agent to use than they need to be: get_recent_writing declares no required list, so an agent cannot tell which parameters are mandatory.
toolget_recent_writing
get_recent_writing: declares no required list, so an agent cannot tell which parameters are mandatory
fix
{
  name: "get_recent_writing",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "What to search for" }
    },
    required: ["query"]
  }
}
passStub detection
5 / 5
All 6 tools declare an execute handler.
failAnnotations present
0 / 4
6 of 6 tools declare no readOnlyHint, so an agent cannot tell a read from a write without guessing from the name.
tooldescribe_site
describe_site, get_recent_writing, search_content, set_appearance, sign_guestbook
fix
{
  name: "describe_site",
  annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
}
not applicableAnnotation mismatch
0 / 3
No tool declares a readOnlyHint, so there is no safety claim to contradict.
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
6 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

98 / 100 · weight 30
warningNaming quality
1.8 / 2
Tool naming makes selection harder than it needs to be: 1 name does not start with a verb (sign_guestbook).
toolsign_guestbook
fix
{ name: "sign_guestbook" /* 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.
passCoverage vs. site type
8 / 8
The tool set covers the whole core docs flow: search or browse the catalog, read a page or article, navigate the documentation tree.

Human experience

0 / 100 · weight 20
warningHuman parity
0 / 8
6 of 6 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.
tooldescribe_site
describe_site, get_recent_writing, search_content, set_appearance, sign_guestbook
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="describe_site" 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
6
run time
6s
finished
Aug 28, 2026