II. Configuration

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

   

   ℹ️ 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 **

   

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

How Actions Are Identified

Stream Deck actions are identfied 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

   

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.

   

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

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 need refresh the action list in the Global Variables page. To do so, you can create a Streamer.bot action and add a RefreshExecutableActions Execute Method there. You can then run this by either testing the trigger or setting any triggers that you desire.

Next Step

To understand what happens behind the scenes:

👉 How It Works