# Shared Gift Shopping Plan AI Agent Connect

> Shared Gift Shopping Plan MCP handles the math and logistics of group gift buying. It connects to your AI client to analyze what recipients actually want, sum up everyone's contributions, and verify that your chosen gift will actually arrive before the deadline.

## Overview
- **Category:** shopping
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_h4BCndgZ3qIgLF9WhT2opWCY0T70B31qu5A0YcJ7/ai-agent-connect
- **Tags:** gifts, group-buying, budgeting, logistics, planning

## Description

Buying a gift for a group is usually a mess of spreadsheets and missed deadlines. This MCP turns your AI client into a dedicated gift coordinator. Instead of guessing what someone wants or worrying if a package will show up on time, you can let your agent handle the heavy lifting. You provide the recipient details and the contribution amounts, and the MCP does the rest. It checks recipient profiles to match tastes, calculates the total pool of money you have to spend, and runs shipping simulations to ensure you don't miss the big day. It's built to take the friction out of organizing gifts for families, office teams, or friend groups.

## Tools

### calculate_available_budget_tool
This tool sums up all individual contributions to find the total amount available for your purchase.

### generate_gift_plan_tool
This tool produces a specific gift recommendation that fits the recipient's tastes, your budget, and your delivery deadline.

### get_recipient_preferences_tool
This tool pulls the profile of a specific person to see their likes and dislikes.

### validate_logistics_tool
This tool checks if a specific shipping method and purchase date will actually get the gift delivered on time.

## Prompt Examples

**Prompt:** 
```
Help me plan a gift for recipient 'user_123' with a total budget of $100. The gift must arrive by 2024-12-25 and shipping takes 5 days.
```

**Response:** 
```
The suggested gift is a Premium Coffee Maker kit for $85.00. It is expected to arrive on 2024-12-20, which fits your budget and the deadline.
```

**Prompt:** 
```
Calculate the total budget if the contributions are 20, 30, and 50.
```

**Response:** 
```
The total available budget is $100.00, with an average contribution of $33.33.
```

**Prompt:** 
```
Check if I can buy a gift on 2024-11-01 with a 10-day shipping time for a deadline of 2024-11-15.
```

**Response:** 
```
Yes, the delivery is feasible. The estimated arrival date is 2024-11-11, providing a 4-day buffer before the deadline.
```

## Capabilities

### Recipient Profiling
Your agent uses this to match gifts to specific likes and dislikes.

### Budget Aggregation
The agent calculates the total pool of money from multiple contributors.

### Logistics Verification
The agent checks shipping times against your required delivery date.

### Plan Generation
The agent creates a final recommendation based on all constraints.

## Use Cases

### Office Holiday Gifts
A team collects money for a coworker and needs a gift that fits the collective budget.

### Family Birthday Coordination
Family members contribute different amounts to buy a single large gift for a parent.

### Wedding Gift Planning
A group of friends ensures a gift arrives at the wedding venue on time.

### Club or Team Milestones
A sports team organizes a gift for a coach based on their specific interests.

## Benefits

- Eliminates manual budget math by summing contributions automatically.
- Reduces gift errors by checking recipient preference profiles.
- Prevents late deliveries by validating shipping windows before you buy.
- Centralizes the planning process within your existing AI chat interface.

## How It Works

Connect the MCP to your client and start planning through natural language.

1. Connect the MCP to Claude, Cursor, or your preferred client via Vinkius.
2. Tell your agent who the gift is for and how much money the group has.
3. The agent uses the tools to check preferences and shipping feasibility.
4. Your agent presents a final gift plan that meets all your requirements.

## Frequently Asked Questions

**How does this MCP help with group budgets?**
It uses a specific tool to sum up all individual contributions, giving you a clear total of the available funds.

**Can it prevent gifts from arriving late?**
Yes, it includes a tool to validate logistics by checking shipping times against your required deadline.

**How does it know what to buy?**
The agent accesses recipient profiles to understand specific likes and dislikes before making a recommendation.

**Which AI clients can I use this with?**
You can use this with any MCP-compatible client like Claude, Cursor, or Windsurf.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you, so it is ready to use immediately after connection.

**How does the tool ensure the gift arrives on time?**
The `validate_logistics` tool checks the purchase date and shipping lead time against the required deadline to ensure the delivery is feasible. Tools available: `get_recipient_preferences_tool`, `calculate_available_budget_tool`, `validate_logistics_tool`.

**Can I use this to manage a budget for multiple people?**
Yes, you can use `calculate_available_budget` to determine the total pool of money collected from all participants.

**What happens if no gift fits the budget?**
If no gift satisfies the recipient's interests while staying within the budget and timeline, the `generate_gift_plan` tool will return an error.
