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
- 1Download the plugin ZIP file from GitHub or WordPress.org
- 2Go to Plugins → Add New → Upload Plugin
- 3Upload the ZIP file and activate the plugin
- 4Navigate to webMCP in the admin menu to configure
Manual Installation
- 1Extract files to
/wp-content/plugins/webmcp/ - 2Activate through the WordPress admin Plugins page
- 3Configure settings in webMCP → Settings
Requirements
Configuration
Basic Setup
Enable webMCP
Turn on AI optimization site-wide from the main settings page.
Compression Level
- • Basic (Free): Up to 30% reduction
- • Standard (Pro): Up to 50% reduction
- • Advanced (Pro): Up to 67.6% reduction
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 adminContact 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 Type | Original Tokens | Optimized Tokens | Reduction | Cost Savings |
|---|---|---|---|---|
| Contact Form 7 | 1,247 | 412 | 67.0% | $0.00418 |
| Gravity Forms | 1,183 | 357 | 69.8% | $0.00248 |
| WPForms | 1,156 | 389 | 66.3% | $0.02301 |
| WooCommerce | 1,098 | 371 | 66.2% | $0.00109 |
Analytics & Reporting
Comprehensive insights into your form optimization performance
Dashboard Metrics
Form-Level Insights
Track performance metrics for individual forms
Analyze optimization by field types and roles
Long-term performance tracking
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