WP WebMCP Forms
Anotações WebMCP declarativas para formulários WordPress — nativo, bloco Gutenberg, Fluent, CF7, WPForms, Forminator, Ninja e SureForms. Lab no Playground.
by Itamar Silva · github.com/silvaitamar/wp-webmcp-forms · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/silvaitamar/wp-webmcp-forms/archive/refs/heads/main.zipReadme
WP WebMCP Forms
Lab / ensaio público — código WordPress (formato de plugin só para instalar no lab) que anota formulários reais com atributos WebMCP declarativos (toolname, tooldescription, toolparamdescription).
Isto não é um produto wp.org nem um “plugin maduro” pronto para produção. É o espelho open-source do lab usado no artigo IA+WP: repetir o experimento no Chrome (flag + Tool Inspector), com ou sem WordPress Playground. Um produto anotador eventualmente entra em fase própria (F4); até lá, trate este repo como referência e demos.
Escopo do ensaio: mesmo caso “Solicitar orçamento”, sem bridge REST e sem toolautosubmit.
Como repetir o teste: Playground (aba top-level) → Chrome #enable-webmcp-testing → Model Context Tool Inspector → Execute Tool com JSON em fixtures/.
| Superfície (demo) | Nome da tool |
|---|---|
Shortcode nativo [wwf_orcamento] |
solicitar_orcamento |
Bloco Gutenberg wp-webmcp-forms/orcamento |
solicitar_orcamento |
| Fluent Forms | solicitar_orcamento_fluent |
| Contact Form 7 | solicitar_orcamento_cf7 |
| WPForms | solicitar_orcamento_wpforms |
| Forminator | solicitar_orcamento_forminator |
| Ninja Forms | solicitar_orcamento_ninja |
| SureForms | solicitar_orcamento_sureforms |
Artigo (IA+WP): WordPress e WebMCP: formulários como tools para agentes (draft / em revisão).
Requisitos (lab)
- WordPress 6.4+ / PHP 8.0+ (no Playground o blueprint já define)
- Chrome com flag WebMCP ou Origin Trial (ago/2026: ainda não estável por padrão)
- Model Context Tool Inspector
Flag: chrome://flags/#enable-webmcp-testing → Enabled → reinicie.
Builders no lab full (via blueprint): Fluent Forms, Contact Form 7 (+ Flamingo), WPForms Lite, Forminator, Ninja Forms, SureForms.
Instalação (clone local)
- Clone em
wp-content/plugins/wp-webmcp-forms - Ative o código no admin (aparece como plugin — só para o lab)
- Semear demos:
wp eval-file wp-content/plugins/wp-webmcp-forms/bin/setup-lab.phpOu: bin/setup-fluent.php, bin/setup-builders.php, bin/setup-blocks.php.
- Hub
/lab-webmcp/e demos (/solicitar-orcamento/,/orcamento-bloco/,/orcamento-fluent/, …).
WordPress Playground
Full (canônico):
https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/silvaitamar/wp-webmcp-forms/main/playground/blueprint.json
Lite (só nativo + bloco):
https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/silvaitamar/wp-webmcp-forms/main/playground/blueprint-lite.json
Boot do full costuma levar alguns minutos. Prefira aba top-level. Ver docs/PLAYGROUND.md.
Validar uma tool
- Página demo no Chrome (flag ligada)
typeof document.modelContext !== "undefined"- Inspector → Execute Tool + fixture em
fixtures/ - Envio humano (sem autosubmit)
429 Gemini na extensão ≠ falha WebMCP.
Documentação
- Índice docs/
- ADAPTERS.md · EXECUTE-TOOL.md · PLAYGROUND.md
- COMPATIBILITY.md · MAINTAINERS.md · CONTRIBUTING.md
Segurança
Mesmas regras de qualquer form de demo: nonce, sanitização; sem autosubmit até haver confirmação humana explícita. Não trate este lab como hardening de produção.
Licença
MIT — LICENSE.