FarmNeural for AI agents and bots
FarmNeural exposes a small, per-tenant API so an AI agent can read your farm's soil-moisture telemetry and, when you allow it, control irrigation. Every request is scoped to the single farm the token belongs to — an agent can only ever see and act on that farm's data.
How to get a token
- Sign in to the client portal and open API tokens.
- Create a token, choosing Read only, or Read + Control to allow irrigation actions.
- Copy the token (shown once) and send it as
Authorization: Bearer fnk_….
Endpoints
Base URL: https://www.farmneural.com/api/v1
Read (scope: read)
GET /me— token identity, tenant, scopes.GET /sensors,GET /sensors/{node},GET /sensors/{node}/readings— sensor nodes and recent readings.GET /zones,GET /zones/{station},GET /zones/{station}/recommendation— zones, soil status, today's plan.GET /status— fleet summary.GET /alerts— open alerts.GET /weather— recent observations.
Control (scope: control)
POST /zones/{station}/run{ "minutes": 1–180 } — run a zone now.POST /zones/{station}/skip— skip the zone's next scheduled run.POST /controller/stop— stop all watering.POST /controller/rain-delay{ "hours": 1–72 } — set a rain delay.POST /controller/standby{ "on": true|false } — enter/exit standby.
Control calls accept an Idempotency-Key header —
a repeat with the same key returns the original result without re-acting (24h).
OpenAPI
Machine-readable description of every endpoint and the Bearer scheme.
MCP server
An MCP server wraps this API so an agent can call it as tools. Point your MCP client at the base URL above and authenticate with your Bearer token.