Hydrawise

MCP server for Hunter Hydrawise irrigation controllers. Exposes the Hydrawise REST API v1.6 as MCP tools for AI agent integration.

Tools

Tool	Description
get_customer_details	List controllers and account info
get_watering_schedule	Zone schedules, run times, and sensors
hydrawise_api	Raw API pass-through for any endpoint

A hydrawise://api-reference resource provides full endpoint documentation to connected agents.

Safety

Write operations (setzone.php) are blocked by default. Set HYDRAWISE_ALLOW_WRITES=true to enable zone run/stop/suspend commands.

Quick Start

cp .env.example .env
# Add your API key to .env

docker build -t hydrawise-mcp .
docker run --env-file .env -p 8000:8000 hydrawise-mcp

curl http://localhost:8000/health

Configuration

Variable	Required	Default	Description
HYDRAWISE_API_KEY	Yes	—	API key from app.hydrawise.com
HYDRAWISE_ALLOW_WRITES	No	false	Enable zone control commands
PORT	No	8000	Server listen port

API Key

Generate an API key at My Account → Generate API Key in app.hydrawise.com.