MCP server that lets AI assistants read the live CheerLights color, its history, and statistics
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":"cheerlights-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.
# CheerLights MCP server An MCP server that lets Claude and other AI assistants read the live CheerLights color, its history, and statistics. [](https://pypi.org/project/cheerlights-mcp/) [](https://pypi.org/project/cheerlights-mcp/) [](https://github.com/cheerlights/cheerlights-mcp/actions/workflows/ci.yml) [](https://github.com/cheerlights/cheerlights-mcp/blob/main/LICENSE) [CheerLights](https://cheerlights.com) is a global network of lights that all show the same color, set by anyone on the [CheerLights Discord](https://cheerlights.com/discord). This server reads the public CheerLights feed (ThingSpeak channel 1417) and gives an assistant five read-only tools: the current color, recent history, statistics, search, and HEX and RGB values. It is built on the MCP Python SDK 2.x and needs no API key. ## Quick start You need [uv](https://docs.astral.sh/uv/), which installs Python 3.10 or later for you. `uvx` runs the server straight from [PyPI](https://pypi.org/project/cheerlights-mcp/), with nothing else to install. Add the server to Claude Code: ```bash claude mcp add cheerlights -- uvx cheerlights-mcp ``` Or add it to Claude Desktop's `claude_desktop_config.json` and restart the app: ```json { "mcpServers": { "cheerlights": { "command": "uvx", "args": ["cheerlights-mcp"] } } } ``` Then ask: "What's the current CheerLights color?" The assistant calls `get_current_cheerlights_color` and answers with the live color. ## Example These results come from a live run of version 3.0.0 over stdio on 2026-10-28 (`examples/client_example.py`). `get_current_cheerlights_color` returns the color, its HEX value, and when it was set: ```json { "color": "purple", "hex": "#800…
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.