WebMCP Stays — Demo de Reserva de Hospedagem
qiun/webmcp-stays
Demo WebMCP: site de hospedagens totalmente operável por agentes IA
Ver no GitHubUm servidor MCP que expõe um site de reserva de hospedagens (estilo Booking.com) como ferramentas para agentes IA. Demonstra implementação end-to-end de fluxo de reserva com validação de negócio, armazenamento local e confirmação com o usuário.
Instalação
npx convez-ai qiun/webmcp-stays1 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 de reserva realistas
- Prototipagem de interfaces agent-ready com WebMCP
- Validação de integração MCP em aplicações React/Vite
Veredito

Excelente referência técnica para quem constrói agentes de browser e estuda WebMCP. Código produção-ready (TypeScript strict, Zod) com 8 ferramentas cobrindo o fluxo completo de busca à confirmação de reserva — ideal para testes realistas, não brinquedos.
README
A tradução para o português deste README ainda está na fila.
webmcp-stays
▶ Live demo: https://webmcp-stays.vercel.app
A Booking.com-style accommodation booking app — it works for humans (search → results → property →
guest → confirmation) and exposes its features to AI agents via WebMCP. Every human action
has an equivalent as a tool operating on the same logic (src/store/reservation.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 booking journey here (search a destination, filter results, open a property, pick a room, reserve) 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 reservation.
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- MCP-B polyfill (
@mcp-b/global); no backend — reservation stored inlocalStorage(webmcp-stays-reservation)
Getting started
pnpm install
pnpm dev # http://localhost:5173
pnpm build
pnpm lint
pnpm typecheck
WebMCP tools (8)
| Tool | read-only | destructive | human-in-loop |
|---|---|---|---|
search_destinations | ✓ | – | – |
search_stays | ✓ | – | – |
filter_stays | ✓ | – | – |
get_property_details | ✓ | – | – |
select_room | – | – | – |
set_guest_details | – | – | – |
get_reservation_summary | ✓ | – | – |
reserve_stay | – | ✓ | YES |
Business validation with descriptive errors: adults>=1, rooms>=1, children's ages 0–17,
total guests ≤ maxOccupancy × rooms, an adultsOnly property rejects reservations with children.
reserve_stay is registered only once a room is selected and guest details are set; it requires
human confirmation (confirmWithUser → <ConfirmDialog/>).
Mock data
src/data/destinations.ts: 22 destinations.src/data/properties.ts: 44 properties (2 per destination), generated deterministically (the same inputs → the same data, for repeatable agent tests). Total price =pricePerNight × number of nights × number of rooms.
How to test with an agent
- Native Chrome 146+ with the WebMCP flag (
chrome://flags). - MCP-B polyfill (loaded by the adapter) + the
@mcp-b/webmcp-local-relaybridge → Hermes / OpenClaw / your own MCP agent. - Smoke test:
Runspnpm dev npx @mcp-b/webmcp-local-relay MCP_URL=http://localhost:8080/mcp node examples/agent-smoke-test.mjssearch_destinations → search_stays (2 adults + a 6-year-old child) → filter_stays → get_property_details → select_room → set_guest_details → reserve_stay.
API stability (June 2026)
WebMCP is a W3C Community Group Draft Report. For 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.
Set Content-Type: application/json for /.well-known/webmcp.
License
MIT — see LICENSE.