← All explainers
A field guide to agent-ready websites

WebMCP gives every website a tool menu for AI.

A page can describe the actions it supports in a structured form an agent can discover and invoke—inside the browser, alongside the person using it.

Experimental standard · Live implementations
01 · Mental model

A restaurant menu, for a website.

The analogy

A menu names what the kitchen can make and what choices the diner must provide. Nobody needs to inspect every appliance.

The reality

A website publishes named tools with descriptions and input schemas. An agent can choose a tool and supply structured arguments.

02 · System map

The page becomes an explicit collaborator.

PERSONSets the goal

Uses the same visible web app and remains responsible for consequential choices.

INTENT
BROWSER AGENTChooses a tool

Reads the page’s tool definitions and supplies the required arguments.

CALL
WEB PAGERuns its logic

Executes JavaScript in the page’s authenticated, origin-scoped context.

The browser is the meeting place. The person, agent, page state, and application logic share one active experience.

03 · Distribution

Experimental does not mean hypothetical.

The specification is still evolving, but several large platforms already cover different parts of the path from a website publishing a tool to an agent using it.

SHIPPEDChatGPT

The desktop app’s built-in browser can discover and call WebMCP tools out of the box.

SHIPPEDShopify

Every Liquid storefront publishes catalog, cart, checkout, and order-navigation tools.

EXPERIMENTALChrome

Browser support is available through an experimental flag and origin trial.

PREVIEWCloudflare

An edge-injected bridge can add a WebMCP interface without changing origin code.

ECOSYSTEMNetlify · Vercel · Render

Infrastructure partners are funding examples, tooling, hosting, and the WebMCP Challenge.

The distinction matters: shipped runtime support, experimental browser support, and ecosystem sponsorship are different commitments—but together they create meaningful distribution.

04 · One request

From “find a flight” to a structured result.

01RegisterThe page exposes a tool such as search_flights.
02DiscoverThe agent reads its name, description, and expected inputs.
03ChooseThe agent matches the user’s goal to that capability.
04ExecuteThe page receives structured arguments and runs its own logic.
05ReturnThe result informs the agent and can update the shared interface.
05 · The important contrast

Less guessing. More declared intent.

PIXELSSee and click

The agent interprets the rendered interface like a person. Flexible, but mistakes are easy.

DOMInspect structure

The agent searches page elements and accessibility labels. Better signals, but still infers the workflow.

WEBMCPCall a tool

The site explicitly names the action, inputs, and implementation the agent should use.

WebMCP complements the human interface. It does not make clear labels, usable forms, or accessible design optional.

06 · Try the tool menu

One page, several capabilities.

READ-ONLY TOOL

search_products

Find products matching a query and price ceiling.

{ "query": "desk lamp", "maxPrice": 80 }
07 · Two ways to publish

Describe a form—or register code.

DECLARATIVEAnnotate HTML

A form can declare its tool name, purpose, and parameter descriptions.

IMPERATIVERegister JavaScript

Complex or dynamic behavior can be exposed through document.modelContext.registerTool().

The proposal is evolving. The exact API surface can change while browser experiments and specification work continue.

08 · What crosses the boundary

A contract, a call, and a result.

DISCOVERTool contract

Name, title, description, input schema, and behavioral hints.

INVOKEArguments

A structured object containing only what the selected tool expects.

RESPONDResult

Data produced by page logic, returned to the calling agent.

WebMCP runs in the page. Unlike a typical backend MCP server, the tool can use current UI state and the user’s existing signed-in session.

09 · Trust boundaries

A clearer interface is not automatic permission.

Descriptions can mislead

A tool’s label cannot prove what its implementation will actually do.

Sessions carry authority

A signed-in page may be able to purchase, publish, modify, or delete.

Inputs can reveal too much

An over-specified schema can invite an agent to share unnecessary personal context.

Outputs remain untrusted

Tool results can contain hostile or misleading content, including prompt injection.

High-consequence actions still need narrow scope, truthful descriptions, server-side authorization, visible review, and explicit confirmation.

10 · Why leaders should care

The website becomes a product surface for agents.

Web teams have traditionally designed pages for people and APIs for software. WebMCP suggests a third surface: structured capabilities for agents working beside a person in the browser.

The durable decision is not “Should we add WebMCP everywhere?” It is: Which user goals deserve an explicit, bounded action—and what must remain visible and confirmable?

11 · Keep this model

The page publishes the verbs.

01The person supplies intent

The agent acts in service of a goal, not merely because a tool exists.

02The site defines capability

Tools turn supported actions into explicit contracts.

03The browser holds context

Page state, authentication, and interaction remain close together.

04Trust still needs design

Structured access improves reliability; it does not remove risk or responsibility.