# Grocery Spend Trend Analyzer AI Agent Connect

> Grocery Spend Trend Analyzer MCP lets your AI client dig into your grocery transaction history. You can pull weekly summaries by store or category, track how your spending changes over time, and check if you're staying within your set budget limits.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cZCWBBVD4S99oOxbvLy4uuzhcSYBcPVqXHVOQ0Rv/ai-agent-connect
- **Tags:** grocery, spending, budget, transactions, analytics

## Description

Stop guessing where your money goes every time you hit the supermarket. This MCP connects your AI client directly to your grocery transaction data so you can get real answers about your habits. Instead of scrolling through endless bank statements, you can just ask your agent for a breakdown of what you spent on produce last month or how your dairy budget is looking. 

You can use the get_weekly_summary tool to see exactly how much you're spending at specific stores or within certain food categories. It helps you spot trends, like if your average basket size is creeping up, or if a specific grocery chain is costing you more than you realized. If you have strict spending limits, your agent can monitor your category budgets to make sure you don't overspend. It's a straightforward way to keep your food budget on track without the manual math.

## Tools

### get_weekly_summary
This tool provides a breakdown of your grocery spending by week, store, or category. You can use it to see exactly where your money went over a specific seven day period.

## Prompt Examples

**Prompt:** 
```
How much did I spend on groceries last week?
```

**Response:** 
```
Last week, you spent a total of $145.50, with the largest portion being Produce at $42.00.
```

**Prompt:** 
```
Am I over budget on Dairy?
```

**Response:** 
```
No, your current spending for Dairy is $25.00, which is below your $30.00 limit.
```

**Prompt:** 
```
What was my average basket size in January?
```

**Response:** 
```
Your average basket size in January was $62.30.
```

## Capabilities

### Weekly Spending Summaries
Your agent pulls totals grouped by week, store, or food category.

### Budget Compliance Monitoring
The AI checks your current spending against your predefined category limits.

### Trend Analysis
Your agent compares current spending against historical baselines to find patterns.

### Basket Size Calculation
The AI calculates the average amount you spend per shopping trip.

## Use Cases

### Budget Enforcement
Ask your agent if you have enough room left in your produce budget before you head to the store.

### Store Comparison
Compare how much you spend at different grocery chains to find the best value.

### Spending Audits
Review your average basket size to see if your shopping trips are becoming more expensive.

### Weekly Reviews
Get a quick summary of your total grocery outflow every Sunday night.

## Benefits

- Eliminates manual calculation of weekly grocery totals.
- Provides instant feedback on whether you are exceeding category budgets.
- Identifies shifts in spending habits through historical comparisons.

## How It Works

Connect your preferred AI client to the Vinkius hosted MCP to start querying your data.

1. Connect your AI client to the MCP via Vinkius.
2. Grant the necessary permissions for the agent to access transaction data.
3. Ask your agent a question about your grocery spending.
4. The agent uses the available tools to pull and analyze your data.
5. Receive a direct answer or summary in your chat interface.

## Frequently Asked Questions

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

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

**Can I track spending for specific grocery stores?**
Yes, you can use the weekly summary tool to filter your spending by specific stores.

**How does the budget check work?**
The agent compares your actual transaction totals against the spending limits you have set for specific categories.

**How can I see my weekly spending breakdown?**
You can use the `get_weekly_summary` tool by providing a start and end date to see totals for categories and stores.

**Can I check if I am exceeding my budget for specific items?**
Yes, the `check_category_budget_compliance` tool checks your spending against predefined category caps.

**How do I compare my current spending to previous months?**
Use the `get_monthly_trend_vs_baseline` tool to compare current monthly spending against a historical baseline period.
