# Givebutter MCP > Givebutter connects your nonprofit's fundraising data to any AI agent through Model Context Protocol (MCP). Use this MCP to automate donor management, track every donation transaction, and monitor campaign performance without leaving your chat client. ## Overview - **Category:** customer-relationship-management - **Price:** Free - **Tags:** donations, fundraising, donor-management, campaigns, nonprofit ## Description This MCP lets you manage all things related to non-profit fundraising. You can connect your Givebutter account to your preferred AI client—like Claude or Cursor—and run complex reports using simple conversation. Need to know how much was raised for the 'Annual Gala'? Ask, and it returns the campaign metadata instantly. The tool also lets you list every donation transaction, giving you full visibility into revenue flow. Want to update donor records? You can search for profiles and even programmatically add new contacts. Plus, if someone gives money outside of Givebutter's platform, you don't have to manually enter it; the MCP allows you to record offline donations, keeping your data unified. Because Vinkius hosts this full catalog, you get access to all these features in one place, letting your agent do the heavy lifting. ## Tools ### verify_api_connection Checks if your connection credentials to Givebutter are active. ### sync_donor_contact Adds a newly identified donor contact profile into the system's database. ### record_offline_donation Manually logs details for a donation or payment that happened outside of Givebutter. ### get_account_details Retrieves general identifying information about your connected nonprofit account. ### get_campaign_details Fetches the current metadata and status of a specific fundraising campaign. ### get_transaction_details Retrieves detailed information about any single donation or transaction record. ### list_fundraising_campaigns Lists all active fundraising campaigns currently running through Givebutter. ### list_donor_contacts Presents a list of existing donor profiles and contact records. ### list_recurring_plans Lists all configured donation plans that happen on a regular schedule. ### list_recent_donations Retrieves the ten most recent successful donations made to the organization. ### list_donation_transactions Lists all donation transactions, providing metadata like status and timestamps. ### list_donation_webhooks Displays the configuration details for webhooks that track donations in real time. ## Prompt Examples **Prompt:** ``` List all successful donations from the last 24 hours. ``` **Response:** ``` Retrieving donations... I found 12 successful transactions in the last 24 hours, totaling $1,250.00. Would you like to see the details for the largest one? ``` **Prompt:** ``` Check the progress of our 'Annual Gala' campaign (ID: gala_2024). ``` **Response:** ``` Fetching campaign details... The 'Annual Gala' has raised $45,000 so far, which is 75% of your $60,000 goal. There have been 150 unique donors. ``` **Prompt:** ``` Log an offline donation of $50.00 from 'Alice Smith' (ID: contact_123). ``` **Response:** ``` Donation logged! I have successfully recorded the $50.00 offline transaction for Alice Smith. The new Transaction ID is 'tx_98765'. ``` ## Capabilities ### Report on financial activity The MCP fetches and lists all donation transactions, providing metadata like status and timestamps. ### Review fundraising efforts You can list active campaigns and retrieve detailed information about their configuration and total funds raised. ### Manage donor records The MCP lets you search for existing profiles, view contact details, and add new donors to your database. ### Log external payments Record donations or payments that happen outside of the primary system into the MCP data set. ### Track long-term giving commitments List and monitor configured recurring donation plans to understand future funding streams. ## Use Cases ### Need to reconcile recent funds. A finance manager needs to know if the large donation from last week has fully cleared. They ask their agent to check 'last 10 successful' donations, and the tool provides a list of the most recent records, including status, letting them verify the payment instantly. ### Onboarding a new board member. A development director needs a full picture of a donor's commitment. They ask their agent to list all recurring plans and check general account details using `get_account_details`, giving them the necessary history for an appeal. ### Tracking campaign progress remotely. A director is traveling and needs a quick performance update on 'Annual Gala.' They ask their agent to fetch campaign metadata, which provides the total raised amount right away, without needing VPN or desktop access. ## Benefits - Stop manual data gathering. Instead of clicking through dashboards to list recent transactions or check a single transaction's status, simply ask your agent for the details using `list_donation_transactions` or `get_transaction_details`. The answer appears instantly in your chat. - Never lose track of donor history again. You can use the MCP to search and get detailed contact metadata about any profile via `list_donor_contacts`, making every follow-up personal and informed. - Handle complex finance tasks from anywhere. If a donation happens offline, you don't have to manually enter it; just ask your agent to log it using `record_offline_donation` and keep all data in one place. - Get an instant performance overview of campaigns. Instead of digging into campaign settings, use `list_fundraising_campaigns` to get the total amount raised for any active event instantly. - Automate donor growth. When you meet a new contact at an event, your agent can immediately sync their details using `sync_donor_contact`, ensuring they are properly recorded in your database. ## How It Works The bottom line is that your AI agent acts as an immediate interface, letting you query and manipulate Givebutter data without ever logging into the actual platform. 1. Subscribe to this MCP through the Vinkius Marketplace, then enter your Givebutter API key. 2. Your AI agent uses the provided tools to request specific data—for example, listing recent donations or fetching campaign details. 3. The MCP returns structured information directly into your chat client, allowing you to read a summary or execute follow-up commands. ## Frequently Asked Questions **How do I get an API Key for Givebutter?** Log in to your Givebutter dashboard, navigate to Settings > Developers > API, and you can generate a new secret API key there. **Can I process live credit card transactions via the agent?** No, this integration is for management and data retrieval. For security, live donor checkouts must still happen through Givebutter's secure forms. **What format should the donation amount be in?** The Givebutter API uses major units for amounts. For example, to record a $10.50 donation, you should provide the decimal value '10.50'. **How do I link a transaction to a specific campaign?** Use the 'campaign_id' parameter in the 'record_offline_donation' tool. You can find your campaign IDs using the 'list_fundraising_campaigns' tool.