Gutena Forms MCP Settings Guide

Gutena Forms MCP allows you to connect your forms with AI tools so they can securely access form and submission data. Using the WordPress Abilities API and MCP Adapter, this feature provides safe, read-only access to your forms without affecting your existing data. This feature is available starting from Gutena Forms version 1.8.0.

This guide walks you through setting up the Gutena Forms MCP feature, configuring it for your forms, and connecting it to an external client.

What You Can Access with MCP

Functional Capabilities:

• Read Forms: List all available forms.
• Read Entries: List all form submissions.
• Read Entries for One Form: Filter submissions by form.
• Read Entry Details: Retrieve specific entry details based on entry_id.

These operations allow AI tools to interact with form data in a controlled, read-only manner.

Info: That means Gutena Forms works smoothly with AI tools without needing custom integrations.

Requirements

Before configuring Gutena Forms MCP, ensure the following:

1. WordPress 6.9 or later and PHP 7.4 or later are required for the MCP Adapter.
2. Gutena Forms v1.8.0+ is installed.
3. The MCP Adapter plugin must be installed and activated from GitHub: Get MCP Adapter.
4. Node.js 18+ installed (for MCP connection)

How to Enable MCP

Step 1: Enable Abilities

1. Navigate to Gutena Forms → Settings → MCP in your WordPress dashboard.

2. Download and activate the MCP Adapter.
3. Toggle Enable Abilities & MCP Server to On and allow external AI tools to access these capabilities. Once activated, the MCP server will be available via the endpoint:

{your-site}/wp-json/gutena-forms/v1/mcp

Note: Both Abilities and the MCP Server must be enabled to interact with external clients.

4. Click Save Settings to apply your changes.

Step 2: Connect Your AI Tool

To connect your AI tool with Gutena Forms, you need to authenticate using a WordPress Application Password and configure your MCP connection.

Step 2.1: Create an Application Password

1. Go to Users → Profile → Application Passwords in your WordPress dashboard.
2. Enter a name (e.g., “Cursor MCP”).
3. Click Add New Application Password.
4. Copy the generated password.

⚠️ Remember: You will not be able to view this password again. Store it securely.

Step 2.2: Copy the MCP Configuration

1. Go to Gutena Forms → Settings → MCP.
2. Copy the JSON configuration provided in the Connect Your AI Tool section.

Now paste this configuration into your AI tool:

• Cursor IDE → .cursor/mcp.json
• Claude Code → .mcp.json
• Claude Desktop → claude_desktop_config.json
• Other AI tools → Follow their respective MCP setup instructions

Step 2.3: Replace Credentials

Update the configuration with your actual credentials:

• Replace WP_API_URL with your MCP endpoint
  → wp-json/gutena-forms/v1/mcp
• Replace WP_API_USERNAME with your WordPress username
• Replace WP_API_PASSWORD with your generated application password

Example:

MCP Tools / Abilities

Once the Abilities feature is enabled and the MCP server is active, the following tools are connected via the MCP API:

• gutena-forms/get-all-forms: List all forms available in the system.
• gutena-forms/get-all-entries: List all form submissions.
• gutena-forms/get-form-entries: Get all entries for a specific form by providing its form_id.
• gutena-forms/get-entry-details: Fetch detailed information for a specific entry by using its entry_id.

These tools provide read-only access to your forms and entries.

Permissions and Security

Permissions:

Access to these abilities is restricted to administrators with the manage_options permission. Ensure that users have the required permission level before enabling MCP.

Authentication:

Authentication uses WordPress Application Passwords (no separate API keys). The client must authenticate with the correct username and password to secure access.

Troubleshooting

• MCP Server Not Responding:
  Ensure both Abilities and the MCP Server are enabled. Verify the correct endpoint URL is being used.
• 401 Unauthorized Error:
  Check that the Application Password is correctly set and that the user has the appropriate permissions (manage_options).

• No Form Entries:
  Verify that your forms are collecting data properly. Ensure entries are being saved and visible in the Entries section of the admin panel.

• API Key Issues:
  Remember, MCP does not use Gutena-specific API keys. It relies on WordPress authentication and permissions.

If you encounter any issues with the MCP settings, make sure all settings are configured properly and that the MCP Adapter is active. For any other questions, feel free to contact our support team.