start_stream

io.github.streamloop/mcp · Verify this server

Start streaming now, looping the stream's playlist (or playing its scene) until it is stopped. THIS PUTS VIDEO IN FRONT OF THE PUBLIC, so confirm with the user first unless they just asked for it. Requires a destination plus either a playable video playlist (at least one item) or an attached published scene (set_stream_scene) — check_stream_readiness reports what is missing without changing anything, and is worth calling first. A failed pre-flight is NOT an error: the call succeeds and the answer's `state` is `invalid` — read `state` first: invalid means refused, with `issues` saying why (fix them and start again); `preparing` means accepted. Media facts (duration, sound) arrive about 15-25 s after an upload completes, so a playlist of just-finished uploads can be refused until then. Other refusals (a state that cannot start, a guard failing at the moment of starting) are errors. Credits are NOT part of the pre-flight: the balance is verified when the stream actually activates, so an otherwise-ready stream can still fail to start on an empty wallet — get_billing_overview is what tells you that. A playlist loop takes the playlist as it currently is, with nothing to publish first; a scene plays its published version (publish_scene). Asynchronous: the stream reports a starting state immediately and is live within about a minute. To start at a future time (or every day) use schedule_stream instead. Returns state, started (false when refused), issues (when refused) and startStream (the stream: id, name, state).