GiveWP MCP And AI Support

You can now manage your fundraising efforts using the power of AI! With the release of the new GiveWP Model Context Protocol (MCP), you can connect AI assistants directly to your website. Instead of clicking through admin pages, you can use simple chat prompts to create campaigns, view donor information, manage subscriptions, and much more. This guide will walk you through how to set it up and explore what’s possible with this exciting new integration.

How AI Tools Access GiveWP

GiveWP has implemented a new technology called Model Context Protocol (MCP) to make it possible for AI tools to read and use GiveWP information and functionality. MCP functions as a bridge between your WordPress site and MCP clients (AI tools that can connect with MCP servers) like Cursor, Claude, VS Code, and more. It acts as a universal translator, helping LLM-based AI communicate with APIs.

Supported Functionality

AI can help you with many common fundraising tasks that you would normally have to go into GiveWP’s admin pages to accomplish. Instead, everything happens within the chat interface, allowing you to work on everything in the same place.

Campaign Management

• Create, update, duplicate, and delete (trash/archive) campaigns.
• Retrieve campaign lists, details, statistics, and revenue data.

Donation Management

• List, create, update, delete (trash/archive), and refund donations.
• Access donation notes and related information.

Form Management

• List and retrieve donation forms.
• Associate forms with specific campaigns.

Donor Management

• View, update donor details, and access donor statistics and notes.

Subscriptions Management

• List, create, update, cancel, and delete subscriptions.

Comment Management

• Retrieve comments from donors on campaigns.

Example Tasks

• Find the top 5 most successful campaigns and use them as examples to create a new campaign.
• Find the top 10 donors with the highest total donation amounts that have not donated yet this year.
• List Donor IDs and latest donation dates for donors with the name John Smith.

Limitations

AI capabilities are limited to actions that can be taken via GiveWP’s API endpoints. In addition to that, there may be some functions that are not yet supported by the MCP. AI will be limited to these factors and its own ability to interpret the prompts and information retrieved from GiveWP. Here are some known limitations:

Unsupported CREATE actions

Asking the AI Agent to create the following entities is not supported and should fail:

• Donor
• Form
• Donor Note
• Donation Note

Unsupported EDIT actions

Asking the AI Agent to edit the following entities is not supported and should fail:

• Form

Unsupported DELETE actions

Asking the AI Agent to delete the following entities is not supported and should fail:

• Donor
• Form

Deleting a Campaign or Donation

If prompting to delete a Campaign, it will be sent to Archive. If prompting to delete a Donation, it will be sent to Trash. This is because GiveWP will only “soft delete” Campaigns and Donations so that they can be retrieved later for records. There is no option to fully delete a Campaign, but you can delete a Donation once it has been sent to Trash.

Setting Up AI with GiveWP’s MCP

Many popular AI tools will work with GiveWP’s MCP. Follow these steps to start using AI to manage your fundraising operations.

Requirements

Ensure you have all of the necessary tools installed, with all of the required versions.

On your WordPress site:

• WordPress version 6.5+ – with REST API enabled (enabled by default)
• GiveWP core plugin version 4.9.0+ – Installed & active

On your local machine (computer):

• Node.js version 20+ – for use with desktop AI tools or MCP clients like Cursor

Create a WordPress Application Password

This password will be used to connect certain AI tools to GiveWP.

1. Log into your WordPress admin dashboard.
2. Navigate to Users > Your Profile.
3. Scroll down to Application Passwords.
4. Enter a name like GiveWP MCP.
5. Click Add New Application Password.
6. Copy the generated password (spaces are okay!).

Choose an AI Assistant

Many AI tools will work with GiveWP’s MCP. Here are two that we recommend:

• Cursor: Popular AI-powered code editor
• Angie: Elementor’s agentic AI plugin for WordPress

Other AI tools will work with GiveWP’s MCP as well, such as Claude Desktop, VS Code, Windsurf, Cline, Zed, and more. When exploring new AI tools, check that they are an MCP client and do not require a public MCP server before attempting to use them with GiveWP.

Complete the AI Setup

Some AI assistants may require additional steps. Follow the instructions provided by your chosen AI assistant to connect with a custom MCP. This is where you will need the application password you created earlier. We’ll provide some examples to help you get started.

Quickest: Use Elementor’s Angie plugin with GiveWP’s MCP

There are no additional setup steps to use Angie with GiveWP’s MCP as long as your site meets the following requirements:

• WordPress version 6.5+
• GiveWP version 4.9.0+ installed & active
• Angie plugin installed & active

Angie will automatically detect GiveWP, and you can start chatting immediately.

For Developers: Use Cursor with GiveWP’s MCP

1. Install Node.js version 20+ on your machine (as mentioned above).
2. Go to Settings > Cursor Settings > Tools & Integrations > MCP Tools > Add Custom MCP.
3. Add the configuration into your Cursor ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "givewp-mcp": {
      "command": "npx",
      "args": ["-y", "@givewp/mcp-server@latest"],
      "env": {
        "WP_REST_URL": "https://your-wordpress-site.com/wp-json",
        "WP_USERNAME": "your-username",
        "WP_APP_PASSWORD": "your-application-password",
        "NODE_TLS_REJECT_UNAUTHORIZED": 1
      }
    }
  }
}

Read more in GiveWP’s npm package documentation.

FAQ