hydrawise-mcp

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/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.