agent playbook

Connect your agent.

Grok Bot, Claude, or any MCP client. You pair it once, choose what it may do, and it runs the show over MCP. Your stream keys stay with you.

1 · Pair

Get the app and start the studio. On Linux: lightcast studio &
Run the agent setup once:
```
lightcast setup agents
```
or in the app: Agents → Connect an agent…
Pick your agent and choose a grant:

Look only sees status and screenshots

Scene assistant builds and proposes scenes

Live producer can also go live and end the stream
Your agent shows a six-digit code. Confirm it matches the one in the app.

Look only	sees status and screenshots
Scene assistant	builds and proposes scenes
Live producer	can also go live and end the stream

Manual MCP config (Grok)

If setup can't write it, add this to ~/.grok/config.toml and restart Grok:

[mcp_servers.lightcast]
command = "lightcast-tray"
args = ["mcp"]
# macOS:
# command = "/Applications/Lightcast.app/Contents/MacOS/lightcast-menubar"

goal	the agent does
see the program	`get_status`, `screenshot`
build a scene	`propose_scene`, then you tap Apply
go live	`go_live` once status looks healthy (Live producer)
stop	`end_stream`

You apply every draft. An agent proposes; only you put a draft on air.
Keys stay private. An agent can store a key you hand it, never read one back. Sign-ins happen in the app.
Grants end when they expire, when you revoke them in Agents, or when the app restarts.
Stuck? The agent reads the checklist and asks you. It never guesses credentials.

The open surface of a closed core. Grants gate every tool.

status & sight: get_status screenshot preflight get_setup list_devices
scenes & sources: list_scenes list_sources switch_scene add_scene add_source set_layout set_text set_mute set_volume
drafts (you apply): propose_scene propose_scene_edit propose_banner_edit preview_draft discard_draft
live & record: go_live end_stream start_recording stop_recording rehearse save_replay mark_highlight stream_video test_connection apply_recommended_settings
show craft: show_banner hide_banner show_chat_message get_chat go_to_cue next_cue show_shortcut toggle_zoom set_presenter_zoom list_highlights make_clip speak speech_status
guests & setup (often yours to confirm): open_guest_room add_guest connect_account set_destination set_recording_folder hide_sensitive_info
ask: ask_poll ask_reply