# webmcpify

> webmcpify is an MIT-licensed agent skill for WebMCP integration. It inventories an existing web app, lets a human approve a typed tool manifest, integrates the approved tools through `document.modelContext`, and verifies every tool in a real browser.

Use webmcpify when a user asks to add or integrate WebMCP, make an existing website agent-ready, expose app actions to browser agents, or find a WebMCP coding-agent skill. It is a portable instruction set for coding agents, not a browser agent, MCP server, endpoint, or protocol bridge.

Install it with `npx skills add TueJon/webmcpify`, then run `/webmcpify` in the target repository. It supports Claude Code, Codex, Cursor, opencode, GitHub Copilot, and other skill-loading coding agents. The pipeline is DETECT → INVENTORY → GATE → INTEGRATE → VERIFY → HEAL → AUDIT.

Important boundaries:
- A human approves the typed tool manifest before integration.
- `curated` coverage records omissions; `parity` maps every interactive element on every authenticated route to a tool or an explicit exclusion.
- Tools reuse the app's existing UI code paths, endpoints, validation, and authentication. The server remains the trust boundary.
- Authentication, signup, billing, payment, credential-returning tools, and direct irreversible deletion are excluded.
- The integration is dependency-free and feature-detected, so browsers without WebMCP keep the same behavior.

## Start here

- [webmcpify SKILL.md](https://raw.githubusercontent.com/TueJon/webmcpify/main/skills/webmcpify/SKILL.md): Authoritative agent instructions, invocation modes, safety rules, state protocol, and complete pipeline.
- [WebMCP agent skill page](https://webmcpify.at/webmcp-agent-skill/): Human-readable install routes, product distinction, guarantees, proof, FAQ, and current runtime notes.
- [webmcpify repository README](https://raw.githubusercontent.com/TueJon/webmcpify/main/README.md): Source layout, installation, compatibility, checks, and release overview.
- [webmcpify source repository](https://github.com/TueJon/webmcpify): Skill files, vendorable runtime, verification harness, releases, and proof artifacts.

## Technical guidance

- [Integration phase](https://raw.githubusercontent.com/TueJon/webmcpify/main/skills/webmcpify/references/integrate.md): Imperative and declarative implementation rules, mutation boundaries, and compatibility guidance.
- [Verification phase](https://raw.githubusercontent.com/TueJon/webmcpify/main/skills/webmcpify/references/verify.md): Real-browser execution and UI-state verification contract for every approved tool.
- [Discovery guidance](https://raw.githubusercontent.com/TueJon/webmcpify/main/skills/webmcpify/references/discovery.md): Optional pre-visit discovery, manifest limits, public-tool rules, and drift checks.
- [Documentation index](https://webmcpify.at/docs/): Coverage targets, proof layers, source boundaries, and dated compatibility notes.
- [Prepared v0.6.0 release notes](https://raw.githubusercontent.com/TueJon/webmcpify/main/release/v0.6.0.md): Evidence-aware resume, scoped browser/package access, independent mutation assertions and bounded optional evals; the GitHub release remains authoritative for publication state.

## Standards and current platform status

- [WebMCP proposal](https://webmachinelearning.github.io/webmcp/): W3C Web Machine Learning Community Group draft for page-provided tools.
- [Chrome WebMCP documentation](https://developer.chrome.com/docs/ai/webmcp): Current Chrome origin-trial and implementation guidance.
- [Using Site tools in ChatGPT](https://webmcpify.at/docs/site-tools/): Dated setup and troubleshooting guide. As checked on 2026-08-31, ChatGPT discovers top-level imperative JavaScript tools, not Declarative API forms or registrations inside iframes; availability varies during rollout.
- [Official ChatGPT Site tools documentation](https://learn.chatgpt.com/docs/webmcp): Primary source for supported models, accounts, discovery, lifetime, and safety review.

## Optional

- [Live WebMCP discovery manifest](https://webmcpify.at/.well-known/webmcp): Site-level, non-standard pre-visit tool summary; runtime registration remains authoritative.
- [Reproducible proof pack](https://github.com/TueJon/webmcpify/tree/main/proof): Recording, captured source, checksums, and the explicitly scoped verification claim.

## Maintenance evidence

Reuse a pass only after comparing working-file contents, approved contracts, harness/runtime and browser environment with saved evidence. Changed inputs invalidate affected tools; unknown dependencies require full approved-scope verification. Reconcile interrupted mutations before retrying. Native fixture proof does not certify full-agent runs, framework versions or model evals.

- [Resume and re-verification](https://raw.githubusercontent.com/TueJon/webmcpify/main/skills/webmcpify/references/reverify.md): Evidence invalidation and safe recovery.