Capture missing site actions as WebMCP demand

[masnwilliams]

Summary

• Clarify when agents should list WebMCP actions, fall back to Playwright, and report a reusable missing site action.
• Extend get_more_tools with a distinct site-tool classification and an optional validated public registrable domain. Route those reports separately from general product and integration demand; reporting does not install a tool.
• Cover ownership, domain validation, and analytics routing with tests.

Validation

• bun test (666 passing)
• bunx tsc --noEmit
• bunx prettier --check on changed files

---

Note

Low Risk
Changes are additive schema, analytics routing, and documentation; no auth or execution-path changes beyond optional demand reporting.

Overview
Adds a site-specific missing WebMCP action path on get_more_tools: agents classify gaps as site_tool_missing with capability_area: webmcp, optionally attach a validated public registrable site_domain (ICANN via tldts), and get webmcp_catalog_demand instead of kernel or integration demand. Ownership checks reject mismatched gap_reason, webmcp area, or stray site_domain; invalid domains fail schema validation.

PostHog now emits missing_capability_site_domain and folds domain into dedupe keys so per-site catalog signals stay separate.

Agent-facing copy on webmcp, execute_playwright_code, and the README steers the flow: list WebMCP first, fall back to Playwright, report missing reusable actions without expecting an install. Tests cover tool behavior, analytics routing, and integration instrumentation.

^{Reviewed by Cursor Bugbot for commit 6a9520b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
mcp	Ready	Preview	Sep 23, 2026 2:43am UTC