# Coupon Bundle Comparator AI Agent Connect > Coupon Bundle Comparator MCP calculates the most cost-effective way to hit your shopping targets. It analyzes unit prices, package sizes, and various discount types to find the absolute lowest total spend for any required quantity of items. ## Overview - **Category:** finance - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ij68nxOALvHVHaQxkmTgAnfCAz8IdCjlbzd7kl3N/ai-agent-connect - **Tags:** coupon, bundle, optimization, pricing, shopping-assistant ## Description You can stop guessing whether a bulk pack or individual items are cheaper. This MCP acts as a math engine for your shopping decisions. When you need a specific number of items, your AI client uses this tool to weigh every possible combination of single units, multi-packs, and bundles. It doesn't just look at the sticker price; it factors in percentage discounts and specific coupon rules to ensure you aren't leaving money on the table. If you have a specific coupon in mind, you can check its validity against your planned purchase before you head to the checkout. It handles the heavy lifting of comparing unit costs across different packaging formats so you can just focus on the final total. ## Tools ### calculate_item_surplus This tool identifies how many extra units you end up with if you buy specific packages to meet a minimum requirement. ### get_best_purchase_plan This tool finds the single cheapest combination of products and packages to satisfy your target quantity. ### simulate_single_option_cost This tool calculates the total cost of one specific purchase option before you run a full optimization. ### validate_coupon_eligibility This tool checks if a specific discount or coupon applies to the items or packages you have selected. ## Prompt Examples **Prompt:** ``` What is the cheapest way to get 10 units of Item A if they are $2 each, or available in a pack of 6 for $10, with a $2 coupon for any pack? ``` **Response:** ``` The cheapest way is to buy one pack of 6 for $8 after the $2 coupon and 4 individual units at $2 each, for a total of $16. ``` **Prompt:** ``` I need 5 units of Item B. Item B costs $5 individually. There is a bundle of 3 for $12. What is my best plan? ``` **Response:** ``` The best plan is to buy one bundle of 3 for $12 and 2 individual units for $10, totaling $22. ``` **Prompt:** ``` Check if a $5 off coupon is valid for a $20 purchase of Item C. ``` **Response:** ``` The coupon is valid for this purchase. ``` ## Capabilities ### Price Optimization Your agent finds the lowest total cost for a specific quantity of goods. ### Coupon Validation The AI checks if your specific discounts apply to your current cart selection. ### Bundle Comparison It compares the value of bulk packages against individual unit prices. ### Surplus Tracking The tool calculates how many extra items you receive when buying larger packs. ### Cost Simulation Your agent can test the price of a single purchase option in isolation. ## Use Cases ### Bulk vs. Individual Comparison Decide if buying a 12-pack is actually cheaper than buying 12 individual items. ### Coupon Strategy Verify if a specific discount will work on your planned bundle before you buy it. ### Inventory Planning Calculate exactly how many extra units you'll have left over after meeting a minimum stock requirement. ### Multi-item Optimization Find the best combination of different package sizes to reach a target quantity. ## Benefits - Reduces total spend by identifying hidden savings in bundles. - Eliminates manual math when comparing unit prices. - Prevents wasted money on invalid coupon applications. - Accounts for extra inventory acquired through bulk purchases. ## How It Works Connect the MCP to your AI client and start feeding it pricing data. 1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius. 2. Provide your AI client with the item prices, package sizes, and available coupons. 3. Ask your agent to find the best purchase plan or validate a specific discount. 4. Receive a calculated breakdown of the cheapest way to fulfill your needs. ## Frequently Asked Questions **How does this MCP find the cheapest option?** It evaluates unit prices, package sizes, and coupon constraints to find the combination that results in the lowest total spend. **Can I use this with Claude or Cursor?** Yes, you can connect this MCP to any compatible client like Claude, Cursor, or Windsurf through the Vinkius platform. **Does it handle coupons?** Yes, it includes a tool specifically to check if a coupon is eligible for your selected items or packages. **What happens if a bundle gives me more items than I need?** The tool can calculate the surplus to show you exactly how many extra units you are getting from a bundle purchase. **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 optimization work?** The engine calculates every valid combination of individual units and packages, applying all applicable coupons and bundle rules to find the lowest total price. **What happens if I buy more items than needed?** If a package contains more units than your target quantity, the extra units are tracked as surplus using the `calculate_item_surplus` tool. **Can I check if a specific coupon is valid for my items?** Yes, you can use the `validate_coupon_eligibility` tool to verify if a proposed selection of items meets the requirements of a specific coupon.