MCP Tools

Use this page to understand what the remote Leaf MCP server exposes after you connect a client to https://mcp.withleaf.io/mcp. It is a tool reference, not a REST API reference, and it groups the available capabilities by product area.

Overview

The Leaf MCP (Model Context Protocol) server exposes tools that AI assistants can call to interact with the Leaf API programmatically. Instead of making REST calls directly, your MCP-compatible client (such as Cursor, Claude Desktop, or a custom agent) invokes typed tools and receives structured responses.

The MCP server is a tool server, not a REST API. There is no base URL — you configure the server in your MCP client, and it handles communication with the Leaf API on your behalf.

Configuration

To use the Leaf MCP server, point your MCP client at the remote Leaf server and pass your Leaf API token as a LEAF_TOKEN header. The server authenticates every tool call against the Leaf API using this token.

{
  "mcpServers": {
    "leaf": {
      "url": "https://mcp.withleaf.io/mcp",
      "headers": {
        "LEAF_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Use the remote HTTP server as the canonical setup. Older local npx-based examples are outdated.

Available tools

The server groups its tools into the categories listed below. Each tool accepts typed parameters and returns JSON matching the corresponding Leaf API response.

User management

Tool	Description
List users	Returns a paginated list of Leaf users for your account. Filterable by email, name, or external ID.
Get Leaf user configuration	Returns configuration settings for a Leaf user. If the user has no custom configuration, settings are inherited from the API owner.
Get API owner configuration	Returns the default configuration for the API owner, including operation image creation, auto-sync, and merge settings.

Fields

Tool	Description
List fields	Returns a paginated list of fields for a Leaf user. Filterable by type, farm ID, or provider.
Get field	Returns a single field by its UUID.
Get field boundary	Returns the active boundary geometry for a field.

Field operations

Tool	Description
List operations	Returns a paginated list of field operations. Filterable by provider, time range, operation type, and field.
Get operation	Returns a single operation by its UUID.
Get operation summary	Returns aggregated statistics (area, elevation, speed, and operation-specific properties) for an operation.
Get operation units	Returns the property-to-unit mapping for an operation.

Machine files

Tool	Description
List files	Returns a paginated list of machine files. Filterable by provider, status, origin, operation type, time range, and more.
Get file	Returns a single machine file by its UUID.
Get file summary	Returns the summary for a machine file.
Get file units	Returns the property-to-unit mapping for a machine file.
Get file status	Returns the processing status for every step of the Leaf pipeline for a file.

Batch uploads

Tool	Description
List batches	Returns a paginated list of manual-upload batches. Filterable by provider and status.
Get batch	Returns a single batch by its UUID.
Get batch status	Returns the processing status of all files inside a batch.

Weather

Tool	Description
Forecast (field, daily)	Returns daily forecasted weather for a Leaf user’s field.
Forecast (field, hourly)	Returns hourly forecasted weather for a Leaf user’s field.
Forecast (lat/lon, daily)	Returns daily forecasted weather for a coordinate pair.
Forecast (lat/lon, hourly)	Returns hourly forecasted weather for a coordinate pair.
Historical (field, daily)	Returns daily historical weather for a Leaf user’s field.
Historical (field, hourly)	Returns hourly historical weather for a Leaf user’s field.
Historical (lat/lon, daily)	Returns daily historical weather for a coordinate pair.
Historical (lat/lon, hourly)	Returns hourly historical weather for a coordinate pair.

Weather tools accept optional model and units parameters. Time parameters use ISO 8601 format.

Billing

Tool	Description
List contracts	Returns all billing contracts for your account.
Get contract	Returns a single contract by ID, including product type, date range, region, and quota.
Get consumption	Returns consumption data for a contract. Optionally pass a timestamp to query a specific day.

Provider credentials

Tool	Description
Get John Deere credential events	Returns connection events and status for a Leaf user’s John Deere credentials.
Get Climate FieldView credential events	Returns connection events and status for a Leaf user’s Climate FieldView credentials.
Get CNHI credential events	Returns connection events and status for a Leaf user’s CNHI credentials.

Credential event tools are intended for troubleshooting. They expose authentication status and error details for provider connections.

Authentication

Configuration

Leaf Users

Alerts

Providers

Data Hierarchy

Machine data

Satellite imagery

Weather

Soil Sampling

Leaf Lake

UI components

MCP server

Irrigation

Usage tracking

Beta

Overview

Configuration

Available tools

User management

Fields

Field operations

Machine files

Batch uploads

Weather

Billing

Provider credentials

​Overview

​Configuration

​Available tools

​User management

​Fields

​Field operations

​Machine files

​Batch uploads

​Weather

​Billing

​Provider credentials

Overview

Configuration

Available tools

User management

Fields

Field operations

Machine files

Batch uploads

Weather

Billing

Provider credentials