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
A public, no-auth MCP server exposes FarmNeural's company facts, packages, and product capabilities as tools — safe for any assistant to call, no tenant data involved. There is no MCP wrapper for the per-tenant Bearer API above yet; call it as plain REST.