# Grocery List Totalizer AI Agent Connect

> Grocery List Totalizer MCP gives your AI agent the ability to process grocery lists and calculate exact costs. It handles everything from individual item pricing to full financial summaries and list integrity checks. You can use it within Claude, Cursor, or Windsurf to manage your shopping budget without manual math.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_VaqxSrRJubGAIcmEk0appFIMrqN3hgMYQqycDpfF/ai-agent-connect
- **Tags:** grocery, shopping-list, budgeting, calculator, finance-tracker

## Description

You can stop manually adding up prices every time you plan a grocery run. This MCP gives your AI client the specific tools it needs to act as a personal shopping accountant. Instead of guessing your total, you can hand a raw list of items and quantities to your agent and get a complete financial breakdown immediately. 

It works by analyzing the data you provide to pull out specific costs or count how many different products you're buying. If you're worried about missing something or if a list is formatted incorrectly, the integrity check ensures the data is ready for a real transaction. It's a straightforward way to turn a messy list of food items into a structured budget report.

## Tools

### calculate_list_summary
This tool provides a full financial breakdown of your grocery list. It calculates the subtotal and the cost for every individual item.

### count_unique_products
This tool counts how many different types of products are in your list. It ignores quantities to tell you exactly how many distinct items you need to find.

### get_item_cost
This tool finds the total cost for one specific item. It multiplies the price by the quantity for the product you name.

### validate_list_integrity
This tool checks your list to make sure it meets the minimum requirements for a valid transaction. It ensures your data is clean before you try to process it.

## Prompt Examples

**Prompt:** 
```
Can you give me a summary of this grocery list: [{"name": "Milk", "price": 3.50, "quantity": 2}, {"name": "Bread", "price": 2.00, "quantity": 1}]?
```

**Response:** 
```
The subtotal is $9.00. Item totals: Milk: $7.00, Bread: $2.00. Total items: 2.
```

**Prompt:** 
```
How many unique products are in this list: [{"name": "Apple", "price": 0.50, "quantity": 5}, {"name": "Apple", "price": 0.50, "quantity": 2}, {"name": "Banana", "price": 0.30, "quantity": 10}]?
```

**Response:** 
```
There are 2 unique products in the list.
```

**Prompt:** 
```
What is the total cost for Bread in this list: [{"name": "Milk", "price": 3.50, "quantity": 2}, {"name": "Bread", "price": 2.00, "quantity": 3}]?
```

**Response:** 
```
The total cost for Bread is $6.00.
```

## Capabilities

### Financial Summaries
Your agent generates a full breakdown of costs and subtotals.

### Itemized Costing
The AI calculates the specific price for any single product in your list.

### Product Counting
Your agent identifies the number of unique product types you are buying.

### Data Validation
The tool checks if your list is valid for a transaction.

## Use Cases

### Budget Tracking
Paste a list of items to see if you are staying under your planned spending limit.

### Inventory Auditing
Count unique products in a large list to see how many different categories you are purchasing.

### Price Comparison
Use itemized costs to compare different shopping lists side by side.

### List Verification
Run a validation check to ensure your list has all the necessary data for a purchase.

## Benefits

- Eliminates manual math errors when totaling grocery costs.
- Provides instant itemized breakdowns from raw list data.
- Verifies list data integrity before you head to the store.

## How It Works

Connecting this MCP to your AI client is a one-time setup that enables immediate list processing.

1. Subscribe to the MCP on Vinkius.
2. Connect your AI client like Claude or Cursor using the provided link.
3. Paste your grocery list data into your chat interface.
4. Ask your agent to calculate totals, count items, or validate the list.

## Frequently Asked Questions

**How do I use this with Claude?**
You connect the MCP through the Vinkius platform. Once connected, you can simply paste your list into Claude and ask it to perform calculations.

**Can it handle multiple quantities of the same item?**
Yes. The tools calculate the total cost by multiplying the price by the quantity provided in your list.

**What does list integrity mean?**
The validation tool checks if your list contains the necessary information required to process a valid transaction.

**Do I need to host this myself?**
No. Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.

**Can it tell me how many different things I am buying?**
Yes. The count_unique_products tool specifically identifies the number of different product types in your list.

**How can I get a full summary of my grocery list?**
You can use the `calculate_list_summary` tool to receive the subtotal, individual item totals, and the total number of items in your list.

**Can I check if my list is valid for a transaction?**
Yes, the `validate_list_integrity` tool checks if your list meets the necessary requirements, such as having at least one item and valid prices and quantities.

**How do I find the cost of a specific item?**
Use the `get_item_cost` tool by providing the name of the item and the list of items to calculate its specific total.