cd /news/ai-agents/your-ai-agent-shouldnt-have-to-read-… · home topics ai-agents article
[ARTICLE · art-81941] src=dev.to ↗ pub= topic=ai-agents verified=true sentiment=↑ positive

Your AI Agent Shouldn’t Have to Read an Entire Website Just to Click a Button

A developer has built Universal WebMCP Runtime, an open-source tool that automatically converts existing website interfaces into structured WebMCP tool catalogs for AI agents. This approach reduces token usage dramatically—from 245,375 tokens for raw HTML to 1,332 tokens for a selected WebMCP tool—by letting agents invoke specific capabilities instead of parsing entire pages. The runtime, available via npm, discovers forms, buttons, and navigation, and generates schemas while preserving the original website experience.

read3 min views1 publishedJul 31, 2026

Imagine entering a restaurant where there is no menu.

To order lunch, you must walk into the kitchen, inspect every shelf, understand how the appliances work, and guess which ingredients belong together.

That is roughly how AI agents use most websites today.

When you ask an agent to search for a product, compare offers, fill out a form, or press a button, it often has to:

It works, but it is expensive, fragile, and unnecessarily complicated.

WebMCP offers a better idea: give the agent a menu.

WebMCP allows a website to expose structured tools directly to an AI agent.

Instead of interpreting the entire page, the agent can see capabilities such as:

search_products({ query })
filter_offers({ condition })
add_offer_to_cart({ index })
submit_contact_form({ fields })

Each tool tells the agent:

The problem is that manually adding tools to every page, form, filter, and button still takes work.

That is why I built Universal WebMCP Runtime.

Universal WebMCP Runtime examines the interface your website already has and automatically turns it into a compact WebMCP tool catalog.

Install it:

npm install @gr3p/universal-webmcp

Then start the runtime:

import { createWebMCPRuntime } from '@gr3p/universal-webmcp';

const runtime = createWebMCPRuntime({
  mode: 'hybrid',
  confirmationPolicy: 'risk-based',
});

runtime.start();

The runtime discovers forms, buttons, navigation, filters, lists, and repeated actions. It generates names, descriptions, and input schemas, removes redundant tools, and registers the useful capabilities with WebMCP.

Your website remains usable exactly as before. WebMCP becomes a progressive enhancement for agents.

Without a shared tool layer, every agent must reverse-engineer your interface independently.

With Universal WebMCP:

Integrate the runtime once, and compatible agents can immediately understand what your website allows them to do.

Agents spend a surprising amount of context simply understanding webpages.

In our public live benchmark, collecting the same 25 offers required:

Representation Tokens
Relevant HTML 245,375
Targeted ARIA snapshot 10,187
Selected WebMCP tool, input, and result 1,332
WebMCP result with a cached catalog 1,041

The selected WebMCP path used:

More importantly, the agent did not have to rediscover how the page worked.

It received a structured tool, invoked it, and got structured data back.

That means less browsing, fewer screenshots, fewer broken selectors, and fewer reasoning steps.

A useful agent interface should not expose every clickable element without context.

Universal WebMCP includes:

Actions still go through the visible interface, existing browser session, and application validation.

The runtime does not read cookies, bypass authentication, defeat CAPTCHAs, or reverse-engineer private APIs.

Sending the complete tool catalog on every request is not always cheaper than sending a small accessibility snapshot.

The advantage comes from selecting the relevant tool and caching the catalog. In our benchmarks, WebMCP became cheaper than repeated ARIA inspection from the second task.

This is not magic compression. It is a better operating model for agents.

Websites use HTML and ARIA to explain their structure to browsers and assistive technologies.

WebMCP can become the corresponding capability layer for AI agents.

Universal WebMCP makes that transition practical for existing websites:

Existing website
       ↓
Universal WebMCP Runtime
       ↓
Structured WebMCP tools
       ↓
Any compatible AI agent

Website owners should not have to rebuild their applications for every new agent.

Agents should not have to reverse-engineer every website they visit.

They should meet in the middle through a small, structured, and safe tool layer.

That is what Universal WebMCP Runtime provides.

Stop making agents reverse-engineer websites. Give them tools.

── more in #ai-agents 4 stories · sorted by recency
── more on @webmcp 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/your-ai-agent-should…] indexed:0 read:3min 2026-07-31 ·