WordPress Plugin

Complete Documentation

Transform your WordPress forms with AI optimization that reduces token usage by up to 67.6% while maintaining response quality. Complete integration guide for Contact Form 7, Gravity Forms, WPForms, and WooCommerce.

Key Features

Enterprise-grade AI optimization for WordPress forms

Universal Form Integration

Works seamlessly with Contact Form 7, Gravity Forms, WPForms, and WooCommerce

67.6% Token Reduction

Dramatically reduce AI processing costs while maintaining response quality

Real-time Analytics

Track optimization performance, cost savings, and form-level insights

Multi-Model Support

Optimized for GPT-4o, Claude 3.5 Sonnet, Gemini Pro, and other AI models

Installation

WordPress Admin

  1. 1Download the plugin ZIP file from GitHub or WordPress.org
  2. 2Go to Plugins → Add New → Upload Plugin
  3. 3Upload the ZIP file and activate the plugin
  4. 4Navigate to webMCP in the admin menu to configure

Manual Installation

  1. 1Extract files to /wp-content/plugins/webmcp/
  2. 2Activate through the WordPress admin Plugins page
  3. 3Configure settings in webMCP → Settings

Requirements

WordPress 5.0 or higher
PHP 7.4 or higher
At least one supported form plugin
HTTPS recommended for API calls

Configuration

Basic Setup

1

Enable webMCP

Turn on AI optimization site-wide from the main settings page.

2

Compression Level

  • Basic (Free): Up to 30% reduction
  • Standard (Pro): Up to 50% reduction
  • Advanced (Pro): Up to 67.6% reduction
3

Target Model

Select your primary AI model for optimization targeting.

Pro Features (API Key Required)

  • Advanced compression algorithms
  • Claude 3.5 Sonnet & Gemini Pro support
  • Real-time optimization as users type
  • Enhanced analytics and reporting

Form Integration

Contact Form 7

Automatic integration with AI suggestions and field enhancement.

  • AI-powered form suggestions
  • Form-specific analytics
  • Custom webMCP panel

Gravity Forms

Advanced form builder integration with webMCP controls.

  • Field-level optimization
  • Entry-level analytics
  • Custom tooltips

WPForms

Form builder panel with tabbed webMCP configuration interface.

  • Field settings panel
  • Analytics dashboard
  • Custom field roles

WooCommerce

Checkout form optimization for billing, shipping, and reviews.

  • Checkout optimization
  • Customer account forms
  • Cart abandonment reduction

Developer Examples

Integration examples, hooks, and API usage

Basic Installation

# Method 1: WordPress Admin Upload
1. Download webmcp-wordpress.zip
2. Go to Plugins > Add New > Upload Plugin
3. Upload ZIP file and activate
4. Navigate to webMCP in admin menu

# Method 2: Manual Installation
cd /wp-content/plugins/
unzip webmcp-wordpress.zip
# Activate through WordPress admin

Contact Form 7 Integration

<!-- webMCP automatically enhances CF7 forms -->
<div class="webmcp-form" data-webmcp-type="contact_form_7">
    [text* your-name data-webmcp-role="input.name"]
    [email* your-email data-webmcp-role="input.email"] 
    [textarea your-message data-webmcp-role="input.message"]
    [submit "Send Message"]
</div>

WordPress Hooks & Filters

<?php
// Log custom optimization results
do_action('webmcp_log_analytics', $optimization_result);

// Modify compression level per form
add_filter('webmcp_compression_level', function($level, $form_type) {
    if ($form_type === 'contact_form_7') {
        return 'advanced';
    }
    return $level;
}, 10, 2);

// Custom field role detection
add_filter('webmcp_field_role', function($role, $field_name, $field_value) {
    if (strpos($field_name, 'company') !== false) {
        return 'input.company';
    }
    return $role;
}, 10, 3);

REST API Usage

// Optimize form data via REST API
const response = await fetch('/wp-json/webmcp/v1/optimize', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-WP-Nonce': wpApiSettings.nonce
    },
    body: JSON.stringify({
        form_data: formData,
        form_type: 'contact_form_7',
        compression_level: 'advanced'
    })
});

// Get analytics data
const analytics = await fetch('/wp-json/webmcp/v1/analytics?range=30');
const data = await analytics.json();

Performance Benchmarks

Real-world performance data from production WordPress sites

Form TypeOriginal TokensOptimized TokensReductionCost Savings
Contact Form 71,24741267.0%$0.00418
Gravity Forms1,18335769.8%$0.00248
WPForms1,15638966.3%$0.02301
WooCommerce1,09837166.2%$0.00109
~50ms
Processing Time
<10MB
Memory Usage
95%+
Cache Compatible
30-67%
Cost Reduction

Analytics & Reporting

Comprehensive insights into your form optimization performance

Dashboard Metrics

Total Optimizations
Number of forms processed
Average Compression
Token reduction percentage
Cost Savings
Actual USD savings calculated
Processing Time
Optimization performance

Form-Level Insights

Per-form optimization statistics

Track performance metrics for individual forms

Field-type performance breakdown

Analyze optimization by field types and roles

Historical trends and patterns

Long-term performance tracking

Export capabilities for reporting

CSV export for external analysis

Security & Privacy

Enterprise-grade security with GDPR compliance

Data Protection

  • No Sensitive Data Stored: Only optimization metrics retained
  • Configurable Retention: Set data retention periods (30-365 days)
  • Local Processing: Form data processed on your server
  • GDPR Compliant: Respects user privacy preferences

Security Features

  • CSRF Protection: All forms include CSRF tokens
  • Nonce Verification: WordPress nonces on all AJAX requests
  • Capability Checks: Proper permission verification
  • Sanitized Inputs: All user inputs sanitized and validated

Frequently Asked Questions

What form plugins are supported?

webMCP currently supports Contact Form 7, WPForms, Gravity Forms, and WooCommerce checkout forms. The plugin automatically detects installed form plugins and enables integration options.

Do I need an API key?

Basic compression features work without an API key and provide up to 30% token reduction. Premium features with advanced compression (up to 67.6% reduction) require a free API key from wmcp.dev.

Will this affect my form functionality?

No, webMCP only optimizes data sent to AI services. Your forms will continue to work exactly as before. The plugin operates transparently without changing form behavior or user experience.

How much can I save?

Users typically see 30-67.6% reduction in AI token usage, resulting in significant cost savings. The exact savings depend on your compression level and form complexity.

Is my data secure?

Yes, webMCP processes data locally on your server. Only optimized data is sent to AI services when you configure them. The plugin follows WordPress security best practices.

Support & Resources

Get help, report issues, or contribute to the project