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

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.