# GivingFuel MCP MCP > GivingFuel retrieves donation orders, tracks individual donor responses, and gives you oversight of all fundraising pages via your AI agent. Instead of jumping between tabs to check payment status or campaign progress, your client talks to this MCP, pulling together records for nonprofits and ministries instantly. ## Overview - **Category:** customer-relationship-management - **Price:** Free - **Tags:** fundraising, donor-management, donation-pages, registrations, nonprofit ## Description This connector links up your GivingFuel account so your AI agent can handle the messy parts of donor management. You get a natural conversation interface that pulls in data from donation orders, individual donor profiles, and active campaigns. It's built to do more than just list records; it helps you see payment health by checking both successful and failed charges. All this functionality is managed through Vinkius, giving your agent access to thousands of other services when you need them. You can easily check every listing, from recent donations to configuration details for specific fundraising pages, all without leaving your chat window. ## Tools ### verify_api_connection Runs a simple check to confirm that your connection key is active and working correctly. ### filter_orders_by_status Narrows down the list of donation orders by their current completion status (e.g., refunded, pending). ### filter_orders_by_date Filters donation orders based on a specific date range you provide. ### list_crm_contacts Retrieves detailed profiles for all listed donors. ### list_donation_orders Fetches a complete list of every donation order recorded in the system. ### list_peer_campaigns Retrieves data related to specific peer-to-peer fundraising campaigns. ### list_fundraising_pages Gets a list of all active donation pages and their setup details. ### list_recent_donations Provides a quick list of the ten most recent donation orders. ### list_donation_registrants Lists all individual people who have registered as donors. ### list_financial_transactions Retrieves data on successful and failed payments to check payment health. ## Prompt Examples **Prompt:** ``` List the last 5 donation orders received. ``` **Response:** ``` Retrieving orders... I found 5 recent donations, including $100 from 'Michael Scott' and $50 from 'Jim Halpert'. Would you like to see the registrant details for any of them? ``` **Prompt:** ``` Show me all fundraising pages active in my account. ``` **Response:** ``` Retrieving pages... I found 3 active donation pages: 'Fall Gala 2024', 'Building Fund', and 'Monthly Giving Circle'. Which one would you like to see the configuration for? ``` **Prompt:** ``` How many donations were marked as 'refunded' today? ``` **Response:** ``` Checking transactions... I found 2 donation orders marked as 'refunded' today, totaling $75.00. One was for the 'Summer Camp' fund. ``` ## Capabilities ### Get Donor Profiles Access unified donor records and detailed form responses to track long-term engagement. ### Review Donation Status List all donation orders, allowing you to filter by date range or status (like pending or refunded). ### Track Finances and Payments Access financial processing data for both successful charges and failed attempts. ### Manage Campaign Assets List all active fundraising pages, events, and peer-to-peer campaigns with their specific configuration details. ## Use Cases ### Audit Failed Payments A finance manager needs to know why $5,000 in donations didn't clear last week. They ask their agent to check failed charges between two dates using `list_financial_transactions` and `filter_orders_by_date`. The agent returns a clean list of the transaction IDs and error codes. ### Campaign Review A development director needs to know which campaigns are active. They ask for all pages using `list_fundraising_pages`. The system not only lists the names but also pulls the specific configuration metadata for each, allowing them to spot outdated event settings. ### Donor Outreach Preparation A staff member is preparing a donor report. They use `list_donation_registrants` first, then cross-reference those names with the detailed profiles using `list_crm_contacts`. This quickly builds a segmented list for personalized follow-up. ### Tracking P2P Activity Someone wants to gauge engagement from a recent online event. They use `list_peer_campaigns` to see which campaigns ran and who participated, giving them an instant view of the peer-to-peer activity. ## Benefits - Stop manually checking statuses. You can use `list_recent_donations` to get the last ten orders immediately, giving you a real-time pulse on your incoming funds. - Drill down into specific records without leaving chat. If you need to check payment health, you can use `list_financial_transactions` to see both successful and failed charges. - Manage large donor lists efficiently. Instead of pulling up one profile at a time, running `list_crm_contacts` gives you an overview of every connected person's history. - Keep track of campaign assets using `list_fundraising_pages`. This tool doesn't just list names; it gets the detailed configuration for each page. - Filter data to narrow your focus. Need orders from last quarter? Use `filter_orders_by_date` before running a full check with `list_donation_orders`. - Check everything first. Always run `verify_api_connection` at the start of a session. It confirms that all ten tools will actually work. ## How It Works The bottom line is that your agent handles all the API calling so you just get a clean answer. 1. Subscribe to this MCP through Vinkius and enter your GivingFuel API key. 2. Your AI agent sends a request; the MCP validates the connection and pulls data from GivingFuel's backend. 3. The agent responds with the specific, filtered records—whether they are donation orders or donor details—right in your chat. ## Frequently Asked Questions **How do I get an API Key for GivingFuel?** Log in to your GivingFuel account, navigate to Extras > Integrations > API Keys, and click 'Add API Key' to generate your key. **Can I add new donations via the agent?** The GivingFuel Public API is primarily designed for data extraction and polling. To record new donations, use your GivingFuel hosted donation pages. **How do I filter donations for a specific date range?** Use the 'filter_orders_by_date' tool and provide an ISO date (YYYY-MM-DD). The agent will retrieve all records created after that date. **Does this support multiple Webconnex products?** This MCP server is specifically configured to filter results for GivingFuel (givingfuel.com). It ensures you only see fundraising-related data. **How do I use the `verify_api_connection` tool to check my GivingFuel setup?** Running this tool immediately confirms if your API key works. It sends a quick ping to GivingFuel's system, letting you know right away if the credentials are valid and if data retrieval is possible. **What if I need to use the `filter_orders_by_status` tool for 'pending' transactions?** You can filter orders by status, which is critical for finding incomplete or pending donations. This helps your agent identify specific payments that require manual follow-up or confirmation. **How does the `list_crm_contacts` tool help me understand donor history?** This tool gives you unified profiles from Webconnex, moving beyond just donation records. You retrieve comprehensive data points that show a donor's long-term relationship and engagement with your organization. **Can I get detailed metadata using the `list_fundraising_pages` tool?** Yes, this MCP retrieves more than just page names. It pulls configuration details for each active fundraising page, letting you see crucial information like event dates or specific goal amounts.