WebMCP agent skillWebMCP Agent-Skill
webmcpify · MIT · Claude Code · Codex · Cursor · opencode · CopilotClaude Code · Codex · Cursor · opencode · Copilot
webmcpify is an agent skill for WebMCP integration, with curated core coverage or route-by-route parity. Install the portable instruction set in your
coding agent, and it makes an existing web application agent-ready by integrating
WebMCP
(document.modelContext) end to end, then verifies every tool in a real
browser instead of assuming it works.
webmcpify ist ein Agent-Skill für WebMCP-Integration mit kuratierter Kernabdeckung oder routenweiser Parität. Installiere das portable Instruction-Set in deinen
Coding-Agent; es macht eine bestehende Web-App agent-ready, indem es
WebMCP
(document.modelContext) vollständig integriert und jedes Tool im echten
Browser verifiziert, statt es anzunehmen.
Two different things are often called the same name, so to be precise: this skill is the thing that writes the WebMCP integration into your codebase. It is not a browser agent, and not a classic MCP server: no separate process, no new endpoint, no protocol bridge. The tools it registers live in your page and call the code paths your own UI already uses. Zwei verschiedene Dinge tragen oft denselben Namen, deshalb präzise: Dieser Skill schreibt die WebMCP-Integration in deine Codebase. Er ist kein Browser-Agent und kein klassischer MCP-Server: kein separater Prozess, kein neuer Endpoint, keine Protokoll-Bridge. Die registrierten Tools leben in deiner Seite und rufen genau die Code-Pfade auf, die deine UI ohnehin nutzt.
See native runtime verification: an uncut 63-second Chrome recording uses a real approval click and registration, then calls getTools() / executeTool() against one prepared tool. Its phase narration is scripted; the recording does not execute the full skill pipeline.
Sieh native Runtime-Verifikation: Eine ungeschnittene 63-Sekunden-Chrome-Aufnahme nutzt einen echten Freigabe-Klick und eine reale Registrierung und ruft anschließend getTools() / executeTool() gegen ein vorbereitetes Tool auf. Die Phasenerzählung ist geskriptet; die Aufnahme führt nicht die vollständige Skill-Pipeline aus.
Install it in your agentIn deinen Agent installieren
Any skill-loading agentJeder Skill-fähige Agent
Claude Code, Codex, Cursor, opencode, GitHub Copilot and 70+ more: Claude Code, Codex, Cursor, opencode, GitHub Copilot und 70+ weitere:
$ npx skills add TueJon/webmcpify
$ claude # or: codex · cursor · opencode · copilot
> /webmcpify
Claude Code, as a pluginClaude Code, als Plugin
> /plugin marketplace add TueJon/webmcpify
> /plugin install webmcpify@webmcpify
ManuallyManuell
Copy skills/webmcpify/ from the
repository
into your agent's skills directory, or simply point your agent at
SKILL.md. The skill directory is self-contained: pipeline, phase guides,
the vendorable runtime and the verification template all ship inside it.
Kopiere skills/webmcpify/ aus dem
Repository
in das Skills-Verzeichnis deines Agents, oder zeige deinem Agent einfach
SKILL.md. Das Skill-Verzeichnis ist self-contained: Pipeline,
Phasen-Guides, vendorbares Runtime und Verifikations-Template liegen darin.
What it runsWas es ausführt
- Coverage target:
curatedmaps selected high-value actions and explains omissions;paritycensuses every interactive element on every authenticated route. The route map, not a raw tool count, is the evidence. Abdeckungsziel:curatedkartiert ausgewählte Kernaktionen und begründet Auslassungen;parityerfasst jedes interaktive Element auf jeder authentifizierten Route. Die Routenkarte, nicht eine rohe Tool-Zahl, ist der Nachweis. - Inventory maps the codebase into areas and deep-reads one area per iteration, so a 500-file SaaS is processed area by area instead of one context-busting sweep. Inventory zerlegt die Codebase in Areas und liest pro Iteration eine Area tief; ein SaaS mit 500 Dateien wird Area für Area verarbeitet, nicht in einem Kontext-Sweep.
- The gate is yours: names, schemas, examples and a read-only/mutating classification for every proposed tool, before a single line is written. Das Gate gehört dir: Namen, Schemas, Beispiele und eine Read-only/Mutating- Klassifikation für jedes vorgeschlagene Tool, bevor eine Zeile geschrieben wird.
- Integrate works in small batches (one area or ≤5 tools), each built and typechecked independently. Integrate arbeitet in kleinen Batches (eine Area oder ≤5 Tools), jeder einzeln gebaut und typgeprüft.
- Verify and heal iterate per tool with attempt caps and honest escalation instead of infinite loops. Verify und Heal iterieren pro Tool mit Attempt-Caps und ehrlicher Eskalation statt Endlosschleifen.
- Resumable: all state lives in
.webmcpify/manifest.json, so a run survives context windows, sessions, and even a switch of agent. Resumable: Der ganze State liegt in.webmcpify/manifest.json. Ein Run übersteht Kontextfenster, Sessions und sogar einen Agent-Wechsel.
Keep the next run trustworthyAuch dem nächsten Run vertrauen
Resume from the manifest, then compare file contents, approved contracts and the browser environment before reusing a pass. Reconcile interrupted mutations through a read path before retrying. Verification checks both the intended change and a neighboring record that must stay unchanged. Am Manifest fortsetzen und vor der Wiederverwendung eines bestandenen Checks Dateiinhalte, freigegebene Contracts und Browser-Umgebung vergleichen. Unterbrochene Änderungen vor einem Retry über einen Lesepfad abgleichen. Die Verifikation prüft die beabsichtigte Änderung und einen benachbarten Datensatz, der unverändert bleiben muss.
Use only approved test origins, accounts and fixtures in a dedicated browser context. Official documentation reads are the default; optional third-party CLI execution needs a reviewed exact version and approval. Optional model evals need explicit data, time and spend limits. Nur freigegebene Test-Origins, Konten und Fixtures in einem eigenen Browserkontext verwenden. Offizielle Dokumentation wird standardmäßig gelesen; optionale Drittanbieter-CLIs brauchen eine geprüfte exakte Version und Freigabe. Optionale Modell-Evals brauchen explizite Daten-, Zeit- und Kostenlimits.
Read the maintenance and evidence contract →Wartungs- und Nachweisregeln lesen →
What it will not doWas es nicht tut
- Touch unrelated logic or UI. Every diff hunk traces to a manifest entry, and files that were already dirty when the run started are never modified or reverted. Fremde Logik oder UI anfassen. Jeder Diff-Hunk ist einem Manifest-Eintrag zuordenbar, und Dateien, die vor dem Run dirty waren, werden nie geändert oder zurückgesetzt.
- Expose auth, signup, billing, payment or credential-returning tools. An irreversible delete can only open the app's own confirmation UI for the user; ordinary product-object creation remains in scope. Auth-, Signup-, Billing-, Zahlungs- oder Credential-ausgebende Tools exponieren. Eine irreversible Löschung darf nur die bestehende Bestätigungs-UI der App für den Menschen öffnen; gewöhnliche Produktobjekte zu erstellen bleibt im Scope.
- Move the trust boundary. Tools call the code paths your UI already uses: same endpoints, same validation, same auth. Your server stays the only trust boundary. Die Trust Boundary verschieben. Tools rufen die Code-Pfade auf, die deine UI ohnehin nutzt: gleiche Endpoints, gleiche Validierung, gleiche Auth. Dein Server bleibt die einzige Trust Boundary.
- Add a runtime dependency. A small MIT runtime is vendored into your repo, fully feature-detected, so your app is behaviorally unchanged in browsers without WebMCP. Eine Runtime-Dependency hinzufügen. Ein kleines MIT-Runtime wird ins Repo vendored, vollständig feature-detected: ohne WebMCP verhält sich deine App unverändert.
Using the result in ChatGPTDas Ergebnis in ChatGPT nutzen
ChatGPT calls WebMCP integrations Site tools. In the desktop app's built-in browser, keep the page open, select Site tools in the address bar, then open Available site tools. That list is the fastest client-side answer to “did this page register?”. ChatGPT nennt WebMCP-Integrationen Site tools. Lass die Seite im integrierten Browser der Desktop-App geöffnet, wähle Site tools in der Adressleiste und öffne Available site tools. Diese Liste beantwortet clientseitig am schnellsten: „Hat diese Seite registriert?“
- Model and account: official OpenAI documentation checked 2026-08-31 lists GPT-5.6 Sol and Terra; Luna has WebMCP disabled. Enterprise and Edu workspaces are listed as unavailable, and rollout still varies. Modell und Konto: Die am 31.08.2026 geprüfte offizielle OpenAI-Dokumentation nennt GPT-5.6 Sol und Terra; bei Luna ist WebMCP deaktiviert. Enterprise- und Edu-Workspaces sind als nicht verfügbar gelistet, und der Rollout kann variieren.
- Client coverage: Site tools currently discover imperative JavaScript tools in the top-level page, not Declarative API form tools or registrations inside iframes. Client-Abdeckung: Site tools erkennen derzeit imperative JavaScript-Tools in der Top-Level-Seite, nicht Tools der Declarative API auf Formularen oder Registrierungen in iframes.
- Page lifetime: tools belong to the open page. Closing or navigating away can make them unavailable between turns. Seiten-Lebensdauer: Tools gehören zur geöffneten Seite. Schließen oder Wegnavigieren kann sie zwischen Turns unverfügbar machen.
- Safety: every invocation receives a client-side safety review; normal access and confirmation policies still apply. Sicherheit: Jeder Aufruf erhält eine clientseitige Sicherheitsprüfung; normale Zugriffs- und Bestätigungsregeln gelten weiterhin.
FAQ
Why do Site tools look missing in ChatGPT?Warum wirken Site tools in ChatGPT verschwunden?
Check the page's Available site tools list first, then top-level imperative registration, the current desktop-app version, supported model and workspace availability. Site tools die with the page, so keep its browser tab open. Chrome verification and ChatGPT account availability are separate checks. Prüfe zuerst die Liste Available site tools der Seite, dann die imperative Registrierung auf der Top-Level-Seite, die aktuelle Desktop-App, ein unterstütztes Modell und die Workspace-Verfügbarkeit. Site tools sterben mit der Seite; lass ihren Browser-Tab offen. Chrome-Verifikation und ChatGPT-Kontoverfügbarkeit sind getrennte Prüfungen.
Which agents can run this skill?Welche Agents können diesen Skill ausführen?
Any coding agent that loads skills: Claude Code, Codex, Cursor, opencode, GitHub Copilot and 70+ more through the skills CLI. The result is vendor-neutral. The integration is plain WebMCP, so any browser agent that speaks the standard can call your tools. Jeder Coding-Agent, der Skills lädt: Claude Code, Codex, Cursor, opencode, GitHub Copilot und über die Skills-CLI 70+ weitere. Das Ergebnis ist herstellerneutral. Die Integration ist reines WebMCP, jeder Browser-Agent, der den Standard spricht, kann deine Tools aufrufen.
Do I need the Chrome origin trial?Brauche ich den Chrome Origin Trial?
For local development you enable chrome://flags/#enable-webmcp-testing; exposing tools on a production origin needs an origin-trial token. The vendored runtime is feature-detected, so your app behaves identically in browsers without WebMCP. Für lokale Entwicklung aktivierst du chrome://flags/#enable-webmcp-testing; Tools auf einem Produktions-Origin brauchen ein Origin-Trial-Token. Das vendored Runtime ist feature-detected. Ohne WebMCP verhält sich deine App identisch.
Will it change code I did not approve?Ändert es Code, den ich nicht freigegeben habe?
No. You approve the tool manifest before anything is integrated, every diff hunk must trace back to an approved entry, and a final audit against the baseline commit flags anything else. Files that were already dirty when the run started are never modified. Nein. Du gibst das Tool-Manifest frei, bevor irgendetwas integriert wird, jeder Diff-Hunk muss auf einen freigegebenen Eintrag zurückführbar sein, und ein Audit gegen den Baseline-Commit flaggt alles andere. Dateien, die vor dem Run dirty waren, werden nie geändert.
How is each tool verified?Wie wird jedes Tool verifiziert?
Every tool is enumerated and executed in real Chrome from the examples recorded in the manifest, asserting both the tool result and the resulting UI state, including the real submit interaction Chrome requires before a mutating declarative form completes. Jedes Tool wird im echten Chrome aus den im Manifest hinterlegten Beispielen aufgezählt und ausgeführt. Geprüft werden Tool-Ergebnis und resultierender UI-State, inklusive des echten Submit-Klicks, den Chrome bei mutierenden Declarative Forms verlangt.
Status & requirementsStatus & Voraussetzungen
WebMCP is an origin trial from Chrome 149 onwards, and its API surface has already
changed during the trial (the testing API was removed in July 2026;
navigator → document). webmcpify isolates that churn in one
vendored file, probes for the current enumeration/execution surface, and treats
Google's live
modern-web-guidance
as the source of current best practice at integration time.
WebMCP läuft ab Chrome 149 als Origin Trial, und die API-Oberfläche hat sich während
des Trials schon geändert (Testing-API im Juli 2026 entfernt;
navigator → document). webmcpify kapselt diese Bewegung in
einer vendored Datei, probt die aktuelle Enumeration/Execution-Oberfläche und nutzt
Googles live
modern-web-guidance
als Quelle der aktuellen Best Practices zum Integrationszeitpunkt.
LinksLinks
- webmcpify docswebmcpify-Dokumentation: installation and client-side Site tools guidesInstallation und clientseitige Site-tools-Guides
- OpenAI Site tools documentation: current ChatGPT availability and controlsaktuelle ChatGPT-Verfügbarkeit und Bedienung
- github.com/TueJon/webmcpify: source, skill, runtime, verification harnessQuellcode, Skill, Runtime, Verifikations-Harness
- WebMCP proposal: the W3C Web Machine Learning CG spec draftder Spec-Draft der W3C Web Machine Learning CG
- Chrome WebMCP docs: origin-trial detailsDetails zum Origin Trial
- webmcpify.at, the project page (itself agent-ready)webmcpify.at, die Projektseite (selbst agent-ready)
Read the source ↗Quellcode lesen ↗