# Grocery Store Basket Comparator AI Agent Connect

> Grocery Store Basket Comparator MCP calculates the most economical way to complete your grocery shopping. It looks at unit prices, travel expenses, and available discounts to determine which store actually saves you the most money. You can use it with any MCP-compatible client like Claude or Cursor to turn a simple list into a cost-optimized shopping plan.

## Overview
- **Category:** finance
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_CWIqeosOBe0KAcKV4CXB0inFIIiTS3H5RiFVSH98/ai-agent-connect
- **Tags:** grocery, comparison, savings, budget, shopping-list

## Description

Stop guessing which grocery store has the best deals. This MCP acts as a decision engine for your shopping trips by looking at the math that actually matters. Instead of just looking at item prices, it factors in unit costs, travel expenses, and active discounts to give you a real total. 

You can use it to run a full comparison across multiple retailers or just check the subtotal for a specific shop. If a brand you want is out of stock, the MCP can evaluate if a substitute is a good deal based on quantity and price. It also provides inventory summaries so you know if a store even has what you need before you drive there. It's about making sure your budget goes further by doing the math for you.

## Tools

### compare_baskets
This tool finds the most economical store for your entire list. It compares total costs across different retailers to pick the winner.

### calculate_store_subtotal
This tool calculates the specific cost for a single store. It provides the subtotal for your items at a chosen location.

### evaluate_substitution
This tool checks if a replacement item is a viable option. It compares the substitute against your original requirements.

### get_store_inventory_summary
This tool provides a summary of what a store has in stock. It helps you see how well a retailer matches your specific needs.

## Prompt Examples

**Prompt:** 
```
Which store is cheapest for my list: 2kg Flour, 1L Milk, and 12 Eggs?
```

**Response:** 
```
The cheapest store is SuperMart with a total cost of $12.50, saving you $2.10 compared to the most expensive option.
```

**Prompt:** 
```
Can I use a substitute for the milk if the brand I want is missing?
```

**Response:** 
```
Yes, the substitution is valid as the available 1L brand meets your minimum quantity requirement.
```

**Prompt:** 
```
How much will I spend at the local Express store?
```

**Response:** 
```
The subtotal for the Express store is $15.00 before travel fees.
```

## Capabilities

### Multi-store comparison
Your agent compares total costs across different retailers to find the lowest price.

### Unit price analysis
The MCP calculates unit prices to ensure you get the best value per item.

### Travel cost factoring
Your agent includes travel expenses in the total cost calculation.

### Substitution checking
The MCP evaluates if a replacement item meets your needs and budget.

### Inventory verification
Your agent checks store inventory summaries to confirm item availability.

## Use Cases

### Weekly Meal Planning
You provide a list of ingredients and the MCP finds the cheapest store to buy them all.

### Substitution Decisions
When an item is out of stock, the agent checks if a different brand is a better value.

### Budget Tracking
You use the subtotal tool to see exactly how much a specific store trip will cost.

### Inventory Checking
You check a store's inventory summary to see if they have your specific brands in stock.

## Benefits

- Reduces total grocery spending by identifying the cheapest retailer.
- Accounts for travel expenses to prevent losing savings on gas.
- Validates item substitutions to maintain quality and quantity.
- Saves time by checking store inventory before you leave home.

## How It Works

Connecting this MCP to your AI client gives your agent immediate access to grocery pricing and inventory data.

1. Connect the MCP to your client like Claude or Cursor via Vinkius.
2. Provide your shopping list to your AI agent.
3. The agent uses the comparison tools to calculate costs and travel fees.
4. Your agent presents the most economical shopping plan.

## Frequently Asked Questions

**How does this MCP find the cheapest store?**
It compares the total cost of your items across different stores, including unit prices, discounts, and travel expenses.

**Does it account for gas money?**
Yes, the MCP calculates travel expenses as part of the total cost to ensure the cheapest option is actually the most economical.

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

**What happens if a store is out of an item?**
You can use the substitution tool to see if a different brand or product is a valid and cost-effective replacement.

**How do I get started?**
You subscribe through Vinkius, which hosts the MCP for you, and then connect it to your preferred AI client with one click.

**How does the tool calculate the cheapest store?**
The `compare_baskets` tool calculates the total cost for each store by summing item prices (adjusted for package size) and adding the specific travel cost for that location.

**What happens if an item is out of stock?**
The engine uses `evaluate_substitution` to check if a valid replacement is available. A store is only considered a valid option if it can fulfill 100% of your list through direct matches or valid substitutions.

**Does it account for travel costs?**
Yes, travel costs are a fixed overhead included in the total cost calculation for every store to ensure you find the true cheapest option.
