=== ModelGain WebMCP Forms ===
Contributors: upaccn
Tags: forms, webmcp, contact-form-7, ai
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make existing Contact Form 7 forms safely usable by WebMCP-capable AI agents without replacing the form builder or human submission flow.

== Description ==

ModelGain WebMCP Forms provides a fail-closed, explicit WebMCP contract for Contact Form 7. Site administrators choose individual compatible forms in Tools > WebMCP Forms. New and undiscovered forms are disabled by default.

An enabled tool fills only supported human-visible fields for review. It never submits a form, calls `submit()` or `requestSubmit()`, bypasses Contact Form 7 validation, or bypasses CAPTCHA, spam protection, nonce/CSRF behavior, or submission hooks. The ordinary Contact Form 7 human flow remains authoritative.

The initial release supports text, email, URL, telephone, number, date, textarea, select, and radio fields. File uploads, checkboxes, acceptance, quizzes, CAPTCHA/anti-spam controls, provider-internal hidden inputs, sensitive names, multiple selects, and unknown controls fail closed.

WebMCP is treated as progressive enhancement. Sites and human forms continue to work when the browser does not implement `document.modelContext`. This plugin exposes a structured browser tool surface; it does not provide or bundle an AI agent.

== Browser support ==

WebMCP is an emerging browser API. Agent tools are registered only when the browser exposes the supported `document.modelContext.registerTool()` interface in a secure context. On unsupported browsers, the plugin leaves the normal Contact Form 7 experience unchanged.

== Installation ==

1. Install and activate Contact Form 7.
2. Upload and activate ModelGain WebMCP Forms.
3. Open Tools > WebMCP Forms.
4. Review compatibility and blocked fields, choose a compatible form, optionally set a valid tool name, and explicitly enable it.
5. In a browser implementing the imperative WebMCP API, use the registered tool to fill the form, then review and submit it normally as a human.

== Privacy and external services ==

This plugin makes no external requests, includes no telemetry, and sends no form data to a cloud service. Frontend configuration contains only the enabled form ID, resolved tool name, description, and explicit supported-field JSON Schema.

== Changelog ==

= 0.1.0 =
* Initial Contact Form 7 WebMCP release with fail-closed policy, admin registry, runtime diagnostics, and release verification.
