giantmarkdown.com WebMCP audit

Rescan
audited Aug 28, 2026in 8s
50/ 100

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

WebMCP use68
Usefulness53
Human experience0
about:blank

No agent run recorded yet.

No steps recorded

Tools

/
search_giantmarkdown_project_information: warning

search_giantmarkdown_project_information

Find answers in GiantMarkdown's own project and FAQ information. Use only for general questions about the site's purpose, interface, author, licensing, or how to contact the operator. Do not use for supported formats, size limits, conversion behaviour, privacy, retention, embedded images, OCR, or vision models; use get_conversion_capabilities on the converter page for that complete contract. It does not answer from the open web. Formal result JSON Schema: {"type":"object","properties":{"query":{"type":"string"},"matches":{"type":"array","maxItems":5,"items":{"type":"object","properties":{"heading":{"type":"string"},"source_url":{"type":"string","format":"uri"},"content":{"type":"string"}},"required":["heading","source_url","content"],"additionalProperties":false}},"source_bundle":{"type":"string","format":"uri"},"site_authored_content":{"type":"boolean","const":true}},"required":["query","matches","source_bundle","site_authored_content"],"additionalProperties":false}. Machine-readable copy: https://www.giantmarkdown.com/webmcp-output-schemas.json#/$defs/search_giantmarkdown_project_information.Answers a question. Declared read only.
pagehttps://giantmarkdown.com/
implementation
viaimperative
entry pointdocument
registered after1644ms
executepresent
api surface
queryrequired
max_resultsoptional
annotations
read onlytrue
destructivenot declared
idempotentnot declared
open worldnot declared
untrusted contentnot declared
titlenot declared
3 findings
warningSchema quality
0 / 4
4 of 4 tool schemas are harder for an agent to use than they need to be: search_giantmarkdown_project_information description is 1111 characters, over Chrome's 500-character guidance.
search_giantmarkdown_project_information: description is 1111 characters, over Chrome's 500-character guidance; get_conversion_capabilities: description is 2587 characters, over Chrome's 500-character
fix
{
  name: "search_giantmarkdown_project_information",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "What to search for" }
    },
    required: ["query"]
  }
}
warningNaming quality
1.3 / 2
Tool naming makes selection harder than it needs to be: 1 name is over Chrome's 30-character guidance; 2 names do not start with a verb (convert_document_to_markdown).
fix
{ name: "search_giantmarkdown_project_information" /* short, unique, verb-based */ }
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_giantmarkdown_project_information, get_conversion_capabilities, convert_document_to_markdown, convert_documents_to_markdown
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_giantmarkdown_project_information" tooldescription="...">
  <!-- the same action, as UI -->
</form>
tool json
{
  "name": "search_giantmarkdown_project_information",
  "description": "Find answers in GiantMarkdown's own project and FAQ information. Use only for general questions about the site's purpose, interface, author, licensing, or how to contact the operator. Do not use for supported formats, size limits, conversion behaviour, privacy, retention, embedded images, OCR, or vision models; use get_conversion_capabilities on the converter page for that complete contract. It does not answer from the open web. Formal result JSON Schema: {\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"string\"},\"matches\":{\"type\":\"array\",\"maxItems\":5,\"items\":{\"type\":\"object\",\"properties\":{\"heading\":{\"type\":\"string\"},\"source_url\":{\"type\":\"string\",\"format\":\"uri\"},\"content\":{\"type\":\"string\"}},\"required\":[\"heading\",\"source_url\",\"content\"],\"additionalProperties\":false}},\"source_bundle\":{\"type\":\"string\",\"format\":\"uri\"},\"site_authored_content\":{\"type\":\"boolean\",\"const\":true}},\"required\":[\"query\",\"matches\",\"source_bundle\",\"site_authored_content\"],\"additionalProperties\":false}. Machine-readable copy: https://www.giantmarkdown.com/webmcp-output-schemas.json#/$defs/search_giantmarkdown_project_information.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "minLength": 3,
        "maxLength": 500,
        "description": "A focused question about GiantMarkdown."
      },
      "max_results": {
        "type": "integer",
        "minimum": 1,
        "maximum": 5,
        "default": 3,
        "description": "Maximum number of relevant site sections to return."
      }
    },
    "required": [
      "query"
    ],
    "minProperties": 1,
    "maxProperties": 2,
    "additionalProperties": false
  },
  "annotations": {
    "readOnlyHint": true
  }
}
Showing search_giantmarkdown_project_information

Findings

WebMCP use

68 / 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.
warningRegistration timing
2 / 4
The slowest tool took 1644.6000001430511ms to register, past the 1000ms an agent reading the registry at first paint would wait for.
toolconvert_documents_to_markdown
convert_documents_to_markdown: registered at 1644.6000001430511ms
fix
// Register tools as soon as they're ready, not behind a deferred/async chunk.
document.modelContext.provideContext({ tools: [/* ... */] });
passCanonical entry point
4 / 4
All 4 tools register on the canonical document.modelContext entry point.
passSchema validity
5 / 5
All 4 tools declare a structurally valid object input schema.
warningSchema quality
0 / 4
4 of 4 tool schemas are harder for an agent to use than they need to be: search_giantmarkdown_project_information description is 1111 characters, over Chrome's 500-character guidance.
toolsearch_giantmarkdown_project_information
search_giantmarkdown_project_information: description is 1111 characters, over Chrome's 500-character guidance; get_conversion_capabilities: description is 2587 characters, over Chrome's 500-character
fix
{
  name: "search_giantmarkdown_project_information",
  inputSchema: {
    type: "object",
    properties: {
      query: { type: "string", description: "What to search for" }
    },
    required: ["query"]
  }
}
passStub detection
5 / 5
All 4 tools declare an execute handler.
passAnnotations present
4 / 4
All 4 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 (4 declared hints checked).
passUntrusted content hint
2 / 2
All 1 tool that looks like it returns third-party text declares untrustedContentHint.
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

53 / 100 · weight 30
warningNaming quality
1.3 / 2
Tool naming makes selection harder than it needs to be: 1 name is over Chrome's 30-character guidance; 2 names do not start with a verb (convert_document_to_markdown).
toolsearch_giantmarkdown_project_information
fix
{ name: "search_giantmarkdown_project_information" /* 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.
warningCoverage vs. site type
4 / 8
The tool set covers 2 of the 4 things an agent needs on a saas site; it cannot create a record or start a job or update or move an existing record.

Human experience

0 / 100 · weight 20
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.
toolsearch_giantmarkdown_project_information
search_giantmarkdown_project_information, get_conversion_capabilities, convert_document_to_markdown, convert_documents_to_markdown
fix
<!-- Give the tool a visible counterpart: a declarative form is one the person can see and use too. -->
<form toolname="search_giantmarkdown_project_information" 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
8s
finished
Aug 28, 2026