farmbot-agent
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@farmbot-agentmove the gantry to x: 450, y: 300 and tell me the current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
farmbot-agent
Agent-native CLI and MCP server for FarmBot hardware control.
Control your FarmBot from the terminal or let AI agents manage your garden through the Model Context Protocol.
Install
npm install -g farmbot-agentRelated MCP server: MCP Toolkit Server
Quick Start (CLI)
# Authenticate
farmbot login --email you@example.com --password yourpassword
# Check status
farmbot status
# Move the gantry
farmbot move --x 100 --y 200 --z 0
# Go home
farmbot home
# Emergency stop
farmbot e-stop
# Unlock after e-stop
farmbot unlock
# Execute Lua on device
farmbot lua 'toast("Hello from the CLI!")'All commands support --json for structured output and --timeout <ms> (default: 30s).
Quick Start (MCP Server)
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"farmbot": {
"command": "npx",
"args": ["-y", "farmbot-agent", "mcp"],
"env": {
"FARMBOT_TOKEN": "your-jwt-token-here"
}
}
}
}Claude Code
claude mcp add farmbot -- npx -y farmbot-agent mcpEnvironment Variable Auth
For MCP mode, set FARMBOT_TOKEN as an environment variable. Get your token:
curl -s -X POST https://my.farm.bot/api/tokens \
-H "Content-Type: application/json" \
-d '{"user":{"email":"you@example.com","password":"yourpassword"}}' \
| jq -r '.token.encoded'MCP Tools
Tool | Description |
| Device status: position, state, firmware |
| Current X, Y, Z position (lightweight) |
| Device config and identification |
| Move gantry to absolute or relative position |
| Home one or all axes |
| Immediately halt all movement |
| Unlock after emergency stop |
| Execute Lua code on the device |
MCP Resources
URI | Description |
| Current device state as JSON |
CLI Commands
Command | Description |
| Authenticate and store token |
| Remove stored token |
| Show device status |
| Move to position ( |
| Go home ( |
| Emergency stop |
| Unlock after e-stop |
| Execute Lua on device |
How It Works
farmbot-agent
├── CLI (Commander) → Human-friendly terminal commands
├── MCP Server (stdio) → AI agent tool interface
└── Shared Services → farmbot-js (MQTT) + FarmBot REST APIFarmBot communication uses MQTT over the farmbot npm package. Commands are sent as CeleryScript RPC requests and responses are matched by UUID. The JWT token contains MQTT broker credentials.
Safety
Coordinate bounds validation on all movement commands
Rate limiting: max 30 move commands per minute (prevents runaway agent loops)
Emergency stop is always available with short timeout
Structured errors with codes, retry hints, and recovery suggestions
Development
git clone https://github.com/kieranklaassen/farmbot-agent
cd farmbot-agent
npm install
npm run build
npm testLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceAn MCP server that enables AI assistants to control and monitor Klipper 3D printers via the Moonraker API. It supports comprehensive printer management, including G-code execution, toolchanger operations, and real-time status monitoring.23-
- AlicenseAqualityDmaintenanceA Model Context Protocol server providing tools for DB queries, API calls, file I/O, and text transformations, enabling AI agents like Claude to perform real-world actions.10MIT
- FlicenseNot gradedqualityCmaintenanceMCP server providing tools to chat with an AI agent, fetch weather data, and monitor agent status via the Model Context Protocol.-
- AlicenseBqualityAmaintenanceMCP server for HortusFox self-hosted plant management system, exposing 38 tools to manage plants, locations, tasks, inventory, calendar, chat, and backups via natural language.3810 npmMIT