MCP server for ZenControl DALI-2 lighting control via the ZenControl Cloud API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"zencontrol-cloud-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# zencontrol-cloud-mcp MCP server for ZenControl DALI-2 lighting control via the ZenControl Cloud API.   ## Overview **zencontrol-cloud-mcp** enables AI assistants — such as Claude, Cursor, and other MCP-compatible clients — to discover and control [ZenControl](https://zencontrol.com/) DALI-2 lighting systems through natural language. Built on the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) with [FastMCP](https://github.com/jlowin/fastmcp), the server supports two transports: - **stdio** — for local, single-user setups (Claude Desktop, Cursor, etc.) - **StreamableHTTP** — for hosted / multi-user deployments ## Features | Tool | Description | |------|-------------| | `list_sites` | Discover accessible ZenControl sites | | `get_site_details` | Explore site hierarchy (floors, zones, gateways, tenancies) | | `list_groups` | List lighting groups by scope (site, floor, map, or gateway) | | `list_devices` | List devices and their ECGs by scope | | `control_light` | On/off, dim, set level (0–100 %), recall scenes, identify | | `set_colour` | Colour temperature (Kelvin) or RGBWAF control | ## Prerequisites - **Python 3.11+** - **ZenControl Cloud account** with API credentials (`client_id` and `client_secret`) — see [How to use OAuth 2.0 authentication for zencontrol cloud APIs](https://support.zencontrol.com/hc/en-us/articles/360001424956-How-to-use-OAuth-2-0-authentication-for-zencontrol-cloud-APIs) for instructions on obtaining credentials - **[uv](https://docs.astral.sh/uv/)** package manager (recommended) or `pip` ## Quick Start 1. **Set your credentials:** ```bash export ZENCONTROL_CLIENT_ID=your_client_id export ZENCONTROL_CLIENT_SECRET=your_client_secret ``` 2. **Run with `uvx`:** ```bash uvx zencontrol-cloud-mcp ``` On first launch a browser window will open …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.