# OneSoil MCP

> OneSoil manages farm data and field boundaries through your AI agent. It pulls together hyper-local weather forecasts, historical NDVI vegetation indices, and current satellite imagery for any specific plot of land. You can plan scouting trips or check crop health status without leaving your chat window.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** precision-farming, ndvi, satellite-imagery, agtech, weather-data

## Description

This MCP lets you manage complex agricultural operations using natural conversation instead of jumping between dozen different software dashboards. Need to know if the cornfield needs water? Ask your agent directly. It handles fetching current weather, running a 7-day forecast for precise coordinates, and pulling historical NDVI data—all in one go.

It’s about getting actionable insights on crop health and resource management without ever switching apps. You can list all existing fields or create brand new boundaries using GeoJSON geometries. This MCP lives in the Vinkius catalog, making it easy for any compatible client to access this deep dataset. If you're working with large-scale farming data, this is your single source of truth.

## Tools

### create_field
Defines and adds a new field boundary to your account.

### get_current_weather
Retrieves the immediate weather conditions for specific coordinates.

### get_weather_history
Pulls detailed historical weather data using specified field coordinates.

### delete_field
Removes an existing field boundary from your record.

### get_field
Retrieves all core metadata and details for a single, specified field.

### list_images
Shows what Sentinel-2 satellite imagery is available for a given field.

### get_ndvi
Gathers historical NDVI values to chart the vegetation health of a specific area over time.

### list_fields
Provides a complete list of all field boundaries registered in your account.

### get_weather_forecast
Predicts the weather conditions for the next seven days at specified coordinates.

## Prompt Examples

**Prompt:** 
```
List all my fields in OneSoil.
```

**Response:** 
```
I've retrieved your fields. You have 3 active boundaries: 'North Corn' (ID: 123), 'South Soy' (ID: 456), and 'East Wheat' (ID: 789). Which one would you like to inspect?
```

**Prompt:** 
```
Get the NDVI history for field 123.
```

**Response:** 
```
Retrieving NDVI data for field 123... I found 10 historical data points. The vegetation index peaked at 0.82 in mid-July, indicating healthy growth during that period.
```

**Prompt:** 
```
What is the 7-day weather forecast for lat 53.9, lon 27.5?
```

**Response:** 
```
Fetching the forecast for those coordinates... Expect clear skies for the next 3 days with temperatures between 18°C and 24°C, followed by light rain on Thursday.
```

## Capabilities

### List and manage fields
You can list all existing field boundaries or define new ones within your account.

### Monitor crop health
The tool retrieves historical Normalized Difference Vegetation Index (NDVI) scores to track plant growth over time.

### Check hyper-local weather
It provides current conditions, 7-day forecasts, and historical records based on specific latitude and longitude coordinates.

### Review satellite data
The agent lists available Sentinel-2 imagery for a field so you can plan analysis or scouting trips.

## Use Cases

### Diagnosing a crop problem
A farmer notices yellowing in one corner of the field. They ask their agent to run `get_ndvi` for that area, compare it to the historical data, and then pull the surrounding week's weather using `get_weather_history`. The agent flags a drop in NDVI coinciding with low rainfall.

### Planning next season's boundaries
A farm manager needs to map out new plots. They first run `list_fields` to see what exists, and then use the `create_field` tool to draw a new boundary using GeoJSON coordinates for a fallow area.

### Preparing for equipment rental
A developer needs to know if they can plan spraying operations. They ask the agent to check both `list_images` and `get_field` details, ensuring the plot is correctly defined and that recent high-resolution imagery is available.

### Checking for immediate risks
A technician arrives on site. They don't want to wait for a physical report; they ask for `get_current_weather` based on the GPS coordinates, getting instant information about wind speed or rain likelihood.

## Benefits

- Stop juggling separate weather services, satellite platforms, and GIS software. This MCP pulls all environmental data into one conversation, giving you a single view of your farm's status.
- Get deep insights into plant growth using the `get_ndvi` tool. Instead of sifting through raw graphs, ask for historical trends and get an immediate assessment of vegetation health.
- Plan fieldwork efficiently by listing available satellite images with `list_images`. You know exactly what data you have before you even step out in the truck.
- Avoid guessing about conditions. Use `get_weather_forecast` or `get_current_weather` to get precise, hyper-local reports based on your field coordinates, not general regional forecasts.
- Manage your assets cleanly by using `list_fields` and `create_field`. You can keep an accurate, conversational record of every boundary change without updating complex databases.

## How It Works

The bottom line is you talk to your AI client using simple language instead of writing complex API calls or navigating menus.

1. First, subscribe to the MCP and enter your OneSoil API Key into your AI client.
2. Next, ask your agent for specific data points, like 'What is the NDVI history for field ID 123?' or 'Give me the weather forecast for coordinates X, Y.'
3. Finally, your agent processes the request against the OneSoil data and delivers a summary of findings right in your chat.

## Frequently Asked Questions

**How do I check my field boundaries with OneSoil MCP?**
You can list all your existing fields using `list_fields` to see a summary, or use `get_field` if you know the specific ID. If you need to add one, use `create_field`.

**What does NDVI measure in OneSoil MCP?**
NDVI measures vegetation health. By calling `get_ndvi`, your agent retrieves historical scores that show how well the plants are growing over time relative to their environment.

**Can I get weather data for a specific plot of land using OneSoil MCP?**
Yes, you can. You must provide coordinates and specify if you need current conditions (`get_current_weather`), a 7-day outlook (`get_weather_forecast`), or past records (`get_weather_history`).

**Is OneSoil MCP better than using standalone mapping services?**
It's better because it integrates everything. Instead of opening a map service, then another weather API, this MCP combines both into one chat conversation.

**What if I need to check satellite images for multiple fields?**
You first use `list_fields` to get the list, and then run `list_images` on each field ID. This keeps your analysis organized and efficient.