# Yarn Ball Calculator AI Agent Connect

> Yarn Ball Calculator MCP handles the math for your knitting and crochet projects. It calculates exactly how many balls of yarn you need to buy, checks if your current stash is enough for a specific pattern, and estimates your total material costs. It rounds up to the nearest whole unit so you never end up short mid-stitch.

## Overview
- **Category:** planning
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AXWqquboNrUsLP7pm01wc8eQuHeBj1JRGn4UZKa0/ai-agent-connect
- **Tags:** textile, knitting, crochet, inventory-management, math

## Description

Stop guessing how much yarn you need for your next project. This MCP gives your AI client the ability to manage your textile inventory and project math. Instead of manually dividing meters by ball length, you can just tell your agent what your pattern requires and let it do the work. It handles the rounding logic to ensure you always buy enough whole units to finish a piece. You can also check your existing stash against new project requirements to see if you can start immediately or if you need to head to the shop. It's a simple way to keep your craft budget and your supply closet in sync.

## Tools

### get_required_balls
Calculates the specific number of whole yarn balls you need to purchase for a project.

### get_yarn_inventory_summary
Sums up the total length of yarn you have available based on your current stock.

### validate_supply_sufficiency
Checks if your current yarn inventory is enough to complete a specific project requirement.

### calculate_project_cost_estimate
Provides a total cost estimate for the yarn needed for a project based on unit price.

## Prompt Examples

**Prompt:** 
```
How many 50m balls of yarn do I need for a project that requires 125m?
```

**Response:** 
```
You will need 3 balls of yarn.
```

**Prompt:** 
```
I have 2 balls of 100m yarn. Is that enough for a 250m project?
```

**Response:** 
```
No, your supply is insufficient. You need 1 more ball.
```

**Prompt:** 
```
What is the total cost if I need 5 balls of yarn and each ball costs $4.50?
```

**Response:** 
```
The total estimated cost is $22.50.
```

## Capabilities

### Purchase Planning
Your agent determines the exact number of whole units to buy.

### Inventory Auditing
The AI checks your current stock against project needs.

### Budgeting
Your agent calculates the total cost for new materials.

### Stock Summaries
The AI provides a total length of all available yarn in your inventory.

## Use Cases

### New Project Kickoff
Determine exactly how many balls of yarn to add to your shopping cart.

### Stash Management
Check if your existing yarn supply can cover a specific pattern requirement.

### Cost Estimation
Calculate the total material expense before committing to a new design.

### Inventory Tracking
Get a quick summary of your total available yarn length.

## Benefits

- Prevents mid-project shortages by rounding up to whole units.
- Reduces manual math errors in project budgeting.
- Connects your current inventory to your future project plans.

## How It Works

Connect the MCP to your AI client and start asking about your yarn needs.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Tell your agent how much yarn your pattern requires.
3. Ask the agent to check your current inventory or calculate costs.
4. Receive direct answers and purchase requirements from your agent.

## Frequently Asked Questions

**How does the calculator handle partial balls of yarn?**
The tool always rounds up to the nearest whole ball to ensure you have enough material to finish your project.

**Can I use this with my existing AI tools?**
Yes, this MCP works with any MCP-compatible client like Claude, Cursor, or Windsurf.

**Does this help with budgeting?**
Yes, you can use the cost estimation tool to find out how much a specific amount of yarn will cost you.

**How do I check if I have enough yarn in my stash?**
You can ask your agent to validate your supply sufficiency by comparing your current inventory to your project needs.

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

**How does the tool handle partial balls of yarn?**
The `get_required_balls` tool always rounds up to the next whole number, ensuring you have enough yarn to complete your project.

**Can I check if I have enough yarn in my current stash?**
Yes, you can use `validate_supply_sufficiency` to compare your current ball count against the total length required for a project.

**How is the project cost calculated?**
The `calculate_project_cost_estimate` tool calculates the total cost by multiplying the number of whole balls needed by the price per ball.