Skip to content

II. Configuration

Jump to bottom
rexbordz edited this page Apr 10, 2026 · 7 revisions

This page explains how to connect Streamer.bot triggers to your Stream Deck actions.

Overview

This integration works by letting Streamer.bot trigger existing Stream Deck actions via MCP.

Instead of creating actions inside Streamer.bot, you:

  1. Set up your buttons in Stream Deck
  2. Use Streamer.bot triggers
  3. Reference the Stream Deck action you want to execute

Step 1: Prepare Your Stream Deck Buttons

Before configuring anything in Streamer.bot:

  • Create or locate the button you want to trigger
  • This can be:
    • A regular Stream Deck action
    • A plugin action

Warning

Only existing buttons in MCP Actions page can be triggered.

Step 2: Configure in Streamer.bot

This is where you connect a trigger to a Stream Deck action.

  1. Create a Streamer.bot action

  2. Add the desired trigger in the Triggers section

  3. Add a Set Argument sub-action and set the following:

    Variable Name: actionInput

    Value: There are two options for input here - action title (defined in the Stream Deck Button's Title field configuration) or the button id

    Example

    image

    ℹ️ INFO: Learn more about How Actions Are Identified

  4. Add a Execute C# Method and set the following

    Execute C# Code: Stream Deck MCP

    Methods: ExecuteMcpAction

    **Example **

    image

(You will define how the button is identified here — e.g., by name, ID, etc.)

How Actions Are Identified

Stream Deck actions are identied through the button title or id and here's the safest way to get both

Title

  1. Select a button in your Stream Deck's MCP Actions page

  2. Copy the value of the Title field from there

    image

ID

  1. In Streamer.bot, go to Global Variables

  2. Go to Non-Persisted Globals

  3. All the variables that have an [SD] prefix are the available executable actions from your MCP Actions page. The Value column contains the button id. You can double-click and copy it.

    image

Note

If you didn't set a title for a button, it will fall back in this format - {pluginId} {action.name}_{index} (e.g. [SD] bot.streamer.streamdeck Action_1) which is supplied by the payload.

Example

Goal: Toggle Voice Focus through Voice Commands

image

With this configuration, I can toggle the Voice Focus button on my Stream Deck through this Voice Control trigger.

How to Refresh the Action List

Everytime you add/change the buttons on your MCP Actions page, you should also refresh the action list in the Global Variables page. To do so, you can create a Streamer.bot action and tie it to the RefreshExecutableActions method. You can then run this by either testing the trigger or setting any triggers that you desire.

image

Next Step

To understand what happens behind the scenes:

👉 How It Works

Clone this wiki locally