Trigger immediate display-group actions (Change Layout, Collect Now, Revert to Schedule, Request Screenshot) via the Xibo CMS API's Command/XMR action endpoints
domain: account.xibosignage.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate to the CMS API via OAuth2 client-credentials grant against /api/authorize/access_token
GET /api/displaygroup to resolve the target displayGroupId (or /api/display for a single display)
POST the changeLayout action with layoutId and duration to push an immediate override to the display/group
POST a Collect Now command to force the player to poll XMDS immediately instead of waiting for its collection interval
POST a Request Screenshot command, then poll the display's status/screenshot resource to retrieve the image once the player uploads it
POST Revert to Schedule to cancel the override and return the display to its normal schedule
Known gotchas
Commands are delivered over XMR (Xibo Message Relay), a persistent push channel separate from XMDS polling; if XMR is unreachable the API can report the command as sent even though the player never acted
Request Screenshot is asynchronous — the call only requests the capture, the image arrives later via a separate player upload, so you must poll rather than expect it in the response
Commands only propagate to displays currently licensed/authorized; unlicensed or awaiting-authorization displays are silently skipped
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?