# GiveWP MCP > GiveWP connects your WordPress donation system to any AI agent, letting you automatically pull complex fundraising data. You can query detailed donor profiles, track specific forms' performance, and retrieve comprehensive lists of donations without logging into the main dashboard. It’s instant reporting for nonprofits. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** wordpress, donations, fundraising, donor-tracking, plugin ## Description Your agent accesses all the raw numbers from your giving site, treating your donation records like a searchable database. Instead of navigating separate tabs to check goal progress or donor activity, you just talk to your AI client and ask what you need. You can list every active form on your site, pull up a specific donor's entire history, and get real-time stats for any campaign period. This capability lets non-profit admins automate tedious reporting tasks instantly. By connecting through the Vinkius Marketplace, your agent gets read-only access to everything—a safe way to manage all your giving data without leaving your workspace. ## Tools ### verify_api_connection Checks if your AI client has established a working link to the GiveWP database. ### find_donor_history Searches and retrieves all historical donation records associated with a specific donor's profile. ### get_form_performance Gathers key statistics, including total funds raised and the number of donations, for any given giving form. ### get_form_details Retrieves detailed configuration information and metadata about a specific donation form. ### get_plugin_stats Provides high-level, general statistics on the overall performance of the GiveWP plugin itself. ### list_plugin_donations Generates a complete list of every donation record processed through the entire system. ### list_plugin_donors Pulls a comprehensive list of all unique donor profiles recorded in your database. ### list_donation_forms Lists every active and archived donation form published on your website. ### list_recent_donations Retrieves the latest batch of donations recorded in the system for quick review. ## Prompt Examples **Prompt:** ``` List all active donation forms on my website. ``` **Response:** ``` Retrieving forms... I found 4 active donation forms, including 'Emergency Relief Fund' (ID: 123) and 'Monthly Sponsorship'. Would you like to see the goal progress for any of them? ``` **Prompt:** ``` Show me the donation history for donor 'jane@example.com'. ``` **Response:** ``` Fetching history... Jane Doe has made 5 donations totaling $250.00. Her most recent contribution was $50.00 on September 15th for the 'Holiday Campaign'. ``` **Prompt:** ``` Get the fundraising stats for the 'Annual Fund' form (ID: 987). ``` **Response:** ``` Retrieving stats... The 'Annual Fund' form has raised $12,450.00 from 145 unique donations. The average donation amount is $85.86. ``` ## Capabilities ### Check API connectivity Verifies that your AI client has a working connection to the donation records. ### Search donor history Looks up all giving records for a specific person or donor name. ### Retrieve form performance statistics Pulls key metrics, like total money raised and donation count, for any single form. ### Get detailed form metadata Retrieves configuration details about a specific online giving form. ### Fetch general site statistics Gives an overview of the overall plugin performance and fundraising totals. ### List all donation records Retrieves a comprehensive list of every donation that came through the system. ### List all donor profiles Pulls a roster of every unique individual who has donated money. ## Use Cases ### The Board Meeting Report A marketing analyst needs to prove fundraising success for the board meeting. They ask their agent: 'Show me overall site stats and list all donations from Q3.' The MCP uses `get_plugin_stats` and `list_donation_forms` to pull a clean, compiled data set ready for presentation. ### Checking Donor Engagement A fundraiser receives an email from a high-value donor. They immediately ask their agent: 'What is the entire giving history for this person?' The MCP uses `find_donor_history` to pull up five years of data in seconds, allowing them to tailor a thank you message. ### Quick Form Audit A site admin needs to know if they launched a new campaign form. They ask: 'List all donation forms.' The MCP uses `list_donation_forms` and provides the names, IDs, and status of every form on the site. ### Post-Campaign Review The team just finished a major charity drive. They ask: 'What were the overall stats for the Annual Fund form?' The MCP uses `get_form_performance` to provide total funds and average donation size, eliminating manual calculation. ## Benefits - Stop clicking through multiple dashboard tabs. You can ask your agent to list all active forms or get the goal progress for a specific campaign in one command, saving minutes every day. - Deep dive into individual giving. Instead of manually searching for records, use the `find_donor_history` tool to pull up a donor's entire giving journey instantly. - Better reporting means more money. Automatically gather all necessary data by listing donations and form stats, making weekly reports accurate and fast. - Confidence in your setup. Use `verify_api_connection` whenever you need assurance that the link between your AI client and your donation database is live and functioning. - Manage forms without logging in. You can list all available giving options or get specific form metadata, all through natural conversation with your agent. ## How It Works The bottom line is you talk to your AI client, and it handles all the database querying for donation reports. 1. Subscribe to this MCP on Vinkius and provide your WordPress Base URL along with the necessary GiveWP API keys. 2. Your AI client connects using these credentials, establishing a secure, read-only link to your donation database. 3. You ask your agent any question—like 'What was our average gift last month?' or 'Show me Jane Doe's history.'—and it pulls the precise data. ## Frequently Asked Questions **How do I connect GiveWP MCP to my donation site?** You subscribe through Vinkius and provide your WordPress Base URL along with your GiveWP API keys. The connection is read-only, ensuring data safety. **Can I use the givewp mcps to edit donations?** No, this MCP only provides read access. You can view and report on donation history using tools like `list_plugin_donations`, but you cannot make any changes. **What if I want stats for a specific campaign?** Use the `get_form_performance` tool. You just need to provide the form ID or name, and your agent will pull total funds raised, donation counts, and other key metrics. **Does GiveWP MCP track non-WordPress donations?** No. This MCP is specifically designed to connect only with donations processed through the GiveWP WordPress plugin on your site. **Which tool should I use to see all my donors?** Use the `list_plugin_donors` tool. It compiles a list of every unique individual who has ever donated money through the system.