# Soil Amendment Purchase Planner AI Agent Connect

> Soil Amendment Purchase Planner MCP handles the math for your soil prep. It converts your plot size and density into total mass, subtracts what you already have in stock, and picks the best bag combinations to buy. It even checks if your order meets supplier delivery rules so you don't run into logistics issues at checkout.

## Overview
- **Category:** agriculture
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_w6B2pwhlwwOsRHWIOVivIbugpG2N2MBm5DrndML2/ai-agent-connect
- **Tags:** soil, amendment, mass-calculation, inventory, logistics

## Description

You can stop guessing how many bags of fertilizer or lime you need to order. This MCP handles the heavy lifting of agricultural logistics by turning spatial data into a concrete purchase plan. You provide the plot dimensions and the required application rate, and your AI client calculates the exact mass needed. 

If you already have supplies sitting in a shed, the MCP factors that in to ensure you don't overbuy. Once you know the net amount required, it looks at available commercial package sizes to find the most efficient combination of bags. It also validates your planned order against supplier constraints to make sure your delivery is actually eligible. It's a direct way to move from field measurements to a finalized order without manual math errors.

## Tools

### calculate_mass_requirement
Determines the total mass of amendment needed for a specific plot based on area and application rates.

### calculate_net_purchase_needs
Calculates the remaining amount you need to buy by subtracting your current inventory from the total requirement.

### optimize_package_selection
Finds the best combination of commercial bag sizes to meet your specific mass requirement.

### validate_delivery_eligibility
Checks if your planned purchase meets the specific logistical constraints set by your supplier.

## Prompt Examples

**Prompt:** 
```
I have a 500 square meter plot and need 0.5 kg of amendment per square meter. The bulk density is 1.2 kg/L. How much mass and volume do I need?
```

**Response:** 
```
You need a total mass of 250 kg, which corresponds to a volume of 208.33 liters.
```

**Prompt:** 
```
I need 100 kg of amendment. I already have 30 kg in my shed. How much more do I need to buy?
```

**Response:** 
```
You need to purchase an additional 70 kg of amendment.
```

**Prompt:** 
```
I need to buy 45 kg of amendment. Available bag sizes are 5kg, 10kg, and 25kg. What is the best package combination?
```

**Response:** 
```
The optimal selection is one 25kg bag and two 10kg bags, totaling 45kg using 3 packages.
```

## Capabilities

### Mass Calculation
The AI calculates total weight requirements based on plot size and density.

### Inventory Adjustment
The AI subtracts existing stock to find the true amount you need to purchase.

### Package Optimization
The AI selects the most efficient mix of bag sizes to fulfill an order.

### Logistics Validation
The AI checks if your order meets supplier delivery requirements.

## Use Cases

### Seasonal Soil Prep
Calculate exactly how much lime or compost to order for a large field before the season starts.

### Inventory Management
Determine if your current shed stock is enough to cover an upcoming application task.

### Supplier Order Planning
Find the best combination of bag sizes to minimize the number of packages handled.

### Logistics Verification
Confirm that a planned bulk order won't be rejected by a supplier's delivery constraints.

## Benefits

- Reduces math errors in material procurement.
- Prevents overbuying by accounting for existing inventory.
- Minimizes package waste through optimized bag selection.
- Ensures orders meet supplier delivery rules before you hit buy.

## How It Works

Connect the MCP to your AI client and start feeding it field data to get procurement plans.

1. Connect the MCP to Claude, Cursor, or Windsurf via Vinkius.
2. Provide your plot size, density, and application rates to the AI.
3. Input your current inventory levels to find the net purchase amount.
4. Ask the AI to pick the best bag sizes for your order.
5. Verify the order against supplier rules using the validation tool.

## Frequently Asked Questions

**How does this MCP help with soil ordering?**
It automates the math of converting plot area into weight, adjusting for what you already have, and picking the best bag sizes to buy.

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

**Does it account for the bags I already have in stock?**
Yes, the calculate_net_purchase_needs tool specifically subtracts your current inventory from the total mass required.

**Will it tell me which bag sizes to buy?**
Yes, the optimize_package_selection tool finds the most efficient combination of available commercial bag sizes.

**Can it check if my order can be delivered?**
Yes, the validate_delivery_eligibility tool checks your planned purchase against supplier logistical constraints.

**How does the tool calculate the total mass needed?**
The `calculate_mass_requirement` tool calculates mass by multiplying the plot area by the application rate, then derives volume using the provided bulk density.

**Can I account for the soil amendments I already have in stock?**
Yes, use `calculate_net_purchase_needs` to subtract your current stock mass from the total requirement to find the net amount to purchase.

**How does the system handle different bag sizes?**
The `optimize_package_selection` tool uses a greedy approach to select the combination of available package sizes that satisfies your needs using the fewest total packages.
