Build on Roots
Roots runs the farm: every animal, herd and flock, every paddock, tracker and Roost house, the alerts that need you and the work for the crew. Everything you see in the dashboard is in the API, the SDK, the CLI and the MCP server.
Quick startSign up, get a key and read your farm in two minutes.
API referenceEvery endpoint at api.roots.sh.
RoostFeed, water, doors, move, climate, heaters and the winter floor.
Devices and ingestHow trackers and Roost report, and pick up commands.
MCP serverClaude, ChatGPT, Cursor and any agent, on your farm.
TypeScript SDKTyped, zero dependencies.
CLI
roots brief from any terminal.
WebhooksSigned events when alerts open and commands finish.
Where things live
| Host | What |
|---|---|
my.roots.sh |
The dashboard |
api.roots.sh |
The REST API (OpenAPI) |
mcp.roots.sh/mcp |
The MCP server |
ingest.roots.sh |
Where devices report |
docs.roots.sh |
These docs, the SDK and the CLI |
Test and live
Every account has two modes. Test holds the sample farm: a Roost with a broiler flock, a cow-calf herd on boluses, a guardian dog, paddocks, alerts and tasks. Commands to sample devices run in simulation, so you can try everything. Live holds your real farms. Keys are per mode: rk_test_… sees test data, rk_live_… sees live data.