Toggle a GPIO pin between on (1) and off (0). Flips the current digital state of the pin. If the pin is on, it turns off, and vice versa. Useful for quickly switching peripherals like lights or the water valve.
AI agents invoke farmbot_toggle_pin to trigger actions in Farmbot Agent. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call — builds kicked off, notifications sent, workflows started.
This tool triggers an external hardware operation — changing the physical state of a GPIO pin on the FarmBot device. It can control peripherals like water valves, which could cause physical-world consequences (e.g., unintended watering). This is an Execute-category action because it triggers external operations with real-world effects.
From the tool's definition Toggle a GPIO pin between on (1) and off (0). Flips the current digital state of the pin. Useful for quickly switching peripherals like lights or the water valve.
Attacks that exploit this kind of access
Toggle a GPIO pin between on (1) and off (0). Flips the current digital state of the pin. If the pin is on, it turns off, and vice versa. Useful for quickly switching peripherals like lights or the water valve. It is categorised as a Execute tool in the Farmbot Agent MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.
Register the Farmbot Agent MCP server in PolicyLayer and add a rule for farmbot_toggle_pin: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Farmbot Agent. Nothing to install.
farmbot_toggle_pin is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.
Yes. Add a rate_limit block to the farmbot_toggle_pin rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for farmbot_toggle_pin. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
farmbot_toggle_pin is provided by the Farmbot Agent MCP server (kieranklaassen/farmbot-agent-cli-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
Every MCP server has a record like this.
Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.
Teams ship this data inside their own products. See what a licence covers →