# GiveForms MCP for AI Agents AI Agent Connect

> GiveForms MCP helps you pull donation data and manage fundraising reports using AI agents. It connects your GiveForms account so you can query records, track campaigns, and look up donor history without leaving your workspace. This connection lets you move from manual dashboard navigation to instant, conversational answers for your entire organization's giving data.

## Overview
- **Category:** payment-processing
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6Vru7cRcFpCiQgy6HVNumYQoCNmw6iRfqxOefPv7/ai-agent-connect
- **Tags:** donation-forms, fundraising, donor-data, payment-collection, nonprofit

## Description

Instead of jumping between tabs to find out who gave what, this Connector lets you talk directly to your donation database. If you're trying to figure out how a specific campaign is performing or need to see a donor's history, you can just ask your agent. It handles the heavy lifting of filtering through hundreds of records so you can focus on the actual fundraising. You'll find it's a lot faster than manually exporting CSVs or digging through a dashboard every time a question pops up. By adding this to your setup via the Vinkius marketplace, you're basically giving your agent a direct line to your organization's giving data. It's about getting answers in seconds rather than minutes of clicking. Whether you're checking if a large gift hit the account or trying to identify a recurring donor, the data shows up exactly when you need it. This is built for people who need to see the facts without the friction of a traditional UI. It turns a static database into a dynamic conversation where you can verify contributions, check campaign progress, and get metadata on any specific gift without having to remember where everything is stored. You can stop worrying about whether the data is up to date and start using it to make better decisions for your organization.

## Tools

### verify_api_connection
Check if your GiveForms account is properly linked to the Connector. This ensures your data is ready for use.

### find_donations_by_email
Search for all donations linked to a specific donor email address. This helps in tracking unique donor history.

### get_donation_details
Fetch the specific metadata and details for a single donation record. Use this to see the context of a specific gift.

### list_campaign_donations
Filter and list all donations associated with a particular campaign ID. This is perfect for tracking specific fundraisers.

### list_all_donations
Get a full list of all donation records in your account. This is useful for high-level data exports or audits.

### list_recent_donations
See the most recent contributions to your organization. Use this to check for new gifts quickly.

### find_donations_by_name
Locate donation records associated with a specific donor's full name. Use this for quick name-based lookups.

### get_organization_info
Retrieve high-level metadata for your authenticated organization. This verifies your account settings.

## Prompt Examples

**Prompt:** 
```
Show me the 3 biggest donations from last month.
```

**Response:** 
```
I've pulled the records for last month. Here are the top 3 contributions:

| Donor Name | Amount | Date |
| :--- | :--- | :--- |
| **Sarah Jenkins** | $5,000 | Oct 12 |
| **Riverside Foundation** | $3,200 | Oct 14 |
| **Michael Chen** | $1,500 | Oct 15 |

Would you like to see the full metadata for any of these?
```

**Prompt:** 
```
Did anyone with the email test@example.com donate recently?
```

**Response:** 
```
Searching records for that email...

**test@example.com** has made 2 donations totaling **$150**. 

*   **$50** on Oct 1st for the 'Fall Drive'
*   **$100** on Oct 10th for 'General Fund'
```

**Prompt:** 
```
How many donations did campaign 12345 get?
```

**Response:** 
```
Fetching data for campaign 12345... 

That campaign has received **42 donations** totaling **$12,450**. 

Would you like me to list the most recent 5 contributions for this campaign?
```

## Capabilities

### Pull all donation records
Retrieve a complete list of all contributions in your account.

### View recent contributions
See the latest gifts that have come into your organization.

### Search donors by email
Find all records associated with a specific donor's email address.

### Search donors by name
Locate donation records based on a donor's full name.

### Filter by campaign ID
Retrieve only the donations linked to a specific fundraising campaign.

### Get donation metadata
Fetch specific details and metadata for an individual contribution.

### Get organization info
Access high-level metadata for your authenticated organization.

### Verify connection status
Check if your GiveForms account is correctly linked to the Connector.

## Use Cases

### Checking a large gift status
A Development Lead needs to see if a $5,000 gift from a local business hit the account. They ask the agent to list recent donations.

### Auditing a specific fundraiser
A Finance person needs to audit a specific fundraiser. They use list_campaign_donations to get a clean list of all contributions for that ID.

### Personalizing donor outreach
A Donor Relations Manager wants to see how many times a specific person has given. They search by email to see the full history.

### Verifying account connectivity
An admin needs to confirm their account is linked correctly before a meeting. They run verify_api_connection to check the status.

### Retrieving organization metadata
A team lead wants to see the high-level metadata for their organization's account. They use get_organization_info to verify settings.

## Benefits

- Stop manual data entry by using list_all_donations to pull records into your current workspace instantly.
- Identify recurring donors faster by searching history with find_donations_by_email or find_donations_by_name.
- Get a clear picture of specific goals using list_campaign_donations to see how a single fundraiser is performing.
- Save time on reporting by using list_recent_donations to see what just came in without refreshing a browser.
- Verify your setup quickly with verify_api_connection to ensure your data is always ready for your agent.
- Access deep metadata for specific gifts using get_donation_details to understand the context of each contribution.
- Confirm your account is correctly linked by using get_organization_info to check high-level metadata.

## How It Works

The bottom line is you get instant access to your fundraising data through a natural conversation.

1. Subscribe to the GiveForms MCP through the Vinkius Marketplace.
2. Enter your Organization ID and API Key from your GiveForms settings.
3. Ask your AI client to query donation records or search for specific donors.

## Frequently Asked Questions

**Can I use GiveForms MCP to see my donor history?**
Yes, you can. The Connector allows your agent to search for all previous contributions associated with a specific donor's email or name, giving you a full view of their giving history.

**Does GiveForms MCP work with my current AI client?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. Once connected, your agent can access your GiveForms data directly.

**Is my donation data safe with this Connector?**
Yes. The connection is secured using your own GiveForms API keys, ensuring that only your authorized agent can access your organization's specific records.

**Can I filter donations by a specific campaign?**
Yes, you can. You can ask your agent to show only the donations associated with a particular campaign ID to see how specific fundraisers are performing.

**How do I connect my GiveForms account to the Connector?**
You just need your Organization ID and API Key from your GiveForms settings. You enter these into your Connector configuration to link the two services.

**Can I see the most recent donations?**
Yes, your agent can quickly pull a list of the latest contributions so you can see what just came in without having to log into your dashboard.

**Can I search for a donor by their name?**
Yes, the Connector includes a tool specifically for finding donation records based on a donor's full name, making it easy to look up specific people.

**How do I get an API Key for GiveForms?**
Log in to your GiveForms dashboard, navigate to Settings > Integrations, and look for the REST API section to find your Organization ID and API Key.

**Can I manually add donations via the agent?**
The current version of the GiveForms API is primarily designed for data retrieval and auditing. Creation tools may be added in future updates.

**How do I find a specific Campaign ID?**
The Campaign ID is the number found at the end of the URL when you view or edit a campaign within your GiveForms dashboard.

**Is the donation data returned in real-time?**
Yes, all data retrieved through this Connector is fetched directly from the GiveForms REST API, providing you with the latest available donation records.