=== IBS WebMCP for Ninja Forms ===
Contributors: ibsofts, laddoo
Donate link: https://donate.stripe.com/14keXEbyJ2xp43SdQR
Tags: ninja forms, webmcp, ai, forms, integration
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bridge Ninja Forms to AI. Allow AI agents and browser assistants to securely discover, read, and submit your web forms automatically.

== Description ==

🌐 <a href="https://www.ibsofts.com/plugins">Official Website</a> | 📖 <a href="https://support.ibsofts.com/knowledgebase/articles/installing-and-activating-ibs-webmcp-for-ninja-forms">Documentation</a> | 💁 <a href="https://support.ibsofts.com/">Support</a>

🚀 **IBS WebMCP for Ninja Forms** enables Ninja Forms to work with AI agents using the WebMCP standard for browser-native AI interaction.

Once enabled, Ninja Forms become AI-friendly tools that compatible AI agents can discover, understand, and submit without relying on HTML scraping or visual interpretation.

Your forms become structured AI endpoints that expose:
☑️ Form fields
☑️ Validation rules
☑️ Submission requirements
☑️ Supported input types
☑️ Structured form metadata

This allows AI systems to interact with forms more accurately and reliably using machine-readable schemas designed for AI-assisted browsing and automation.

### 🚀 What is WebMCP?

WebMCP is an emerging browser-native protocol that allows websites to expose structured tools directly to AI systems. Instead of forcing AI agents to parse webpages or analyze screenshots, WebMCP provides structured interfaces that AI assistants can interact with programmatically.

Think of it as turning your website into an AI-accessible tool layer for browser agents and automation systems.

With **IBS WebMCP for Ninja Forms**, your Ninja Forms become part of that AI-ready ecosystem.


### 🚀 How It Works


1. Install and activate IBS WebMCP for Ninja Forms.
2. Open the IBS WebMCP for Ninja Forms dashboard under the Ninja Forms menu.
3. Select the Ninja Forms you want to expose and enable AI access for those forms.
4. The plugin automatically generates an AI-readable schema.
5. Compatible AI agents can discover and interact with the form.

No coding or API setup required.


### Included Features

### 🚀Core Features

☑️ AI-Readable Tools: Expose Ninja Forms as AI-readable tools.
☑️ Automatic Schemas: Generate structured JSON schemas automatically.
☑️ Secure Submissions: Allow AI-assisted form submissions safely.
☑️ Browser-Native AI: Enable browser-native AI interaction.
☑️ Admin Dashboard: Monitor exposed forms through a unified admin dashboard.
☑️ Selective Control: Control exactly which forms are AI-accessible.

### 🚀Supported AI Form Actions

AI systems can:
☑️ Discover exposed forms automatically.
☑️ Read supported field structures.
☑️ Understand validation requirements.
☑️ Submit supported forms securely.
☑️ Interact with forms through structured WebMCP endpoints.

### 🚀Supported Ninja Forms Fields

Current support includes:
☑️ First Name
☑️ Last Name
☑️ Email
☑️ Phone
☑️ Single Line Text (Textbox)
☑️ Paragraph Text (Textarea)

_Additional field support may be introduced in future updates._

### 🚀Smart Compatibility Protection

To help prevent failed submissions, forms containing unsupported required fields may automatically have AI exposure disabled.

Unsupported required fields may include:
☑️ Select
☑️ Checkbox List
☑️ Radio List
☑️ Multi Select
☑️ File Upload
☑️ Date/Time

_To re-enable AI exposure, remove the "Required" setting from unsupported fields or simplify the form configuration._

### 🚀 AI Compatibility

IBS WebMCP for Ninja Forms is designed for compatibility with:

☑️ WebMCP-compatible AI agents
☑️ Browser-based AI assistants
☑️ Chrome WebMCP testing environments
☑️ Future WebMCP-compatible AI systems

As AI-assisted browsing continues to evolve, the plugin helps make Ninja Forms accessible to next-generation browser automation workflows.

### 🚀 AI-Friendly Form Discovery

When a form is exposed to AI:
☑️ A structured schema is generated automatically.
☑️ AI agents can discover the form endpoints.
☑️ Supported field types become machine-readable.
☑️ Validation rules are exposed cleanly.
☑️ AI systems can submit structured requests securely.

This creates a significantly more reliable AI interaction experience compared to traditional webpage automation.

### 🚀 Privacy

☑️ **No External Transmission:** The plugin does not collect, store, or transmit data to external servers.
☑️ **Fully Local Processing:** Schema generation and form processing occur entirely within your WordPress installation.
☑️ **No Tracking:** No telemetry, analytics, or external API dependencies.
☑️ **Administrator Controlled:** Forms remain private unless explicitly enabled for AI exposure.


== Installation ==

1. Navigate to WordPress **Admin → Plugins → Add New**.
2. Click **Upload Plugin** and select the plugin ZIP file.
3. Click **Install Now** to begin the installation.
4. Once installed, click **Activate Plugin**.


= Requirements =
* WordPress 6.0 or higher
* PHP 7.4 or higher
* Ninja Forms (required)


== Screenshots ==

1. Expose Form to AI (WebMCP) settings
2. IBS WebMCP for Ninja Forms dashboard and AI registry status
3. Example AI-enabled Ninja Form configuration
4. AI-readable form schema and discovery endpoint
5. Plugin activity logs


== Frequently Asked Questions ==

= Which Ninja Forms fields are supported? =

The current version supports:
☑️ First Name
☑️ Last Name
☑️ Email
☑️ Phone
☑️ Single Line Text (Textbox)
☑️ Paragraph Text (Textarea)

Note: Forms containing unsupported required fields may automatically have AI exposure disabled to help prevent failed AI submissions.

= Is this secure? =
Yes. Forms are private by default and must be explicitly exposed by the administrator. The plugin only exposes structured form metadata for enabled forms.

= Can AI assistants submit forms automatically? =
Yes. Compatible AI agents can discover and submit supported Ninja Forms through structured WebMCP endpoints.

= Does this plugin expose all forms automatically? =
No. Administrators manually choose which forms become AI accessible.

= Does this plugin collect any data? =
No. The plugin does not send data to external services or collect telemetry. Everything runs locally within WordPress.

= Why would I want AI-readable forms? =
AI-assisted browsing and browser automation are becoming increasingly common. Structured AI-readable forms allow assistants to complete form workflows more accurately than traditional webpage parsing or visual automation.



== Changelog ==

= 1.0.0 =
* Initial public release of IBS WebMCP for Ninja Forms

== Upgrade Notice ==

= 1.0.0 =
Initial release of the plugin.