# Hobby Supply Shopping Planner AI Agent Connect

> Hobby Supply Shopping Planner MCP connects your AI client to your project needs and existing tool inventory. It prevents wasted spending by checking what you already own before suggesting new purchases. Your agent can compare shipping costs and generate optimized shopping lists to keep your hobby projects on track and under budget.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_JzgWK3Yyt0x0OEbzCNo2erZLRIJ2Hr3fIKO16vAr/ai-agent-connect
- **Tags:** procurement, budgeting, hobbyist, inventory, logistics

## Description

You shouldn't have to buy a whole new set of tools just to start a single project. This MCP acts as a procurement specialist for your hobby work. It bridges the gap between your project goals and your actual workshop inventory. Instead of guessing what you need, your AI client can look at your specific project requirements and cross-reference them with the tools you already have on hand. This ensures you only spend money on the exact materials required to finish the job. Beyond just making a list, you can use it to run numbers on different shipping speeds or vendor options to see how they hit your wallet. It turns your AI agent into a logistics manager that keeps your hobby organized and your budget intact.

## Tools

### calculate_shopping_list
This tool builds a custom purchase list by comparing what your project requires against the items you already have in your inventory and your remaining budget.

### check_user_inventory
This tool scans your existing collection of tools to identify what you already own and can reuse for a new project.

### get_project_requirements
This tool pulls the specific list of materials and equipment needed to successfully complete a defined hobby project.

### simulate_shipping_impact
This tool calculates how different shipping tiers or vendor groupings change the total cost of your order.

## Prompt Examples

**Prompt:** 
```
I want to start a Miniature Painting Starter project. My budget is $50 and my user ID is user_123. What should I buy?
```

**Response:** 
```
To complete the Miniature Painting Starter project within your $50 budget, you need to purchase 2 sets of acrylic paints and 1 fine-tip brush. The total estimated cost including shipping is $42.50.
```

**Prompt:** 
```
What tools do I need for Basic Woodworking?
```

**Response:** 
```
The Basic Woodworking project requires a hand saw, a set of clamps, a measuring tape, and sandpaper.
```

**Prompt:** 
```
How much will it cost to ship my hobby supplies using express shipping?
```

**Response:** 
```
Using express shipping for your current shopping list will result in a shipping cost of $15.00, bringing your final total to $65.00.
```

## Capabilities

### Inventory Cross-Referencing
Your agent checks your current toolset before suggesting new purchases.

### Budget Optimization
The AI generates shopping lists that stay within your specified spending limits.

### Shipping Cost Analysis
Your client compares standard, express, and economy shipping to find the best price.

### Requirement Mapping
The tool identifies every material needed for a specific project type.

## Use Cases

### New Project Kickoff
You tell your AI what you want to build, and it tells you exactly what to buy based on what you lack.

### Budget Management
You set a strict dollar limit, and the AI ensures your shopping list stays under that amount.

### Shipping Comparison
You test how much faster shipping will cost compared to standard delivery for your supplies.

### Inventory Auditing
You use the tool to see which of your existing tools can be used for upcoming tasks.

## Benefits

- Reduces duplicate purchases by checking your current inventory first.
- Prevents budget overruns by calculating costs before you checkout.
- Saves time by generating organized shopping lists automatically.
- Compares shipping tiers to find the cheapest delivery method.

## How It Works

The MCP connects your project goals directly to your budget and inventory data.

1. Connect your AI client to the Hobby Supply Planner MCP via Vinkius.
2. Provide your project details or specific material needs to your agent.
3. The agent checks your existing inventory to see what you can reuse.
4. The agent calculates a shopping list that fits your budget.
5. You review the final cost including shipping options provided by the AI.

## Frequently Asked Questions

**How does this MCP prevent me from overspending?**
It compares your project requirements against your specific budget and your existing inventory to ensure you only buy what is necessary.

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

**Does it help with shipping costs?**
Yes, the simulate_shipping_impact tool lets you compare how different shipping speeds affect your total project cost.

**How does it know what I already own?**
The check_user_inventory tool identifies the reusable tools you already have in your possession.

**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 tool prevent me from buying tools I already own?**
The `calculate_shopping_list` tool compares the project requirements against your current inventory using `check_user_inventory` to ensure only missing tools are added to the list.

**Can I plan for projects that exceed my budget?**
Yes. If the total cost exceeds your `maxBudget`, the tool will still provide a prioritized list of necessary items, but the `isWithinBudget` flag will be set to false.

**Does the tool account for shipping costs?**
Yes, the total estimated cost includes a standard shipping fee. You can also use `simulate_shipping_impact` to evaluate how different shipping methods affect your final total.
