# School Supply Budgeter MCP. AI Agent Connect

> School Supply Budgeter helps you handle the math behind back-to-school shopping. Your AI client can browse available supplies, calculate specific item costs, and run grand totals including tax. It even checks your list against a set budget to make sure you don't overspend.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OzXHZo5qwAYJw2JiP5YU7WHEFLn6HYsYpO6wW3su/ai-agent-connect
- **Tags:** budgeting, school, shopping, calculator, supplies

## Description

Managing school supplies shouldn't feel like a math exam. Whether you are a teacher prepping a classroom or a parent checking off a list for the kids, this MCP handles the tedious calculations for you. You can ask your AI client to look through the supply catalog to see what is available, then have it figure out exactly how much a specific quantity of items will cost. When you have a full list ready, the MCP calculates the subtotal, adds the tax, and gives you a final number. Most importantly, you can set a spending limit and let your agent verify if your current list fits within that amount. It turns a messy pile of receipts and lists into a controlled, predictable process.

## Tools

### aggregate_shopping_list
This tool calculates the total cost, tax, and grand total for your entire list of items.

### list_available_supplies
Use this to see a full catalog of available school supplies.

### calculate_item_subtotal
This tool finds the subtotal for a specific quantity of a single item.

### validate_budget_limit
This tool checks your shopping list against a set budget to ensure you stay under your limit.

## Prompt Examples

**Prompt:** 
```
What school supplies are available in the writing category?
```

**Response:** 
```
The writing category includes Pencils, Pens, Highlighters, and Erasers.
```

**Prompt:** 
```
How much will 5 Pencils cost?
```

**Response:** 
```
5 Pencils will cost $2.50.
```

**Prompt:** 
```
Calculate the total for 2 Notebooks and 10 Pencils with a 7% tax rate.
```

**Response:** 
```
The total budget is $5.00, the tax amount is $0.35, and the grand total is $5.35.
```

## Capabilities

### Catalog Browsing
Your agent looks up what supplies are currently in stock.

### Item Costing
The AI calculates the cost for specific quantities of individual items.

### Tax and Totaling
Your client calculates the final price including tax for a whole list.

### Budget Verification
The agent checks your list against a maximum spending limit.

## Use Cases

### Classroom Prep
A teacher builds a list of pens and notebooks and checks the total against their classroom budget.

### Back-to-School Shopping
A parent uses the agent to see if they can afford the items on their child's required list.

### Bulk Order Verification
An administrator checks if a large order of supplies stays within the school's spending cap.

### Inventory Planning
An educator uses the catalog to see what items are available before making a purchase.

## Benefits

- Eliminates manual math errors during shopping.
- Prevents overspending by validating lists against budget limits.
- Speeds up the planning phase of school supply procurement.

## How It Works

Connecting to this MCP gives your AI client immediate access to supply data and math tools.

1. Connect the MCP to your client through Vinkius.
2. Ask your agent to browse the available supplies catalog.
3. Provide a list of items and quantities to your agent.
4. Have the agent calculate the totals and tax.
5. Run a budget validation to confirm the total is acceptable.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect to the MCP through the Vinkius platform. Once connected, your client like Claude or Cursor will automatically see the tools available for use.

**Can this MCP handle sales tax?**
Yes, the aggregate tool calculates the subtotal, the tax amount, and the final grand total for your list.

**Will it tell me if I am over budget?**
Yes, you can use the budget validation tool to check if your shopping list exceeds your planned spending limit.

**Do I need to provide my own supply list?**
You can provide your own list, or you can use the tool to browse the available supplies catalog to build one.

**Is there a way to check individual item prices?**
Yes, the tool can calculate the subtotal for any specific quantity of an item you choose.

**How do I see what supplies are available?**
You can use the `list_available_supplies` tool to view the full catalog of items and their unit prices.

**Can I calculate the total cost including tax?**
Yes, the `aggregate_shopping_list` tool allows you to provide a tax rate to calculate the grand total.

**How can I check if I am over my budget?**
Use the `validate_budget_limit` tool to check if your list of items fits within your specified budget.