Docs Build
Errors and refusals
What a refusal looks like, and what to do about the common ones.
A tool that refuses says why:
{"error": "offline", "detail": "Lounge TV isn't connected."}
Fix what it says and try again. A scene with problems lists every one: fix them all, and read the warnings too.
Refusals that are the screen’s, not yours#
| Error | What it means | What to do |
|---|---|---|
offline |
the screen isn’t connected | ask whether it’s on, with Flisk running |
no_answer |
it’s connected, but didn’t answer in time (busy, or a Mac asleep) | its detail says whether what you asked was sent: check before sending again |
unsupported |
its app is too old for that | say so: only a person installing a newer Flisk app there can change it |
Over MCP#
Requests without a valid token are refused before any tool runs. A token that’s been revoked stops working at once: ask the person for a new one (Tokens and security).