# Soil Correction Planner MCP MCP > Soil Correction Planner calculates a full 3-year soil amendment program. It generates precise annual dosage schedules for lime, gypsum, and micronutrients, taking your soil from acidic or nutrient-deficient status to optimal levels for specific crops. Plus, it forecasts the total cost of the entire investment. ## Overview - **Category:** agriculture - **Price:** Free - **Tags:** soil, lime, gypsum, micronutrients, agriculture-planning, crop-management ## Description Trying to bring poor soil up to grade is a huge headache. You need more than just a single number; you need a working plan that spans several years and accounts for budget. This MCP helps farmers create exactly that. It calculates precise annual dosages for major amendments like lime, gypsum, and micronutrients, ensuring the transition from acidic or nutrient-deficient soil to optimal growing conditions is managed step by step. You'll get structured schedules detailing what materials you need and when. The system also rolls up all those costs into one total program budget. If your current planning tools are just spreadsheets of numbers, this gives you a complete, actionable roadmap. Connect it through the Vinkius catalog to see how easy it is to run complex agricultural models without needing an agronomist with a Ph.D. ## Tools ### get_gypsum_sequence Calculates the specific doses of gypsum needed for soil improvement over three years. ### get_lime_sequence Determines the annual application dosages required for lime to adjust soil pH over a period of three years. ### get_micronutrient_sequence Identifies and calculates the specific yearly requirements for vital micronutrients based on target crops. ### calculate_total_program_cost Sums up all costs from lime, gypsum, and micronutrient applications to give a final program budget. ## Prompt Examples **Prompt:** ``` Calculate a lime sequence for pH 4.5, target saturation 70%, using No-Till. ``` **Response:** ``` The `get_lime_sequence` tool would provide a 3-year schedule of doses with a 'Surface' application method recommendation. ``` **Prompt:** ``` What are the micronutrient needs for Corn if Zinc is at 1.5? ``` **Response:** ``` Using `get_micronutrient_sequence`, the system will identify the deficit and provide annual dosage requirements for Zinc and other necessary elements. ``` **Prompt:** ``` Estimate total cost if lime is 50/kg, gypsum is 30/kg, and I have specific doses. ``` **Response:** ``` The `calculate_total_program_cost` tool will sum the costs of all lime, gypsum, and micronutrient applications over the 3-year period. ``` ## Capabilities ### Generate multi-year amendment schedules Calculate precise annual dosage requirements for lime, gypsum, and micronutrients over a three-year period. ### Model soil transition from deficiency to optimal Guide the process of moving poor or acidic soil into a state ready for target crop growth. ### Calculate total program investment cost Provide a single figure that sums up all material and amendment costs across the entire 3-year plan. ## Use Cases ### Addressing chronic soil acidity A farm manager knows their land is acidic but doesn't know how much lime to use year-over-year. They ask the MCP, and it runs `get_lime_sequence`, providing a precise 3-year application schedule with recommended methods. ### Planning for specialty crops An agronomist needs to prepare soil for high-value corn that requires specific zinc levels. They use `get_micronutrient_sequence` first, confirming the needed dosage before calculating the overall budget with `calculate_total_program_cost`. ### Budgeting a major turnaround project A consultant needs to pitch a full soil recovery plan to a client. They run all three sequences—`get_lime_sequence`, `get_gypsum_sequence`, and `get_micronutrient_sequence`—and then immediately use `calculate_total_program_cost` to show the total price point. ### Optimizing for best practice A farmer wants to know if they can combine amendments. The MCP runs all sequences, allowing them to see how lime and gypsum interact over three years while keeping a running tally of costs using `calculate_total_program_cost`. ## Benefits - Stop guessing on amendments. You get precise, year-by-year dosage schedules for lime and gypsum using `get_lime_sequence` and `get_gypsum_sequence`, eliminating guesswork. - Never forget the small stuff. The MCP calculates micronutrient needs with `get_micronutrient_sequence`, ensuring your crops get every element they need to thrive. - Stay in budget, even over three years. Running `calculate_total_program_cost` gives you a single, accurate investment figure before you buy a single bag of amendments. - The process is structured: You run the sequences first, then feed those results into the cost calculator. This keeps your planning linear and reliable. - It handles multiple variables at once. By linking all three amendment sequences together, your agent creates one cohesive plan, not just three separate reports. ## How It Works The bottom line is you get an actionable, budgeted roadmap that tells you exactly what materials to buy and when to apply them over several years. 1. Input your soil's current conditions, target crop, and desired improvement levels into the MCP. 2. The system runs specialized calculations to determine the necessary yearly doses for lime, gypsum, and micronutrients. 3. You get back a detailed 3-year schedule of amendments alongside a total cost estimate for the full program. ## Frequently Asked Questions **How do I use `get_lime_sequence`?** `get_lime_sequence` calculates the precise annual doses of lime needed to adjust your soil's pH and saturation levels over a 3-year period. **Do I need all four tools for one plan?** Yes, ideally. Using `get_lime_sequence`, `get_gypsum_sequence`, and `get_micronutrient_sequence` together provides the full picture; then you run `calculate_total_program_cost` to finalize the budget. **What is the purpose of `get_micronutrient_sequence`?** `get_micronutrient_sequence` focuses specifically on calculating necessary yearly dosages for vital, smaller elements that crops need to thrive. **Can I calculate costs without running all sequences first? Use `calculate_total_program_cost`.** No. The cost tool needs the dosage numbers from the other three sequence tools (`get_lime_sequence`, etc.) to figure out the total required material volume. **What happens if my initial soil reading for `get_lime_sequence` falls outside of a normal pH range?** The tool flags out-of-range inputs and refuses to generate the sequence. It requires you to manually adjust the starting data or provide supporting measurements to ensure an accurate plan. **If I run `get_gypsum_sequence` and it encounters a calculation error, how do I proceed?** The system provides a detailed error code explaining which input variable caused the failure. You correct that specific data point, then rerun only the problematic sequence to resolve the issue. **Can I adjust the planning length when using `calculate_total_program_cost`?** No. This tool is hardcoded to calculate costs for the complete 3-year soil amendment program, aligning with the fixed scope of all three primary sequence tools. **When using `get_micronutrient_sequence`, can I include multiple elements in one request?** Yes. You list all desired micronutrients; the system calculates individual annual dosage requirements and provides recommendations for appropriate application timing.