# Custom Gift Cost Planner AI Agent Connect

> Custom Gift Cost Planner is a pricing engine that lets your AI agent handle the math for custom gift orders. It calculates everything from the base item price and personalization fees to shipping, gift wrapping, and taxes. Instead of manual calculations, your AI client gets a full cost breakdown in seconds.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_u4hJQT6O2XnbJSGIflglNQajoflivhfMSzLtnmcV/ai-agent-connect
- **Tags:** pricing, calculator, gifts, e-commerce, logistics

## Description

You can stop manually calculating the math for every custom gift order. This MCP acts as a dedicated pricing engine for your AI agent, handling the complex math involved in personalized e-commerce. When a customer wants a custom item, your agent uses this MCP to pull the base price and add on specific costs like intricate engraving or rush shipping. It accounts for the small details that often get missed, such as gift wrapping fees or local tax rates. You can ask for a complete quote in one go or drill down into specific costs like fulfillment or personalization. It's built to handle the messy variables of custom retail, giving your AI client the ability to provide accurate, real-time pricing to customers or internal teams.

## Tools

### calculate_personalization_cost
This tool determines the specific fee for adding custom details to an item. It calculates costs based on the level of personalization requested.

### get_base_item_price
This tool retrieves the starting price of a specific gift item. It provides the foundation for the total quote calculation.

### get_total_gift_quote
This tool generates a complete price breakdown for an entire order. It aggregates base prices, personalization, shipping, and taxes into one final number.

### calculate_fulfillment_fees
This tool calculates the costs associated with preparing and shipping an order. It covers items like standard shipping and gift wrapping services.

## Prompt Examples

**Prompt:** 
```
What is the total cost for item 'gift_001' with standard personalization, express shipping, gift wrap, and a 5% tax rate?
```

**Response:** 
```
The total cost for the custom gift is $45.50, which includes the base price, personalization, express shipping, gift wrap, and 5% tax.
```

**Prompt:** 
```
How much does it cost to add intricate personalization to item 'luxury_vase_99'?
```

**Response:** 
```
The personalization fee for intricate customization on the luxury vase is $25.00.
```

**Prompt:** 
```
Calculate the fulfillment fees for a standard shipping order that includes gift wrap but no rush processing.
```

**Response:** 
```
The fulfillment fees are $12.00, consisting of $10.00 for standard shipping and $2.00 for gift wrapping.
```

## Capabilities

### Full Quote Generation
Your agent pulls a single, all-inclusive price including taxes and shipping.

### Personalization Math
The AI calculates specific surcharges for custom engravings or modifications.

### Fulfillment Costing
Your client determines the exact cost of shipping and gift wrapping services.

### Granular Price Auditing
The agent can isolate the base price from the add-on fees for detailed analysis.

## Use Cases

### Customer Chat Support
An AI agent uses the MCP to tell a customer exactly how much their custom vase will cost including shipping.

### Order Auditing
A user checks the fulfillment fees for a specific order to ensure the math is correct.

### Price Modeling
An operator tests how different personalization levels change the final quote for a product line.

### Automated Checkout Assistance
Your agent calculates the final price including tax and gift wrap before a customer completes a purchase.

## Benefits

- Eliminates manual math errors in custom order quotes.
- Provides instant price breakdowns for complex gift configurations.
- Centralizes all pricing variables like taxes and shipping in one place.

## How It Works

Connecting this MCP to your AI client gives it immediate access to your pricing logic.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Your agent identifies the need for a price calculation.
3. The agent calls the relevant tool, such as get_total_gift_quote.
4. The MCP processes the base price, fees, and taxes.
5. Your agent receives the final numbers and presents them to you.

## Frequently Asked Questions

**What can this MCP calculate?**
It calculates base item prices, personalization fees, fulfillment costs, and total quotes including taxes and shipping.

**Which AI clients can use this MCP?**
You can use this with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.

**Does it handle shipping costs?**
Yes, it includes tools to calculate fulfillment fees which cover shipping and gift wrapping.

**Can I get a detailed breakdown of a price?**
Yes, you can use individual tools to look at base prices or personalization costs separately from the total quote.

**How do I get started?**
Since Vinkius hosts the MCP, you just connect your client once and the tools are ready to use immediately.

**How does the tool calculate the final price?**
The tool sums the base price, personalization fee, gift wrap cost, and rush fee to create a subtotal. It then applies the tax rate to that subtotal and adds the shipping cost to reach the final total.

**Can I calculate shipping costs separately?**
Yes, you can use `calculate_fulfillment_fees` to get specific costs for shipping, gift wrapping, and rush processing without generating a full quote.

**What complexity levels are supported for personalization?**
The system supports 'standard' and 'intricate' complexity levels for calculating personalization fees.
