# Donation Recipient Matcher AI Agent Connect

> Donation Recipient Matcher is a matching engine that connects donation items with the most suitable recipient organizations. It handles the heavy lifting of evaluating recipient profiles, checking if they have the room for your items, and ensuring your transport plans actually work with their schedules.

## Overview
- **Category:** charity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zXn0cw9w4vRAGL0L0G0XlhhKlmGLVdGF3jJVqMzG/ai-agent-connect
- **Tags:** donation, logistics, matching, charity, planning

## Description

You can stop guessing which charity needs what. This MCP acts as a coordination engine between your donated goods and the organizations that can actually use them. Instead of manually checking if a food bank is full or if a shelter accepts specific types of clothing, you let your AI client do the math. It looks at recipient profiles, their current capacity, and your specific donor priorities to find the best fit. It also handles the logistics of the handoff, making sure your delivery vehicle matches the recipient's availability. You get a clear plan for how to prepare items so they meet the specific rules of the organization you're helping. It turns a messy logistical problem into a structured execution plan.

## Tools

### check_handoff_compatibility
This tool checks if your delivery logistics align with when the recipient is actually available to receive items.

### generate_preparation_checklist
This tool builds a specific list of tasks to get your items ready according to the recipient's requirements.

### match_donation_recipient
This tool finds the best organization for your donation and builds a full execution plan.

### validate_recipient_capacity
This tool confirms whether a specific organization can handle the amount of items you are trying to give them.

## Prompt Examples

**Prompt:** 
```
Find the best recipient for 50 boxes of canned food that are sealed and new.
```

**Response:** 
```
Food Bank Alpha is the best match. They have the capacity for 50 units, accept canned food, and require items to be sealed.
```

**Prompt:** 
```
Can I deliver these items using a personal vehicle tomorrow morning?
```

**Response:** 
```
Yes, the recipient supports personal vehicle transport during their morning handoff window.
```

**Prompt:** 
```
What tasks do I need to do to prepare these items for the shelter?
```

**Response:** 
```
You need to ensure all items are placed in sealed containers and labeled clearly as per the recipient's rules.
```

## Capabilities

### Recipient Matching
Your agent uses this to find the best organization based on donor priorities and recipient profiles.

### Capacity Verification
Your agent checks if an organization can physically take the quantity of items you have.

### Logistics Alignment
Your agent confirms that your transport method and timing work for the recipient.

### Preparation Planning
Your agent generates specific instructions to ensure items meet recipient standards.

## Use Cases

### Bulk Food Distribution
Match large quantities of canned goods to food banks that have the shelf space to take them.

### Clothing Drives
Ensure clothing donations meet the specific packaging and labeling rules of local shelters.

### Delivery Scheduling
Verify that a personal vehicle or truck can drop off items during a recipient's open window.

### Inventory Management
Check if a specific recipient can handle a sudden influx of items to avoid overwhelming them.

## Benefits

- Reduces rejected donations by checking capacity before you arrive.
- Prevents logistical mismatches between drivers and recipients.
- Ensures items meet specific organizational rules before delivery.
- Automates the selection process for the best donation destination.

## How It Works

The MCP connects your AI client to a matching engine that handles logistics and capacity.

1. Connect your AI client to the MCP via Vinkius.
2. Tell your agent what you are donating and how much you have.
3. The agent runs matching and capacity checks to find the best recipient.
4. The agent verifies that your transport plan works with the recipient's schedule.
5. The agent provides a checklist to prepare the items for a successful handoff.

## Frequently Asked Questions

**How does the MCP decide which recipient is best?**
It evaluates recipient profiles, their current capacity, and the specific priorities of the donor.

**Can I use this with Claude or Cursor?**
Yes, you can connect this MCP to any MCP-compatible client like Claude, Cursor, or Windsurf.

**Will it tell me if a charity is too full to take my items?**
Yes, the validate_recipient_capacity tool specifically checks if a recipient can handle your requested quantity.

**Does it help with delivery timing?**
Yes, the check_handoff_compatibility tool determines if your logistics align with the recipient's availability.

**How do I know how to pack the donations?**
The generate_preparation_checklist tool creates a task list based on the specific rules of the recipient.

**How does the matching logic work?**
The system uses `match_donation_recipient` to find a match that satisfies category requirements, condition rules, capacity limits, and transport availability.

**Can I check if a recipient has enough space?**
Yes, you can use the `validate_recipient_capacity` tool to verify if a recipient can handle the specific quantity of items you are donating.

**How do I know if my transport is compatible?**
The `check_handoff_compatibility` tool compares your available transport methods against the recipient's supported access methods to ensure a successful handoff.