Agentic-WP

Make Your WordPress Forms AI-Ready for the Agentic Web

Overview

Agentic-WP is a WordPress plugin that makes your website's forms discoverable and actionable for WebMCP-compliant AI agents. Instead of AI agents "screen-scraping" your website and guessing how to interact with forms, Agentic-WP provides a structured, reliable interface that tells agents exactly how to help your users.

---

Why This Matters: The Future of Web Interaction

The Shift from Screen Scraping to Agentic Discovery

For decades, the web has been designed for human interaction—buttons to click, forms to fill out, and visual interfaces to navigate. But we're entering a new era: the Agentic Web, where AI agents act on behalf of users to complete tasks across websites.

Today, AI agents interact with websites through "screen scraping"—analyzing HTML, guessing button purposes, and trying to figure out form structures. This approach is:

• Unreliable: Changes to your website design break agent interactions
• Slow: Agents must parse and interpret visual elements meant for humans
• Error-prone: Agents guess field purposes and submit incorrect data

WebMCP: The Emerging Standard

WebMCP (Web Model Context Protocol) is a proposed web standard developed by Google Chrome that's set to revolutionize how AI agents interact with websites. It provides:

1. Discovery: Agents can instantly query which tools (forms, actions) a page supports
2. Structured Schemas: Explicit definitions of inputs and outputs eliminate guesswork
3. Reliability: A formal contract between your website and AI agents

WebMCP is being actively developed as the future standard for agent-web interaction. Early preview is available in Chrome 146+ behind a flag, with full browser support expected as the standard matures.

Why Install Agentic-WP Now?

By installing Agentic-WP today, you're future-proofing your website:

• Be First: Early adopters gain competitive advantage as AI agents become mainstream
• Better User Experience: Users with AI assistants can interact with your forms seamlessly
• No Redesign Needed: Works with your existing forms—no changes to your design
• Future-Proof: As WebMCP becomes standard, your site will already be compatible

The agentic web is coming. Be ready.

---

Features

Note: v1.0 (FREE) focuses on contact forms. Booking forms, scheduling, and advanced analytics coming in PRO version!

🤖 Intelligent Form Detection

• Automatically detects contact forms (v1.0 FREE)
• Works with any form plugin: Contact Form 7, Gravity Forms, WPForms, Elementor, and more
• No configuration required—works out of the box

🔍 WebMCP Attribute Injection

• Adds toolname, tooldescription attributes to forms
• Adds toolparamtitle and toolparamdescription to form fields
• Generates structured JSON schemas from your existing forms

⚙️ Smart Categorization

• Contact Forms: Detects name + email + message patterns
• Booking Forms: Identifies date/time fields for appointments
• Newsletter Signups: Recognizes email-only subscription forms

🛡️ Security First

• No auto-submit by default: Users see what agents filled and must click submit
• Admin control: Enable/disable WebMCP globally
• Form type selection: Choose which form types to make available to agents
• Excludes sensitive forms: Login, payment, and admin forms are automatically excluded

🎨 Works with Your Design

• Zero visual changes to your website
• No custom styling or layout modifications
• Maintains your existing user experience

🔧 Developer Friendly

• Clean, well-documented code following WordPress standards
• Extensible architecture with WordPress filters and hooks
• Easy to customize tool descriptions and behaviors

---

Installation

From WordPress Admin (Recommended)

1. Download the plugin ZIP file
2. Go to Plugins → Add New in your WordPress admin
3. Click Upload Plugin and select the ZIP file
4. Click Install Now and then Activate
5. Go to Settings → Agentic-WP to configure

Manual Installation

1. Upload the agentic-wp folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Settings → Agentic-WP to configure

Configuration

1. Navigate to Settings → Agentic-WP
2. Check "Enable WebMCP for AI agents"
3. Select which form types to enable:
   • ✅ Contact Forms
   • ✅ Booking/Appointment Forms
   • ✅ Newsletter Signups
4. Click Save Settings

That's it! Your forms are now AI-ready.

---

How It Works

For Website Owners

Agentic-WP works silently in the background:

1. Scans your pages for forms when content is rendered
2. Detects form type by analyzing fields and submit buttons
3. Injects WebMCP attributes into the HTML (invisible to users)
4. AI agents can now discover your forms and understand how to use them

Your website looks and works exactly the same for human visitors.

For Developers

The plugin uses WordPress filters to modify the_content:

// Forms are enhanced with WebMCP attributes
<form toolname="contact_form"
      tooldescription="Submit a contact request with your name, email, and message">

  <input type="text"
         name="name"
         toolparamtitle="name"
         toolparamdescription="Your full name">

  <input type="email"
         name="email"
         toolparamtitle="email"
         toolparamdescription="Your email address">

  <textarea name="message"
            toolparamtitle="message"
            toolparamdescription="Your message"></textarea>

  <button type="submit">Send</button>
</form>

AI agents can now:

• Discover the contact_form tool
• Understand each parameter's purpose
• Fill out the form accurately on behalf of users

---

Supported Form Types

✅ Contact Forms

• Detection: Forms with name, email, and message fields
• Tool Name: contact_form
• Common Plugins: Contact Form 7, Gravity Forms, WPForms, Ninja Forms

✅ Booking/Appointment Forms

• Detection: Forms with date and/or time fields
• Tool Name: booking_form
• Common Plugins: Booking Calendar, Amelia, Calendly embeds

✅ Newsletter Signups

• Detection: Forms with email field but no message field
• Tool Name: newsletter_signup
• Common Plugins: Mailchimp, ConvertKit, Newsletter plugins

🔒 Excluded (For Security)

• Login/registration forms
• Payment and checkout forms
• Admin forms
• Password reset forms

---

Testing Your Forms

With Chrome 146+ (WebMCP Flag Enabled)

1. Enable WebMCP in Chrome:

   • Navigate to chrome://flags/#enable-webmcp-testing
   • Set flag to Enabled
   • Restart Chrome

2. Install the Model Context Tool Inspector Extension

3. Visit your website and open the extension

4. You should see your forms listed as available tools:

   • contact_form
   • booking_form
   • newsletter_signup

5. Test manually by filling in parameters and clicking "Execute Tool"

With Gemini API

Use the Tool Inspector extension to test with natural language:

"Fill out the contact form with my name John Doe, email john@example.com,
and message 'I'd like to schedule a demo'"

The AI agent will automatically invoke your contact_form tool with the correct parameters.

---

Roadmap

v1.0 (Current - FREE)

• ✅ Contact form detection and WebMCP support
• ✅ Universal form detection (works with any plugin)
• ✅ WebMCP attribute injection
• ✅ Simple admin settings page

v2.0 (PRO Version - Coming Soon)

Premium features available for $49-99/year:

• 📅 Booking & appointment form support
• 📞 Call scheduling form support
• 📊 Analytics dashboard (track agent vs human submissions)
• 🎨 Per-form customization (custom tool names/descriptions)
• ⚡ Advanced settings (auto-submit, form-specific controls)
• 🔗 Webhooks & integrations (Zapier, Slack, etc.)
• 💬 Priority email support

v3.0 (Future)

• Search form support
• E-commerce integration (product search, add to cart)
• Multi-step form support
• White-label options for agencies
• Multi-site support

---

Get Professional Help

Building an AI-ready website or need custom WebMCP implementation?

MCP Web Agency specializes in:

• WebMCP implementation and optimization
• AI agent integration for businesses
• Custom form and workflow design for the agentic web
• WordPress development for AI-first experiences

Visit mcpweb.agency for expert assistance.

---

Contributing

Contributions are welcome! This plugin is open source and we encourage:

• Bug reports and feature requests via GitHub Issues
• Pull requests for improvements
• Documentation enhancements
• Testing and feedback

For questions or support, contact: benjaminamoswagner@gmail.com

---

Technical Requirements

• WordPress: 5.8 or higher
• PHP: 7.4 or higher
• Chrome: 146+ (for testing WebMCP functionality)

---

License

This plugin is licensed under the GNU General Public License v3.0.

You are free to:

• Use this plugin for any purpose
• Modify the source code
• Distribute original or modified versions

See LICENSE file for full details.

---

Resources

• WebMCP Documentation - Official WebMCP specification
• Model Context Protocol (MCP) - The inspiration for WebMCP
• Plugin Support - Report bugs or request features
• MCP Web Agency - Professional WebMCP implementation

---

Credits

Developed by MCP Web Agency

Built with ❤️ for the future of the web.

---

Ready to make your WordPress site AI-ready? Install Agentic-WP today and join the agentic web revolution.