# Donorbox MCP MCP

> Donorbox connects your AI agent directly to donation data, letting you manage funds, track donor accounts, and monitor fundraising campaigns instantly. You can list every contribution received, check active recurring plans, or find specific donors using just natural conversation.

## Overview
- **Category:** payment-processing
- **Price:** Free
- **Tags:** donations, fundraising, donor-profiles, recurring-plans, non-profit, subscription-management

## Description

Managing donations shouldn't mean jumping between spreadsheets and dashboards. This MCP gives your AI client direct access to Donorbox’s full suite of financial tools. Need to know how much was raised for the 'Save the Oceans' campaign? Ask it. Want a list of every recurring payment due next month? It pulls that data. You can check donation history, audit donor profiles, and even find out who contributed most recently—all without writing a single query. When you connect this MCP through Vinkius, your agent acts like an expert operations manager, turning complex financial oversight into simple conversation.

## Tools

### get_donorbox_account_metadata
Pulls key information about the user account currently connected to Donorbox.

### get_campaign_details
Retrieves the specific settings and current progress for one selected fundraising campaign.

### quick_campaign_performance_audit
Provides an immediate, high-level summary detailing how successful all fundraising campaigns are performing overall.

### list_active_subscription_plans
Provides a list of all recurring payment plans that are currently marked as active in the system.

### list_fundraising_campaigns
Returns a list of all fundraising campaigns that have been set up in the organization's Donorbox profile.

### list_donorbox_donations
Gathers and lists every single donation record received within your Donorbox account.

### list_registered_donors
Fetches a list of every donor profile registered within the organization's Donorbox system.

### list_latest_contributions
Identifies and lists the most recent donations received, showing who gave what and when.

### list_recurring_donation_plans
Lists all active recurring donation plans available for management.

### search_donors_by_email
Searches the donor database and returns a profile if a specific email address is provided.

## Prompt Examples

**Prompt:** 
```
List all recent donations received in Donorbox.
```

**Response:** 
```
I've found 5 recent donations, including $25.00 from 'Alice Johnson' and $100.00 from 'Michael Smith'. All are marked as 'Completed'. Would you like to see which campaign they supported?
```

**Prompt:** 
```
Show me the performance for campaign 'Save the Oceans'.
```

**Response:** 
```
The 'Save the Oceans' campaign has raised $12,450 towards its $15,000 goal (83% reached). There are currently 12 active recurring donors for this campaign. Should I pull the list of recent contributions?
```

**Prompt:** 
```
Find the recurring plan for donor 'sarah.jones@example.org'.
```

**Response:** 
```
Sarah Jones has an active monthly recurring plan of $50.00 that started on January 1st. They have made 3 successful payments to date. Would you like me to check their next scheduled donation date?
```

## Capabilities

### Audit Donations
Pull detailed records and payment statuses for every contribution made to the organization.

### Manage Subscriptions
Identify all active recurring donation plans, checking their frequency and status across your donor base.

### Monitor Campaigns
View campaign goals, track total funds raised, and see progress percentages for specific initiatives.

### Find Specific Donors
Search the database by email address to quickly locate a donor’s profile and history.

## Use Cases

### Checking End-of-Month Finances
The finance team needs a total of funds raised for Q2. They ask their agent, 'What's the performance on all campaigns?' The agent runs `quick_campaign_performance_audit` and returns the summary data instantly.

### Following Up with Key Donors
A manager needs to send a thank-you note but can't remember an old donor's email. They ask, 'Find all donors who gave over $500 in 2023.' The agent runs `list_donorbox_donations` and helps filter the list.

### Auditing Subscription Health
The operations team suspects some recurring payments are failing. They ask, 'Show me all active monthly plans that started last quarter.' The agent uses `list_active_subscription_plans` to pinpoint the exact records.

### Researching a Prospect
A development director gets an email from a potential major donor. They ask, 'What is this person's history?' The agent uses `search_donors_by_email` and provides the full profile for immediate follow-up.

## Benefits

- You instantly see who gave what by using `list_latest_contributions`, giving you real-time insights into your cash flow without manual reports.
- Keep tabs on all funding streams. Run `quick_campaign_performance_audit` to get a single score card view of how every campaign is performing against its goal.
- Never forget a recurring payment status again. The `list_active_subscription_plans` tool shows exactly which plans are active and due for renewal.
- Need background on one person? Use `search_donors_by_email` to pull up their full profile, donation history, and contact details immediately.
- Keep your donor records current by running `list_registered_donors`, ensuring you have the latest metadata available in one place.

## How It Works

The bottom line is that your AI client handles the connection and data retrieval steps for you, so you only have to ask questions.

1. Connect this MCP to your AI client. You'll authorize it using your Donorbox account email and API Key.
2. Your agent uses the connected tools to perform an action, like listing all campaigns or finding a donor record.
3. The system returns clean data directly to your conversation window, letting you act on the information immediately.

## Frequently Asked Questions

**How do I check campaign progress using the Donorbox MCP?**
You can use `quick_campaign_performance_audit` for an overall view. If you need details on a specific effort, ask your agent to run `get_campaign_details`, referencing that campaign's name.

**Can I find a donor using the Donorbox MCP?**
Yes. Use the `search_donors_by_email` tool by providing an email address, and your agent will return the corresponding donor profile for you to review.

**What if I want to see all my contributions? Do I use list_donorbox_donations?**
Yes. `list_donorbox_donations` pulls every record received in your account, giving you the full transaction history available for analysis.

**How do I check if a recurring plan is active with Donorbox MCP?**
You can run `list_active_subscription_plans`, which specifically identifies all payment plans currently marked as 'Active' in the system.

**How do I check my connection status and account details using get_donorbox_account_metadata?**
You retrieve metadata for the current user. This tool confirms your API credentials are valid and helps verify which Donorbox organization your AI agent is connected to.

**I need a list of all possible campaigns before I select one; what should I use? Do I call list_fundraising_campaigns?**
Using list_fundraising_campaigns provides an inventory of every campaign set up in your Donorbox account. This lets you see the names and basic status of all configured fundraising efforts.

**If I only want to review donations from today or yesterday, should I use list_latest_contributions instead of listing everything?**
List_latest_contributions is faster for reviewing recent activity. It pulls the most recently received donations, giving you a quick snapshot without retrieving your entire contribution history.

**How can I get a complete roster of every donor in my system? Do I use list_registered_donors?**
list_registered_donors retrieves the full directory of all donors recorded in your organization. This is useful for auditing and identifying profiles that aren't linked to a specific recent donation.

**How do I get a Donorbox API Key?**
Log in to your Donorbox account, navigate to **Account > API & Integrations**, and you can generate or retrieve your unique API Key from there. You will also need your account email.

**Can the agent manage recurring plans?**
This integration currently focuses on listing and auditing recurring plans and their status. Modifying plan details or amounts should be managed via the Donorbox dashboard.

**Does the integration show donor contact info?**
Yes, you can use the list_registered_donors or search_donors_by_email tools to retrieve donor profile details, including their registered email addresses.