--- title: "What a Website Chooses to Tell an Agent" canonical: "https://current.tinyfish.ai/issue/32/foundations/article/18615/what-a-website-chooses-to-tell-an-agent" publication: "TinyFish" publisher: "TinyFish" language: "en-US" guide: "https://current.tinyfish.ai/llms.txt" format: "WebMCP Walkthrough" author: "Rina Takahashi" author_url: "https://current.tinyfish.ai/team/25" issue: 32 section: "foundations" section_name: "Foundations" published: 2026-06-03 updated: 2026-06-04 description: "When a website publishes structured tool definitions for browser agents, it publishes a selective model of itself that the agent inherits as truth." word_count: 737 source_links: 8 --- # What a Website Chooses to Tell an Agent *By [Rina Takahashi]()* *June 3, 2026* [Read on the website]() Right now, a browser agent trying to buy running shoes on an e-commerce site does roughly what a person would. Find the search bar, type a query, click, wait for results to render, then try to make sense of whatever the page displays. The agent is reading an interface built for human eyes and working backward to figure out what it means. Every layout change, every A/B test can break the sequence. [WebMCP](https://developer.chrome.com/docs/ai/webmcp), currently in a Chrome 149 origin trial and incubating in a [W3C community group](https://developer.chrome.com/blog/webmcp-epp) with Google and Microsoft co-authoring the spec, proposes something different. A website can publish structured tool definitions that tell an agent what actions are available, what inputs they expect, and what the response looks like. The agent calls `searchProducts("running shoes")` and gets back structured JSON. No screenshot parsing. No simulated clicks. WebMCP runs inside the browser tab, reusing the user's live session and cookies. Anthropic's MCP connects agents to backend servers via JSON-RPC. They solve problems at [different layers](https://developer.chrome.com/blog/webmcp-mcp-usage). The improvement is real. But so is the question it opens: who decides what the agent can see? ## Two Kinds of Editorial Choice WebMCP has two APIs, and each one represents a different kind of choice by the site operator. The [Declarative API](https://developer.chrome.com/docs/ai/webmcp/declarative-api) adds attributes to existing HTML forms. A newsletter signup gets a `toolname` and `tooldescription`; the browser auto-generates a schema from the form's fields. The form still works for humans, but agents can now see it as a callable tool. Progressive enhancement. A site with twelve forms might mark up three, though. Which forms get the attributes is already a selective representation, just a quieter one than writing JavaScript. The [Imperative API](https://developer.chrome.com/docs/ai/webmcp/imperative-api) is more deliberate. The site registers JavaScript functions with names, descriptions, typed input schemas, and execution handlers. A `searchProducts` tool might accept a `query` string and a `category` parameter constrained to an enum: `["all", "clothing", "electronics", "books"]`. Look at that enum. The actual product catalog almost certainly has more than four categories. Maybe "clearance" isn't listed. Maybe the full taxonomy runs fifty categories deep and the operator decided agents get a simplified view. The tool definition is a selective representation, and the agent has no way to know what was left out. ## What the Agent Inherits When a site publishes tool definitions, it's publishing its model of what matters about itself. The descriptions, the parameter names, the enum values, the return shapes. An agent receiving a `searchProducts` tool with a four-item category filter inherits that framing as the complete picture. There's no mechanism for the agent to ask "what else is there?" And these definitions aren't static. The site can update its enum, remove a tool, add parameters. The agent's world reshapes accordingly, with no notification mechanism and no versioning contract. Today's editorial choice can change tomorrow without the agent or its operator knowing. The practical status is early. Chrome 149 origin trial, [Gemini in Chrome](https://developer.chrome.com/docs/ai/agents) as the only current consumer, Firefox and Safari uncommitted. Performance claims circulating in developer blogs (67% fewer errors, 45% better task completion) trace to sources with [undisclosed methodology](https://arxiv.org/pdf/2508.09171). Treat them as directional. But the architectural pattern is already legible. Once a website publishes tool definitions, it functions as a contract the agent trusts. What the site included shapes what the agent can do. What the site omitted disappears from the agent's world. A new kind of editorial power over agent behavior, and so far, nobody is measuring what gets left out. ## Things to follow up on... - **Chrome's official WebMCP docs:** The [Chrome for Developers documentation](https://developer.chrome.com/docs/ai/webmcp) walks through both APIs with working code examples, including best practices on tool naming, schema design, and avoiding overlapping tool definitions. - **WebMCP versus backend MCP:** Chrome's team published a short guide on [when to use WebMCP and when to use MCP](https://developer.chrome.com/blog/webmcp-mcp-usage), which clarifies how the two coexist for sites that need both browser-side and server-side agent integration. - **The methodological fine print:** An arXiv paper (2508.09171) provides the closest thing to a [disclosed benchmark for WebMCP performance](https://arxiv.org/pdf/2508.09171), measuring token reduction and cost savings across 1,890 API calls rather than the "fewer errors" framing that circulates in developer blogs. - **Browser agents without structured tools:** Fordel Studios published a practitioner-level explainer on [how AI browser agents navigate the web today](https://fordelstudios.com/research/ai-browser-agents-new-automation-layer-2026), covering the hybrid architecture of selectors, accessibility trees, and vision that WebMCP aims to partially replace. ## More - [Foundations — Issue 32]() - [Issue 32]() - [Publication guide]()