hydrawise-mcp
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/healthConfiguration
| 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.
