# Suffuse MCP server

> Enables AI agents to inspect, control, and restore Govee smart lights through a safe, write-gated MCP server and specialized Agent Skill.

- Repository: https://github.com/andyed/suffuse
- Page: https://hostedmcp.org/servers/andyed/suffuse
- Transport: —
- Stars: 3
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GOVEE_API_KEY` | no | no |  |

## Tools (14)

- `govee_inspect_devices`
- `govee_inspect_household`
- `govee_list_scenes`
- `govee_validate_score`
- `govee_compile_score`
- `govee_apply_score`
- `govee_inspect_receipt`
- `govee_restore`
- `govee_list_palettes`
- `govee_lan_scan`
- `govee_lan_paint`
- `govee_lan_release`
- `govee_ble_scan`
- `govee_ble_set`

## FAQ

### Does the Govee API key allow physical control of lights?

No, the API key authenticates cloud access and device discovery, but physical writes still require the server-level write switch and explicit tool confirmation.

### How can I ensure an AI agent doesn't change my lights without permission?

Suffuse uses a safety model where physical writes require both an environment variable (GOVEE_MCP_ALLOW_WRITES=1) and explicit confirmation on the individual tool call.

### Can I control Govee lights without an API key?

Yes, you can use LAN scanning and Bluetooth LE discovery to find and control devices without an API key, though the key is required for cloud-based features.

### What is a LightScore?

A LightScore is a provider-neutral format used to describe lighting intent, such as power, brightness, color, or gradients, targeting specific devices by SKU or name.