SIA MCP Server
Provides tools for managing farms, fields, crop zones, and reference data in the SAP Intelligent Agriculture platform, including area management, field characteristics, crop zone KPIs, and reference data like perennials and seasons.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SIA MCP Server list all farms"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sia-mcp-server
MCP server for the SAP Intelligent Agriculture (SIA) farming platform
Tools
Area Management
Tool | Description |
| List geographic areas (field/crop zone boundaries) |
| Create a new area with GeoJSON boundary |
| Delete an area by ID |
Farm & Field
Tool | Description |
| List farms |
| List fields |
| Create a field linked to a farm and area |
| List field characteristic values |
| Attach a characteristic value to a field |
Crop Zones
Tool | Description |
| List crop zones |
| Create a crop zone |
| Delete a crop zone |
| Get KPIs for a crop zone |
| Add a KPI to a crop zone |
| List crop zone characteristic values |
| Attach a characteristic value to a crop zone |
Reference Data
Tool | Description |
| List perennial plants |
| Create a perennial plant record |
| List agricultural seasons |
| List crop varieties |
| List available KPI definitions |
| List locations (e.g. assembly points) |
| List location types |
| Create a location |
| Delete a location |
| List characteristic configurations |
Related MCP server: SAP S/4HANA MCP Server
Setup
npm install
cp .env.example .env
# Fill in your credentials in .env
npm run buildRunning
stdio (default, for Claude Desktop / MCP clients):
node dist/index.jsHTTP server:
TRANSPORT=http node dist/index.js
# Server listens on http://localhost:3000/mcpClaude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"SIA Connector": {
"command": "node",
"args": ["/absolute/path/to/sia-mcp-server/dist/index.js"],
"env": {
"SIA_BASE_URL": "https://jupiter-farming.cfapps.eu10.hana.ondemand.com",
"SIA_TOKEN_URL": "https://farmers-app-rcbhth9g.authentication.eu10.hana.ondemand.com/oauth/token",
"SIA_CLIENT_ID": "your_client_id",
"SIA_CLIENT_SECRET": "your_client_secret"
}
}
}
}Demo Sequence
The Bruno collection includes a 10-step demo that creates a complete field record:
Create area for field boundary
Create area for crop zone boundary
Create field
Set field characteristic (external plot ID)
Create perennial plant
Create crop zone
Add total production KPI
Add per-tree production KPI
Set tree count characteristic
Set productive tree count characteristic
This full workflow can be orchestrated by an LLM using this MCP server.
Available Tools
25 toolssia_create_areaCreate AreaA
Create a new geographic area in the SIA AreaService.
Areas define the boundary polygon for a field or crop zone. Returns the created Area ID.
Args:
name (string): Display name of the area
validFrom (string): ISO datetime from which the area is valid, e.g. "2026-01-01T00:00:00.000Z"
validTo (string, optional): ISO datetime until which the area is valid; omit for indefinite
areaType_ID (string): UUID of the area type
boundary_geojson (string): GeoJSON string defining the area polygon
isAutomaticallyCalculated (boolean): Whether area size is auto-calculated from geometry
areaSize (number, optional): Manual area size in hectares (used when isAutomaticallyCalculated=false)
isBlocked (boolean, optional): Whether the area is blocked (default: false)
Returns: Created Area object with ID
Inputs: name (required), validFrom (required), areaType_ID (required), boundary_geojson (required), +4 more.
sia_create_crop_zoneCreate Crop ZoneA
Create a new crop zone in the SIA CropZoneService.
A crop zone links a field, area, crop, variety, and season together.
Args:
name (string): Display name
field_ID (string): UUID of the parent field
area_ID (string): UUID of the crop zone's area
crop_ID (string): UUID of the crop type
variety_ID (string): UUID of the crop variety
season_ID (string): UUID of the agricultural season
isFallow (boolean): Whether the zone is left fallow (default: false)
isClosed (boolean): Whether the zone is closed (default: false)
perennial_ID (string, optional): UUID of associated perennial
cropPurpose_ID (string, optional): UUID of crop purpose
productionType_ID (string, optional): UUID of production type
description (string, optional): Free-text notes
Returns: Created CropZone object with ID
Inputs: name (required), area_ID (required), crop_ID (required), field_ID (required), +8 more.
sia_create_crop_zone_characteristicCreate Crop Zone Characteristic ValueA
Attach a characteristic value to a crop zone (e.g. number of trees, number of productive trees).
Args:
configuration_ID (string): UUID of the characteristic configuration
cropZone_ID (string): UUID of the target crop zone
numberValue (number, optional): Numeric value
textValue (string, optional): Text value
Returns: Created CropZoneCharacteristicValue with ID
Inputs: no named parameters.
sia_create_crop_zone_kpiCreate Crop Zone KPIA
Add a KPI value to a crop zone (e.g. total production estimate, per-tree production).
Args:
cropZone_ID (string): UUID of the crop zone to add the KPI to
kpiDefinition_ID (string): UUID of the KPI definition (what metric this measures)
entityType (string): Entity type, typically "CROP_ZONE"
estimatedValue (number): The numeric KPI value
Returns: Created KPI object
Inputs: cropZone_ID (required), estimatedValue (required), kpiDefinition_ID (required), entityType.
sia_create_fieldCreate FieldA
Create a new field in the SIA FarmAndFieldService.
A field belongs to a farm and is associated with a geographic area.
Args:
name (string): Field display name
farm_ID (string): UUID of the parent farm
area_ID (string): UUID of the area (geographic boundary) — create with sia_create_area first
description (string, optional): Additional notes about the field
Returns: Created Field object with ID
Inputs: name (required), area_ID (required), farm_ID (required), description.
sia_create_field_characteristicCreate Field Characteristic ValueA
Attach a characteristic value to a field (e.g. set an external plot ID or custom attribute).
Args:
configuration_ID (string): UUID of the characteristic configuration (defines what attribute this is)
field_ID (string): UUID of the target field
textValue (string, optional): Text value for text-type characteristics
numberValue (number, optional): Numeric value for number-type characteristics
Returns: Created FieldCharacteristicValue with ID
Inputs: no named parameters.
sia_create_locationCreate LocationA
Create a new location (e.g. assembly point) in the SIA LocationService.
Args:
name (string): Display name
description (string, optional): Notes
locationType_ID (string): UUID of the location type
geolocation_geojson (string): GeoJSON Point string, e.g. '{"type":"Point","coordinates":[lng, lat]}'
Returns: Created Location object with ID
Inputs: name (required), locationType_ID (required), geolocation_geojson (required), description.
sia_create_perennialCreate PerennialA
Create a perennial plant record in the SIA PerennialsService.
Args:
name (string): Display name
description (string, optional): Notes
field_ID (string): UUID of the parent field
area_ID (string): UUID of the area
plantingDate (string): ISO date, e.g. "2026-01-02"
crop_ID (string): UUID of the crop type
variety_ID (string): UUID of the crop variety
Returns: Created Perennial object with ID
Inputs: name (required), area_ID (required), crop_ID (required), field_ID (required), +3 more.
sia_delete_areaDelete AreaADestructiveIdempotent
Delete an area by its ID from the SIA AreaService.
WARNING: This is a destructive operation. Ensure the area is not referenced by active fields or crop zones before deleting.
Args:
id (string): UUID of the area to delete
Returns: Confirmation message on success
Inputs: id (required).
sia_delete_crop_zoneDelete Crop ZoneADestructiveIdempotent
Delete a crop zone by ID from the SIA CropZoneService.
WARNING: Destructive operation. Ensure all KPIs and characteristics are removed first.
Args:
id (string): UUID of the crop zone to delete
Returns: Confirmation message
Inputs: id (required).
sia_delete_locationDelete LocationCDestructiveIdempotent
Delete a location by ID from the SIA LocationService.
Args:
id (string): UUID of the location to delete
Inputs: id (required).
sia_get_areasGet AreasARead-onlyIdempotent
List all agricultural areas from the SIA AreaService.
Areas represent geographic boundaries (polygons) for fields and crop zones. Returns area ID, name, validity period, area type, blocked status, geojson boundary, and size.
Args:
filter (string, optional): OData $filter expression, e.g. "name eq 'My Field Area'"
top (number, optional): Maximum number of results (default: 100)
Returns: Array of Area objects with fields: ID, name, validFrom, validTo, isBlocked, areaType_ID, boundary_geojson, isAutomaticallyCalculated, areaSize
Inputs: top, filter.
sia_get_characteristic_configurationsGet Characteristic ConfigurationsARead-onlyIdempotent
List characteristic configurations from the SIA CharacteristicService.
Characteristic configurations define what custom attributes can be set on fields and crop zones. Use configuration_ID values when creating field or crop zone characteristic values.
Returns: Array of CharacteristicConfiguration objects with ID, name, dataType
Inputs: top.
sia_get_crop_zone_characteristicsGet Crop Zone Characteristic ValuesARead-onlyIdempotent
List characteristic values attached to crop zones (e.g. tree counts, custom attributes).
Args:
filter (string, optional): OData $filter, e.g. "cropZone_ID eq ''"
top (number, optional): Max results (default: 100)
Returns: Array of CropZoneCharacteristicValue objects
Inputs: top, filter.
sia_get_crop_zone_kpisGet Crop Zone KPIsARead-onlyIdempotent
Get KPI values for a specific crop zone.
Returns estimated production values and other KPIs linked to this crop zone.
Args:
cropZone_ID (string): UUID of the crop zone
Returns: Array of KPI objects with kpiDefinition_ID, entityType, and estimatedValue
Inputs: cropZone_ID (required).
sia_get_crop_zonesGet Crop ZonesARead-onlyIdempotent
List crop zones from the SIA CropZoneService.
A crop zone represents a portion of a field planted with a specific crop variety in a season.
Args:
filter (string, optional): OData $filter, e.g. "field_ID eq ''"
top (number, optional): Max results (default: 100)
Returns: Array of CropZone objects with ID, name, isFallow, isClosed, field_ID, area_ID, crop_ID, variety_ID, season_ID
Inputs: top, filter.
sia_get_farmsGet FarmsARead-onlyIdempotent
List all farms from the SIA FarmAndFieldService.
Returns farm ID, name, description and metadata.
Args:
filter (string, optional): OData $filter expression, e.g. "createdBy eq 'user@example.com'"
top (number, optional): Max results (default: 100)
Returns: Array of Farm objects
Inputs: top, filter.
sia_get_field_characteristicsGet Field Characteristic ValuesARead-onlyIdempotent
List characteristic values attached to fields (e.g. external plot IDs, custom attributes).
Optionally expands the configuration to include characteristic metadata.
Args:
filter (string, optional): OData $filter, e.g. "field_ID eq ''"
expand_configuration (boolean, optional): Include configuration metadata (default: true)
top (number, optional): Max results (default: 100)
Returns: Array of FieldCharacteristicValue objects
Inputs: top, filter, expand_configuration.
sia_get_fieldsGet FieldsARead-onlyIdempotent
List all fields from the SIA FarmAndFieldService.
Returns field ID, name, description, farm_ID, and area_ID.
Args:
filter (string, optional): OData $filter expression, e.g. "farm_ID eq ''"
top (number, optional): Max results (default: 100)
Returns: Array of Field objects
Inputs: top, filter.
sia_get_kpi_definitionsGet KPI DefinitionsARead-onlyIdempotent
List KPI definitions from the SIA KPIService.
KPI definitions describe what metrics can be tracked (e.g. total production, per-tree production). Use kpiDefinition_ID values when creating crop zone KPIs.
Returns: Array of KPIDefinition objects with ID, name, description, unit
Inputs: top.
sia_get_locationsGet LocationsARead-onlyIdempotent
List locations from the SIA LocationService (e.g. assembly points, storage facilities).
Args:
filter (string, optional): OData $filter
top (number, optional): Max results (default: 100)
Returns: Array of Location objects with ID, name, description, locationType_ID, geolocation_geojson
Inputs: top, filter.
sia_get_location_typesGet Location TypesARead-onlyIdempotent
List location types from the SIA LocationService.
Use locationType_ID values when creating locations.
Returns: Array of LocationType objects with ID and name
Inputs: no named parameters.
sia_get_perennialsGet PerennialsARead-onlyIdempotent
List perennial plants from the SIA PerennialsService.
Perennials represent long-lived plants (e.g. fruit trees, coffee bushes) linked to fields.
Args:
filter (string, optional): OData $filter, e.g. "field_ID eq ''"
top (number, optional): Max results (default: 100)
Returns: Array of Perennial objects with ID, name, field_ID, area_ID, plantingDate, crop_ID, variety_ID
Inputs: top, filter.
sia_get_seasonsGet SeasonsARead-onlyIdempotent
List agricultural seasons from the SIA SeasonService.
Seasons define time periods for crop planning. Use season IDs when creating crop zones.
Args:
top (number, optional): Max results (default: 50)
Returns: Array of Season objects with ID, name, startDate, endDate
Inputs: top.
sia_get_varietiesGet Crop VarietiesARead-onlyIdempotent
List crop varieties from the SIA CropAndVarietyService.
Use variety IDs when creating crop zones and perennials.
Args:
filter (string, optional): OData $filter, e.g. "crop_ID eq ''"
top (number, optional): Max results (default: 100)
Returns: Array of Variety objects with ID, name, crop_ID
Inputs: top, filter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Each tool targets a unique combination of entity and action (create, get, delete). There is no overlap; even the lookup tools (e.g., sia_get_seasons, sia_get_varieties) are for distinct reference data.
All tools follow the consistent pattern 'sia_<verb>_<entity>' with snake_case. Verbs are consistently 'create', 'get', or 'delete', and the entity names are in lowercase. The pattern is uniform across all 25 tools.
25 tools cover a broad agricultural domain including areas, fields, crop zones, perennials, locations, characteristics, KPIs, and reference data. While slightly above typical range, each tool serves a clear purpose and the count is justified for the scope.
Most entities lack update operations (e.g., fields, perennials, characteristics, KPIs) and some lack delete operations (e.g., fields, perennials). This creates dead ends for agents needing to modify or remove data, limiting workflow completion.
Related MCP Connectors
Interact with your Google Cloud Firestore resources using natural language commands.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Manage projects, tasks, time tracking, and team collaboration through natural language.
List datasets, schemas, run APL queries, and use prompts for exploration, anomalies, and monitoring.
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceEnables AI assistants to analyze farm locations, retrieve soil and weather data, access commodity market prices, and chat with an agricultural advisor for farming recommendations.MIT- FlicenseAqualityDmaintenanceEnables interaction with SAP S/4HANA systems via OData, allowing service discovery, metadata exploration, field value retrieval, and CRUD operations through natural language.45-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with SAP Business One via Service Layer REST API to retrieve and create business data such as partners, orders, invoices, items, and stock levels through natural language.1-
- FlicenseBqualityCmaintenanceEnables managing SAP Cloud Integration iFlows, packages, configurations, deployments, and runtime artifacts via natural language through the OData API.25-