# Ceramic Firing Shelf Planner AI Agent Connect

> Ceramic Firing Shelf Planner MCP handles the math of kiln loading. It calculates how many pieces fit on a shelf, finds the best placement to save space, and checks that your vertical stacks won't collapse during a firing. Your AI client does the heavy lifting so you don't have to guess where things go.

## Overview
- **Category:** optimization
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3LH6CWuPtwmGDlvkApNL2VF72u69tQB8adVtb2OK/ai-agent-connect
- **Tags:** kiln, ceramics, layout, optimization, studio-management

## Description

Loading a kiln is a constant balancing act between maximizing space and preventing broken work. This MCP takes the guesswork out of the process. Instead of manually measuring every piece and shelf, you give your AI client the dimensions of your pieces and your kiln's constraints. It then calculates the most efficient way to pack the shelves while respecting required clearances. 

It doesn't just look at floor space. It accounts for stacking limits to keep your pieces safe. You can use it to figure out exactly how many items of a specific size will fit on a single shelf or to generate a full placement map for a complex load. If you're worried about a tall stack of pots, the MCP can verify if that stack meets your safety rules before you ever turn on the heat. It turns a tedious spatial puzzle into a quick conversation with your agent.

## Tools

### find_optimal_shelf
This tool identifies the best shelf for a specific piece to minimize wasted space. It picks the most efficient spot based on your current layout.

### plan_shelf_placement
This tool generates a detailed layout of where pieces should be placed on your available shelves. It provides specific coordinates for your load.

### validate_stack_integrity
This tool checks if a proposed stack of ceramic pieces is safe. It uses your height and stacking rules to prevent collapses during firing.

### calculate_shelf_capacity
This tool determines how many pieces of a specific type can fit on a single shelf. It factors in your specific constraints and clearances.

## Prompt Examples

**Prompt:** 
```
Can you create a placement plan for 5 pieces (10x10x5) on a shelf that is 50x50, with a 2cm clearance and a max stack height of 2?
```

**Response:** 
```
The pieces have been assigned to shelf ID 'shelf_01' at coordinates (x: 2, y: 2) and (x: 14, y: 2), with one stack of 2 pieces.
```

**Prompt:** 
```
How many 5x5cm pieces can fit on a 20x20cm shelf with 1cm clearance and a max stack height of 3?
```

**Response:** 
```
You can fit a total of 9 pieces on this shelf (3 stacks of 3 pieces each).
```

**Prompt:** 
```
Is a stack of three pieces with heights 5cm, 5cm, and 6cm safe if the max stack height is 3?
```

**Response:** 
```
Yes, the stack is safe because it contains 3 pieces, which does not exceed the maximum stack height of 3.
```

## Capabilities

### Space Optimization
Your agent finds the best shelf for each piece to reduce empty gaps.

### Capacity Calculation
The AI determines the maximum number of items that fit on a shelf given your specific dimensions.

### Stack Safety Verification
Your agent checks vertical stacks against your defined height limits to prevent accidents.

### Layout Generation
The MCP produces specific placement coordinates for every piece in your kiln load.

## Use Cases

### Production Runs
Calculate exactly how many identical mugs will fit in a single kiln load to plan your inventory.

### Complex Loading
Generate a full placement plan for a variety of differently sized pieces on multiple shelves.

### Safety Checks
Verify that a tall stack of heavy bowls won't exceed your maximum stacking height.

### Space Management
Find the best available shelf for a single large piece to minimize the footprint it takes up.

## Benefits

- Reduces wasted kiln space by finding the most efficient shelf placements.
- Prevents broken pieces by validating stack heights against safety rules.
- Saves time by automating the spatial math of kiln loading.
- Provides exact coordinates for piece placement to simplify the physical loading process.

## How It Works

Connect your AI client to Vinkius and start planning your kiln loads immediately.

1. Connect your preferred MCP-compatible client like Claude or Cursor to Vinkius.
2. Provide your piece dimensions and shelf constraints to your AI agent.
3. Ask the agent to calculate capacity or generate a placement plan.
4. Follow the coordinates or safety checks provided by the MCP to load your kiln.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect your client, such as Claude or Cursor, to the Vinkius platform. Once connected, your agent can immediately use the tools provided by this MCP.

**Can this MCP prevent my pieces from falling over?**
Yes. By using the validate_stack_integrity tool, your agent can check if your proposed stacks follow your specific height and stacking rules.

**Does this tool work for different kiln sizes?**
Yes. You provide the specific dimensions of your shelves and pieces, and the MCP performs the calculations based on those exact numbers.

**What kind of output do I get for a placement plan?**
The MCP provides specific coordinates and shelf assignments, telling you exactly where to place each piece.

**Can I use this to see how many items fit on a shelf?**
Yes. The calculate_shelf_capacity tool tells you the maximum number of pieces of a certain type that will fit given your constraints.

**How does the tool handle piece spacing?**
The tool uses the `clearance` parameter to ensure every piece has a mandatory buffer zone around its perimeter to prevent heat interference.

**Can I stack pieces vertically?**
Yes, stacking is supported as long as it does not exceed the `maxStackHeight` and passes the `validate_stack_integrity` check.

**What information do I need to provide?**
You need to provide the dimensions of your shelves, the dimensions of your ceramic pieces, the required clearance, and the maximum stacking height.
