# Ambee Soil MCP

> Ambee Soil connects your AI agent to global soil data. Get real-time moisture and temperature readings, analyze historical trends over years, assess specific soil chemistry like pH and carbon content, or generate structured grids for GIS mapping. It gives you the full environmental picture required for precise farming decisions.

## Overview
- **Category:** the-unthinkable
- **Price:** Free
- **Tags:** soil-moisture, environmental-data, precision-agriculture, satellite-data, sensor-fusion, climate-monitoring

## Description

Managing crop health shouldn't require a field scientist on retainer. This MCP lets your AI client act as an agronomist, running complex analyses on soil conditions from anywhere. You stop guessing about what’s happening underground and start acting on data. Need to know if the current moisture level is adequate for corn at your coordinates? Done. Want to compare this year's temperature patterns against historical averages for drought planning? Done. The system handles retrieving immediate readings, analyzing long-term trends, or even checking soil composition down to the mineral level using a simple conversation. Because Vinkius hosts this MCP, you connect once and get access to detailed spatial data that lets your agent run advanced assessments—whether it's generating structured grids for mapping or figuring out if your soil is good for vineyards versus cornfields.

## Tools

### get_grid_soil
Generates structured data points necessary for mapping soil conditions across an entire field area.

### get_historical_soil
Retrieves time-series data to analyze seasonal patterns and long-term moisture or temperature shifts.

### get_latest_soil
Provides immediate, up-to-date soil moisture and temperature readings for a specific point.

### get_soil_by_radius
Gathers soil condition data from multiple points spread across an entire field area.

### get_soil_properties
Retrieves comprehensive chemical and physical metrics, including pH and organic carbon percentage.

## Prompt Examples

**Prompt:** 
```
What is the current soil moisture and temperature at my farm in Iowa (41.8780, -93.0977)?
```

**Response:** 
```
Fetching real-time soil data for Iowa coordinates... Current conditions: Soil Moisture is 32.4% (moderate, adequate for corn growth stage). Soil Temperature is 18.2°C (64.8°F), ideal for nutrient uptake. Data timestamp: 2026-04-07 14:00 UTC. Based on these readings, irrigation is not immediately required but should be monitored over the next 48 hours. Would you like historical trends for the past 30 days to see moisture patterns?
```

**Prompt:** 
```
Show me soil moisture trends over the last 60 days for my location.
```

**Response:** 
```
Analyzing 60-day soil moisture history... Day 1-15: Average 38% (post-rainfall recovery). Day 16-30: Dropped to 28% (dry spell). Day 31-45: Rebounded to 35% (irrigation applied). Day 46-60: Currently stabilizing at 32%. Overall trend shows a gradual drying pattern with one successful irrigation intervention. Soil moisture is currently in the moderate range. Recommended action: Schedule irrigation within 5-7 days if no rainfall is forecasted. Would you like a comparison with historical averages for this time of year?
```

**Prompt:** 
```
What are the soil properties at my vineyard location? I need to know the pH and organic carbon.
```

**Response:** 
```
Retrieving soil properties for your vineyard... Soil Composition: Sandy Loam (Sand: 62%, Silt: 24%, Clay: 14%). pH Level: 6.4 (slightly acidic, optimal for grape cultivation). Organic Carbon: 1.8% (good fertility level). Bulk Density: 1.42 g/cm3. Cation Exchange Capacity: 14.2 cmol/kg. Water Holding Capacity: 18%. Assessment: Your soil is well-suited for viticulture with good drainage and adequate nutrient retention. The slightly acidic pH is ideal for most grape varietals. Consider adding organic matter to boost carbon content above 2%. Would you like crop suitability recommendations based on these soil properties?
```

## Capabilities

### Determine current soil conditions
Get immediate readings of moisture and temperature for a single location.

### Analyze long-term environmental trends
Track changes in soil moisture or temperature across months or years.

### Map large areas of land
Generate structured, gridded data points for GIS mapping and variable rate application planning.

### Assess regional variability
Check soil conditions across multiple distinct points within a specified radius.

### Classify soil chemistry
Retrieve detailed chemical and physical properties, including pH and organic carbon content.

## Use Cases

### Checking Field Variability
A farmer needs to know if the north end of their field drains better than the south. They prompt the agent to gather data across multiple points, using `get_soil_by_radius` to compare soil conditions in both zones and adjust fertilizer application accordingly.

### Planning for Drought
An agronomist suspects a pattern of declining moisture over the last year. They use `get_historical_soil` to visualize trends, identifying when the soil dropped below safe levels so they can advise on preventative measures next season.

### Soil Suitability Test
A consultant needs to determine if a new plot of land is suitable for grapes. They use `get_soil_properties` to check the pH and organic carbon, determining that manual testing isn't necessary.

### Emergency Irrigation Check
The farmer gets an alert about possible heat waves. They immediately ask for current readings using `get_latest_soil` to verify if urgent action is needed before the weather changes.

## Benefits

- Instant Field Assessment: Use `get_latest_soil` to get current moisture and temperature data, letting you make immediate decisions about irrigation needs without delay.
- Long-Term Planning: Running a query via `get_historical_soil` lets you see patterns over years—identifying seasonal dry spells or long-term recovery rates for better planning.
- Site Mapping: The `get_grid_soil` tool structures data into gridded formats, which is essential if you need to plug the soil conditions directly into a GIS mapping system.
- Wide Area Coverage: If your field has variability, use `get_soil_by_radius`. This pulls readings from many points, giving you an accurate picture of how soil changes across acres.
- Chemistry Check: The `get_soil_properties` tool lets you skip the lab work. You can instantly check crucial metrics like pH or organic carbon content to know if your ground is ready for a specific crop.

## How It Works

The bottom line is, you talk to your AI client like you're talking to a human expert, and it uses this MCP to pull the necessary environmental data automatically.

1. Subscribe to the Ambee Soil MCP and input your API key into your AI client.
2. Directly prompt your agent with a specific agricultural question (e.g., 'What was the soil temperature last month?').
3. The MCP returns structured data points that your agent interprets, providing an actionable summary based on field conditions.

## Frequently Asked Questions

**How do I get real-time soil data using the get_latest_soil tool?**
You ask for current readings and provide a specific location. This tool gives you immediate moisture and temperature at that single point, perfect for quick irrigation checks.

**Can I see how my soil has changed over the year using get_historical_soil?**
Yes, this tool tracks seasonal changes in soil moisture and temperature. You can analyze patterns to predict dry spells or recovery periods for long-term planning.

**What is the difference between `get_soil_by_radius` and `get_grid_soil`?**
`get_soil_by_radius` collects data from multiple scattered points across a zone. `get_grid_soil` provides structured, gridded data optimized for GIS mapping programs.

**Does get_soil_properties give me chemical composition?**
Yes, this tool retrieves physical and chemical metrics like pH level and organic carbon content. It tells you the quality of the dirt itself.

**How do I authenticate my application when using get_latest_soil?**
You must include your Ambee API key in the MCP connection header. Once authenticated, your AI client gains full access to all five soil analysis tools immediately.

**Are there rate limits if I use get_grid_soil multiple times?**
Yes, usage quotas apply based on your subscription tier. If you exceed the limit, the tool returns a specific error code telling you when to try again or where to upgrade.

**What format does get_soil_properties return for analysis?**
It outputs structured JSON data that contains all physical and chemical metrics. This clean format lets your agent easily parse the results for calculations or reports.

**Can I analyze soil density using get_soil_properties?**
Yes, the tool provides Bulk Density in g/cm³. Knowing this measurement is key because it tells you exactly how much space solid material occupies in your field.

**Can my AI check real-time soil moisture and temperature for my farm location?**
Yes! Use the `get_latest_soil` tool with your farm latitude and longitude coordinates. The API returns current soil moisture percentage and soil temperature in Celsius. This data is updated in near real-time using satellite and sensor fusion models, making it perfect for daily irrigation decisions and crop health monitoring.

**How do I get historical soil moisture trends to analyze drought patterns?**
Use the `get_historical_soil` tool with your coordinates and the number of days you want to analyze (e.g., 30, 60, or 90 days). This returns daily soil moisture and temperature readings that you can use to identify drying trends, assess drought severity, and plan irrigation schedules based on historical patterns.

**What soil properties are available and how can they help with crop planning?**
Use the `get_soil_properties` tool to access detailed soil composition data including sand/silt/clay percentages, organic carbon content, bulk density, pH, and cation exchange capacity (CEC). These properties help determine soil texture classification, drainage capacity, nutrient retention, and optimal crop selection for your land.