# hydrawise-mcp

MCP server for [Hunter Hydrawise](https://www.hydrawise.com/) 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

```bash
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](https://app.hydrawise.com).