WebMCP Shop
qiun/webmcp-shop
Loja demo agente-ready com 7 ferramentas WebMCP para testes de automação
Ver no GitHubLoja online demo pronta para agentes IA navegarem e completarem compras end-to-end via WebMCP. Construída com Vite, React e TypeScript, expõe todas as funcionalidades (catálogo, produto, carrinho, checkout) como ferramentas MCP que agents podem operar autonomamente com confirmação humana.
Instalação
npx convez-ai qiun/webmcp-shop1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Testar agentes IA em fluxos reais de e-commerce
- Demonstrar WebMCP em browsers modernos (Chrome 146+)
- Validar integração MCP-B polyfill com aplicações web
- Prototipagem de automação de compras por agents
Veredito

Referência sólida e pronta para produção de site WebMCP-enabled. Ideal para quem está desenvolvendo agentes IA que precisam interagir com interfaces web reais, com suporte a human-in-the-loop em operações críticas como checkout.
README
A tradução para o português deste README ainda está na fila.
webmcp-shop
▶ Live demo: https://webmcp-shop.vercel.app
An online store — works normally for humans (catalog → product → cart → checkout)
and exposes all of its features to AI agents via WebMCP. Every human action has
an equivalent as a tool operating on the same logic (src/store/cart.ts).
Why this exists
This is one of four open demo sites built specifically to be agent-ready via WebMCP. We publish them so that anyone building AI browser agents — or working on the WebMCP standard and the MCP-B polyfill itself — has realistic, end-to-end targets to test against, not toy pages. The full shopping journey here (search the catalog, open a product, build a cart, check out) can be completed by a human in the UI and driven entirely by an AI agent through WebMCP tools, with human-in-the-loop confirmation on the order.
The goal is simple: make it easy to verify that an agent can really operate a WebMCP-enabled site, end to end. Fork it, point your agent at it, and see what works.
WebMCP demo set — live demos (source): acme · shop · stays · airline
Stack
- Vite + React 18 + TypeScript (
strict),react-router-dom - Tailwind CSS,
lucide-react zod+zod-to-json-schema(single source of truth for schema and validation)- MCP-B polyfill (
@mcp-b/global); no backend — the cart lives inlocalStorage(webmcp-shop-cart)
Getting started
pnpm install
pnpm dev # http://localhost:5173
pnpm build
pnpm lint
pnpm typecheck
WebMCP tools (7)
| Tool | read-only | destructive | human-in-loop |
|---|---|---|---|
search_products | ✓ | – | – |
get_product_details | ✓ | – | – |
list_categories | ✓ | – | – |
add_to_cart | – | – | – |
update_cart_item | – | – | – |
get_cart | ✓ | – | – |
checkout | – | ✓ | YES |
checkout is registered only when the cart is non-empty (useWebMcpTool(checkoutTool, cart.count > 0))
and never finalizes an order without human confirmation (confirmWithUser → <ConfirmDialog/>).
How to test with an agent
- Native Chrome 146+: enable the WebMCP flag in
chrome://flags, refresh — an agent (e.g. Gemini in Chrome / Model Context Tool Inspector) sees the page's tools. - MCP-B polyfill (works today, any MCP agent): the page loads
@mcp-b/globalautomatically. Start the@mcp-b/webmcp-local-relaybridge and connect any MCP agent. - Smoke test:
It runspnpm dev npx @mcp-b/webmcp-local-relay MCP_URL=http://localhost:8080/mcp node examples/agent-smoke-test.mjssearch_products → add_to_cart → get_cart → checkout.
API stability (June 2026)
WebMCP is a W3C Community Group Draft Report. Surface: document.modelContext.registerTool/ unregisterTool (navigator.modelContext deprecated since Chrome 150). API changes → you edit
only src/lib/webmcp.ts. Changelog: developer.chrome.com/docs/ai/webmcp.
Deploy
Vercel / Netlify / GitHub Pages. SPA fallback to index.html. HTTPS required (secure context).
Set Content-Type: application/json for /.well-known/webmcp.
License
MIT — see LICENSE.