OpenChainGraph · Explainer register · discover · call · verify

WebMCP: the pages on this estate that an agent can call

This page is for practitioners who want their browser tools to be reachable by AI agents without standing up a server. On this estate, WebMCP means that a published page registers the tool it carries, an agent discovers that registration in one machine-readable file, the agent calls the tool, and the artifact that comes back verifies through a public utility. Each step below draws one link in that loop, and the directory at the end lists every WebMCP surface here with a link you can follow.

Presenter mode shows one step per screen. Arrow keys move, A toggles autoplay, Esc exits.
Every registration lives in a file any agent can fetch: .well-known/webmcp.json, with a signed snapshot beside it. Read it after this page and the loop below stops being a drawing.
1
Step 1 · The loop

The loop from registration to verified answer

A tool page publishes a registration for the kernel it carries. An agent that knows nothing about the site fetches one well-known file and finds that registration by name. The agent calls the tool with its arguments, the page runs it client-side, and the artifact that comes back carries a hash the agent can confirm with the public verify_execution_hash utility before it trusts the answer.

The WebMCP loop from registration to verified artifact A browser page registers a tool, an agent discovers the tool through the .well-known/webmcp.json file, calls it, and the artifact that comes back verifies through verify_execution_hash. A dot travels from station to station as each step completes. Your page registers the tool it carries tool registration Discovery .well-known/ webmcp.json one fetch, every tool Agent calls arguments in, result out, run in the browser Verify verify_execution_hash artifact confirms The agent trusts the answer only after the hash checks out, and a person can recompute the same check.

The registration and the discovery file are the contract; nothing about the loop depends on where the agent runs. The signed snapshot beside the discovery file lets a verifier confirm that the registrations it read today are the ones the estate published. Verification closes the loop: a tool that answers without a recomputable artifact is a claim, and this estate ships tools that ship evidence.

Who asks at this stepagent, first contact
Fetch https://ainumbers.co/.well-known/webmcp.json and list the tools registered on the estate.
2
Step 2 · The doorways

Where the tools live

Registrations sit on real pages, and each page is a doorway an agent (or you) can open. The tool pages of the ChainGraph suite carry one kernel each. Three explainers and the field-notes guide walk the ideas behind the loop, and two demo guides carry working tools with nothing else attached. Every station below links to its page.

A map of the pages that register tools on this estate The discovery file sits at the left and lines fan out to six groups of pages: the ChainGraph tool pages, three WebMCP explainers, two demo guides and the field-notes guide. Every station is a link to its page. Discovery file .well-known/webmcp.json every doorway, named ChainGraph tool pages, one kernel each WebMCP Doorways: the three doors to one tool WebMCP Workflow: an agent drives a full workflow MCP and WebMCP on Helm: the served twin WebMCP demos 1 and 2, plus the field notes Every card is a live link. The demos live under guides/: guides/webmcp-demo-1.html guides/webmcp-demo-2.html and the practitioner notes: guides/webmcp-field-notes.html

The doorway map doubles as the reading order. If you want the ideas first, the doorways explainer shows the three doors to a single tool, the workflow explainer strings tools together, and the Helm explainer covers the served twin of the browser surfaces. If you want your hands on a tool immediately, either demo guide runs one end to end in your browser.

Who asks at this stepreader choosing a door
Which pages on ainumbers.co register WebMCP tools, and what does each one carry?
3
Step 3 · Meta budgets

How registrations stay small enough to fetch

A discovery file is only useful while it stays cheap to read, so every tool registration passes through a lint before it ships. The budget rule set bounds each tool name and description, and the check-webmcp-meta-budgets gate reports any registration that outgrows its budget. Declare the tool within budget, let the lint read it, then ship it into the discovery file.

Declare, lint, ship: the meta budget pipeline A tool registration is declared within its budget, the check-webmcp-meta-budgets gate lints it and pulses once on the pass, and the registration ships into the discovery file. Declare name and description, each inside its budget Lint check-webmcp-meta-budgets pass Ship .well-known/webmcp.json readable by any agent The budget check runs in the estate's own gate suite, so a registration that grows fat is caught before an agent ever fetches it.

The gate runs in report mode by default and as a down-only ratchet against a pinned baseline, so the estate can sweep old violations over time while the count never climbs back up. The budgets themselves follow a published community rule set for tool metadata, ported with attribution rather than copied bytes.

Who asks at this stepmaintainer adding a tool
Check the WebMCP metadata budgets for the tool I just registered on my page.
4
Step 4 · Directory

Every WebMCP surface on this estate

Start here if you arrived from the MCP server page or sent someone here from it: that page covers the served MCP endpoint, and this page covers the browser side every WebMCP registration lives on. Each card below is one surface with a real link.

Discovery file

.well-known/webmcp.json holds every tool registration on the estate. This is the one file an agent fetches first.

Signed snapshot

.well-known/webmcp-signed.json is the signed twin of the discovery file, so a verifier can confirm the registrations it read are the ones published.

ChainGraph tool pages

The ChainGraph suite carries one registered tool per page, each backed by a kernel whose artifact verifies.

WebMCP Doorways

The doorways explainer shows the three doors an agent can use to reach one kernel, with one published input run through all three.

WebMCP Workflow

The workflow explainer follows an agent calling several registered tools in sequence, with the receipts at each hop.

MCP and WebMCP on Helm

The Helm explainer covers the served deployment and how it mirrors the browser registrations.

WebMCP demos

Demo 1 and demo 2 are working tools you can run in the browser or hand to an agent.

Field notes

The field-notes guide records what publishing WebMCP tools in production taught the maintainers.

For the server-side twin of this story, the MCP server page lists the served tools and the handshake; the two pages link to each other on purpose.

  • Fetch .well-known/webmcp.json and confirm every tool you saw on the pages above appears with its name and page.
  • Pick any registered tool page, run it in your browser, and confirm the artifact it returns verifies through verify_execution_hash.
๐Ÿ”’ All inputs are processed locally in your browser. No data is transmitted. Do not enter real personal data โ€” use synthetic or anonymised inputs only.