# Darkroom Chemical Mixing Plan AI Agent Connect

> Darkroom Chemical Mixing Plan MCP handles the math for your analog workflows. It calculates the exact amounts of water and concentrate you need based on your tray setup, dilution ratios, and desired waste margins. Instead of manual calculations, your AI client generates complete mixing plans for entire sessions or single batches in seconds.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_SwoZi8sbIVSfA3zJsoXEsBcJ29lxLSNHL6lPBAVi/ai-agent-connect
- **Tags:** darkroom, analog, chemical, photography, precision

## Description

Stop guessing your dilution ratios or over-mixing chemicals. This MCP handles the precise math required to prepare working solutions for analog film processing. You provide the number of trays, the volume per tray, and your preferred waste margin, and your agent does the rest. It works by calculating the total volume needed and then breaking that down into specific concentrate and water measurements for every chemical in your session.

You can use it to plan a full workflow from developer to fixer or just check the math for a single batch of developer. It even checks your chemical catalog to ensure you're working with valid stock. By offloading these calculations to your AI client, you keep your hands clean and your chemistry consistent.

## Tools

### calculate_tray_requirements
This tool determines the minimum total volume you need based on your physical darkroom setup.

### generate_full_mixing_plan
This tool acts as an orchestrator to calculate every component needed for a complete darkroom session.

### validate_chemical_stock
This tool checks if a specific chemical you want to use is available in your predefined catalog.

### calculate_single_mix_batch
This tool calculates the exact volumes of water and concentrate required for one specific chemical type.

## Prompt Examples

**Prompt:** 
```
I need to fill 3 trays with 500ml each, with a 10% waste margin. I need Developer (1:10) and Stop Bath (1:5).
```

**Response:** 
```
For 3 trays at 500ml each with 10% waste, the total session volume is 1650ml. Your plan is: Developer: 165ml concentrate and 1485ml water; Stop Bath: 330ml concentrate and 1320ml water.
```

**Prompt:** 
```
How much water and concentrate do I need for 1 liter of a 1:9 Developer solution?
```

**Response:** 
```
For 1 liter of a 1:9 Developer solution, you need 100ml of concentrate and 900ml of water.
```

**Prompt:** 
```
Check if 'Fixer' is a valid chemical in the catalog.
```

**Response:** 
```
Yes, 'Fixer' is a valid chemical in the authorized catalog.
```

## Capabilities

### Session Planning
Your agent calculates all necessary chemical volumes for a full darkroom workflow.

### Volume Calculation
The AI determines exact water and concentrate amounts for specific dilution ratios.

### Waste Margin Management
Your agent adds a percentage buffer to your total volume to prevent running dry.

### Inventory Verification
The AI checks your requested chemicals against a predefined catalog.

### Tray Requirement Logic
Your agent calculates total volume based on your physical tray count and size.

## Use Cases

### Full Session Setup
Plan every chemical needed for a film processing run, including developer, stop bath, and fixer.

### Single Batch Mixing
Get the exact water and concentrate amounts for one specific chemical type.

### Waste Buffer Calculation
Add a 10% or 15% margin to your tray volumes so you don't run out mid-process.

### Catalog Verification
Confirm that the chemicals you have on hand match your intended workflow.

## Benefits

- Reduces manual math errors during chemical preparation.
- Prevents chemical waste by calculating exact volumes needed.
- Speeds up session setup by generating full plans at once.
- Ensures consistency by using precise dilution ratios.

## How It Works

Connect the MCP to your client and start asking for chemical math.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Tell your agent your tray count, volume per tray, and desired chemicals.
3. The agent uses the tools to calculate volumes and check the catalog.
4. Receive a precise list of concentrate and water amounts for your mix.

## Frequently Asked Questions

**How do I use this MCP with my AI client?**
You connect to the Vinkius-hosted MCP once, and it becomes available in any compatible client like Claude or Cursor.

**Can I include a waste margin in my calculations?**
Yes, you can specify a waste margin in your prompt, and the agent will include it in the total volume calculation.

**Does it work for any chemical?**
The agent can calculate any ratio you provide, but it can also verify if a chemical exists in your specific catalog.

**What kind of math does it perform?**
It calculates the total volume, the amount of concentrate, and the amount of water needed based on your dilution ratios.

**Do I need to host this myself?**
No, Vinkius hosts and manages the MCP for you. You just connect and use it.

**How do I calculate the total volume needed for my session?**
You can use the `calculate_tray_requirements` tool to determine the total volume based on your tray count and the volume required per tray, including a safety waste margin.

**Can I plan a whole session at once?**
Yes, the `generate_full_mixing_plan` tool allows you to input your tray requirements and a list of chemical requests to get a complete mixing plan for the entire session.

**How does the waste allowance work?**
The waste allowance is a percentage added to your total volume to account for spills or residue, ensuring you have enough solution to complete your work.