# Beneficiary Collection Allocation Plan AI Agent Connect

> Beneficiary Collection Allocation Plan MCP handles the complex logic of matching specific items to the right people. It uses a rules-based engine to check eligibility, weigh beneficiary preferences, and execute the final distribution. You can connect it to Claude, Cursor, or Windsurf to turn raw lists of assets and people into a finished allocation plan.

## Overview
- **Category:** logistics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_lbeV3nlJ8fwn0vsPU4RACmDll1jWt3hS8spfrYbg/ai-agent-connect
- **Tags:** allocation, beneficiaries, distribution, rules-engine, asset-management

## Description

You can use this MCP to take the guesswork out of distributing assets. Instead of manually checking who qualifies for what, you let your agent handle the heavy lifting. It works by running your items through a set of constraints you define. It checks if a recipient actually meets the requirements before any allocation happens. 

Once eligibility is confirmed, the engine looks at what people actually want. It uses preference scoring to ensure items go to those with the highest interest, provided they qualify. If two people want the same thing, the engine applies tie-breaking logic to keep things fair. After the math is done, the MCP helps you wrap things up by generating the messages needed to tell everyone the results. It's a structured way to manage logistics for any scenario where items must be handed out to a specific group of people.

## Tools

### verify_eligibility
This tool checks if a specific beneficiary meets the requirements for a particular item. It returns a clear yes or no based on your constraints.

### allocate_collection
This is the primary engine that matches your list of items to your list of beneficiaries. It executes the core matching logic using your rules.

### generate_communication_plan
This tool creates a structured set of messages for your recipients. It helps you notify beneficiaries about their allocation results.

### get_preference_score
This tool calculates how much a beneficiary wants a specific item. It provides a weight used to prioritize distributions.

## Prompt Examples

**Prompt:** 
```
Allocate these items: [{"id": "item1", "type": "jewelry"}] to these beneficiaries: [{"id": "user1", "preferences": {"item1": "primary"}}] using alphabetical tie-breaking.
```

**Response:** 
```
{"allocations": [{"itemId": "item1", "beneficiaryId": "user1"}], "unallocatedItems": [], "appliedRules": ["alphabetical"], "communicationActions": [{"recipientId": "user1", "message": "Your item has been allocated."}]}
```

**Prompt:** 
```
Check if beneficiary 'user1' is eligible for item 'item1' with restriction 'age > 18'.
```

**Response:** 
```
{"isEligible": true, "exclusionReason": null}
```

**Prompt:** 
```
What is the preference score for 'user1' regarding 'item1'?
```

**Response:** 
```
{"score": 10, "priorityLevel": "primary"}
```

## Capabilities

### Eligibility Enforcement
Your agent uses this to prevent unqualified recipients from receiving specific assets.

### Preference Weighting
The engine calculates scores to prioritize items based on beneficiary desire.

### Automated Matching
Your AI client runs the full allocation logic to pair items with people.

### Notification Drafting
The MCP produces structured messages to inform people of their results.

## Use Cases

### Resource Distribution
Distribute supplies to specific community members based on strict need-based criteria.

### Inventory Allocation
Match company equipment to employees based on their specific job requirements.

### Grant or Prize Management
Assign awards to winners by weighing their application scores against available prizes.

### Membership Perks
Allocate limited edition items to members based on their loyalty tier or preferences.

## Benefits

- Eliminates manual errors in eligibility checking.
- Uses mathematical scoring to handle beneficiary preferences.
- Provides a structured way to handle tie-breaking scenarios.
- Generates ready-to-use communication plans for recipients.

## How It Works

You connect the MCP to your client and provide your data for processing.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your lists of items and beneficiaries to your agent.
3. Define the eligibility and preference rules you want to follow.
4. Run the allocation tool to execute the matching logic.
5. Generate the communication plan to notify everyone involved.

## Frequently Asked Questions

**How does the MCP handle ties in allocation?**
The engine uses specific tie-breaking rules, such as alphabetical order, to decide between two eligible beneficiaries who want the same item.

**Can I use this with Claude?**
Yes, you can connect this MCP to Claude or any other MCP-compatible client once you've connected to Vinkius.

**Does it check if people are actually allowed to receive items?**
Yes, the verify_eligibility tool is specifically designed to check if a recipient meets your required constraints.

**What happens if an item isn't allocated?**
The allocation output includes a list of unallocated items so you know exactly what is left over.

**How are beneficiary preferences handled?**
The get_preference_score tool calculates a weight for each item based on how much a beneficiary wants it, which the engine uses during matching.

**How does the allocation logic handle conflicts?**
The engine uses `allocate_collection` to resolve conflicts using a deterministic tie-break rule, such as alphabetical order, when eligibility and preference levels are identical.

**Can I check if a person is eligible for a specific item?**
Yes, you can use the `verify_eligibility` tool to check if a beneficiary meets all the specific restrictions and requirements for a particular item.

**How are beneficiaries notified of the results?**
The `generate_communication_plan` tool produces structured messages for both successful allocations and unallocated items based on the provided contact information.