# Kindful MCP for AI Agents AI Agent Connect

> Kindful. Manage your nonprofit's donor data and fundraising campaigns through your AI agent. Query contacts, track donations, and monitor campaign progress without switching tabs. It connects your CRM directly to your workflow.

## Overview
- **Category:** data-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_0iyZcd0byygRNb1cb0Yb78j0mUdZOrDMh5okmIHn/ai-agent-connect
- **Tags:** donor-management, fundraising, crm, nonprofit, transaction-tracking

## Description

Managing a nonprofit means juggling donor history, campaign targets, and contact lists across multiple windows. This Connector puts that data right in front of your AI agent. Instead of digging through a dashboard to see how much a specific group donated last quarter, you just ask your agent to pull the numbers. It handles the heavy lifting of filtering contacts by location or email status and tracking down transaction records with specific dates. You can link external IDs to keep your records in sync with other parts of your tech stack, ensuring your data stays clean without the manual copy-pasting. Because Vinkius hosts this integration, you can get your Kindful data into Claude or Cursor in minutes. It's about having your fundraising history ready whenever you need to write a report or plan a new drive.

## Tools

### get_custom_fields
Get your custom fields. This helps you see the specific data points you've set up in Kindful.

### create_import
Create a new data import job. Use this to bring in records from your other systems.

### get_campaigns
List all active fundraising campaigns. This shows you the goals and progress for every drive.

### get_groups
Get your donor groups. Use this to see how your contacts are organized by category.

### get_import_stats
Get your import stats. This lets you see how many records were successfully processed.

### get_import_status
Get the import job status. Use this to check if your recent data upload is finished.

### get_org_details
Get organization details. This pulls your nonprofit's basic metadata and setup info.

### link_contact
Link a contact to an external ID. This keeps your donor records synced with your other tools.

### link_transaction
Link a transaction to an external ID. This ensures your financial records match across platforms.

### query_contacts
Query contacts in Kindful. Use this to find donors based on location, email, or keywords.

### query_transactions
Query transactions in Kindful. This lets you pull donation history for specific dates or campaigns.

### verify_webhook
Verify webhook events. Use this to make sure your data is flowing correctly between systems.

## Prompt Examples

**Prompt:** 
```
Show me the progress of our current fundraising campaigns.
```

**Response:** 
```
I've pulled the status for your active campaigns:

| Campaign | Goal | Raised | Progress |
| :--- | :--- | :--- | :--- |
| **Annual Gala** | $50,000 | $45,000 | 90% |
| **Clean Water Project** | $20,000 | $12,000 | 60% |
| **Youth Education** | $10,000 | $5,500 | 55% |
```

**Prompt:** 
```
Find all donors in the 'Major Gift' group who have a valid email.
```

**Response:** 
```
I found 12 contacts in the 'Major Gift' group with valid email addresses:

*   **Alice Johnson** (alice@example.com)
*   **Bob Smith** (bob.s@provider.net)
*   **Charlie Davis** (charlie.d@domain.org)
*   *(10 more contacts found)*

Would you like me to pull more details for these donors?
```

**Prompt:** 
```
How much did we raise for the 'Gala' campaign last month?
```

**Response:** 
```
For the 'Annual Gala' campaign, you raised a total of **$2,450** since January 1st, 2024. 

**Key Stats:**
*   **Total Donations:** 8
*   **Largest Donation:** $1,000 from donor ID 4567.
```

## Capabilities

### Query donor contacts
Find specific donors using keywords like location, email status, or group membership.

### Track donation transactions
Pull donation history filtered by specific dates or campaign IDs.

### Monitor fundraising campaigns
See active goals, total amounts raised, and current progress for all drives.

### Link external record IDs
Connect Kindful records to other systems to keep your data in sync.

### Retrieve organization metadata
Get your nonprofit's custom fields and group configurations instantly.

### Check import statuses
Monitor the progress of your recent data uploads and import stats.

## Use Cases

### Checking campaign progress during a meeting
A Development Director asks for the status of the 'Clean Water' drive. The agent uses get_campaigns to show the total raised against the goal.

### Finding specific donor segments
An admin needs to find all donors in the 'Major Gift' group with a valid email. The agent uses query_contacts and get_groups to pull the list.

### Syncing new leads from a website
A data manager wants to bring in 500 new leads. The agent uses create_import and link_contact to get the data into Kindful and keep IDs in sync.

### Auditing recent donations
A director wants to see all donations from last month for a specific campaign. The agent uses query_transactions to pull the exact totals.

## Benefits

- Stop switching tabs to check donor history. Use query_contacts to pull lists directly into your conversation.
- Get instant fundraising updates. Use get_campaigns to see goals and totals without opening a dashboard.
- Keep your data clean and synced. Use link_contact and link_transaction to connect Kindful to your other apps.
- Faster reporting for directors. Use query_transactions to pull specific donation history for any date.
- Easier data management. Use get_import_stats to monitor your record uploads in real time.
- Instant org insights. Use get_org_details to grab your nonprofit's metadata and custom fields.

## How It Works

The bottom line is you get a direct line to your fundraising data without leaving your chat interface.

1. Subscribe to this Connector and get your Kindful API Token and Subdomain.
2. Paste those credentials into your AI client's configuration.
3. Start asking your agent to pull donor lists or campaign totals.

## Frequently Asked Questions

**Can Kindful MCP help me manage donor research?**
Yes, it allows your AI agent to query contacts and pull specific donor information based on keywords, groups, and email status.

**How does Kindful MCP handle my donation records?**
It lets your agent pull transaction history filtered by specific dates or campaign IDs, making it easy to see exactly where your funding comes from.

**Can I use Kindful MCP to sync my data with other apps?**
Yes, you can use the linking tools to connect Kindful records to external IDs, ensuring your data stays consistent across your entire tech stack.

**Does Kindful MCP show my fundraising campaign goals?**
Yes, it retrieves your active campaigns along with their specific goals, total amounts raised, and overall progress.

**Is Kindful MCP good for managing large data imports?**
It can help you monitor the status and stats of your data imports, so you can verify that your records are moving into your CRM correctly.

**Can Kindful MCP manage my nonprofit's custom fields?**
Yes, it can retrieve your organization's specific metadata and custom field configurations so your agent understands your unique setup.

**How can I find donors located in a specific area?**
You can use the `query_contacts` tool with the `near_postal` parameter, providing a zip code and a radius to filter donors by geography.

**Can I see the total amount raised for my active campaigns?**
Yes! The `get_campaigns` tool returns a list of all campaigns including the `raised` amount and the `goal` for each one.

**Is it possible to filter transactions by a specific date range?**
Absolutely. Use the `query_transactions` tool with the `after` and `before` parameters (formatted as yyyy/mm/dd) to isolate records within a timeframe.