Skip to main content
Glama
SIA MCP Server

SIA MCP Server

sia-mcp-server

MCP server for the SAP Intelligent Agriculture (SIA) farming platform

Tools

Area Management

Tool

Description

sia_get_areas

List geographic areas (field/crop zone boundaries)

sia_create_area

Create a new area with GeoJSON boundary

sia_delete_area

Delete an area by ID

Farm & Field

Tool

Description

sia_get_farms

List farms

sia_get_fields

List fields

sia_create_field

Create a field linked to a farm and area

sia_get_field_characteristics

List field characteristic values

sia_create_field_characteristic

Attach a characteristic value to a field

Crop Zones

Tool

Description

sia_get_crop_zones

List crop zones

sia_create_crop_zone

Create a crop zone

sia_delete_crop_zone

Delete a crop zone

sia_get_crop_zone_kpis

Get KPIs for a crop zone

sia_create_crop_zone_kpi

Add a KPI to a crop zone

sia_get_crop_zone_characteristics

List crop zone characteristic values

sia_create_crop_zone_characteristic

Attach a characteristic value to a crop zone

Reference Data

Tool

Description

sia_get_perennials

List perennial plants

sia_create_perennial

Create a perennial plant record

sia_get_seasons

List agricultural seasons

sia_get_varieties

List crop varieties

sia_get_kpi_definitions

List available KPI definitions

sia_get_locations

List locations (e.g. assembly points)

sia_get_location_types

List location types

sia_create_location

Create a location

sia_delete_location

Delete a location

sia_get_characteristic_configurations

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 build

Running

stdio (default, for Claude Desktop / MCP clients):

node dist/index.js

HTTP server:

TRANSPORT=http node dist/index.js
# Server listens on http://localhost:3000/mcp

Claude 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:

  1. Create area for field boundary

  2. Create area for crop zone boundary

  3. Create field

  4. Set field characteristic (external plot ID)

  5. Create perennial plant

  6. Create crop zone

  7. Add total production KPI

  8. Add per-tree production KPI

  9. Set tree count characteristic

  10. Set productive tree count characteristic

This full workflow can be orchestrated by an LLM using this MCP server.

Available Tools

25 tools
sia_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 AreaA
DestructiveIdempotent

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 ZoneA
DestructiveIdempotent

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 LocationC
DestructiveIdempotent

Delete a location by ID from the SIA LocationService.

Args:

  • id (string): UUID of the location to delete

Inputs: id (required).

sia_get_areasGet AreasA
Read-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 ConfigurationsA
Read-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 ValuesA
Read-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 KPIsA
Read-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 ZonesA
Read-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 FarmsA
Read-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 ValuesA
Read-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 FieldsA
Read-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 DefinitionsA
Read-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 LocationsA
Read-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 TypesA
Read-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 PerennialsA
Read-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 SeasonsA
Read-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 VarietiesA
Read-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

    A3.7/5.0

    Scored across 25 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness2/5

    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

    Related MCP Servers