Step-by-step: Connect the Beam Shell Agent to Orchestrate
Once you have selected the Beam Shell Agent in IBM watsonx Orchestrate, follow these steps to install the required MCP tools and activate the connection to Beam:
Open the Agent Toolset
Navigate to Manage Agents in Orchestrate.
Select your agent (e.g., Invoice Reconciliation).
In the left menu, click Toolset.
Click Add Tool.

2. Add Tools from MCP Server
In the “Add a new tool” dialog, select Add from file or MCP server.
Choose Import from MCP Server.
Fill in the fields as follows:
Name: Any name you prefer (e.g., Beam MCP Proxy)
Connection: Select None
Install Command as follows
Use this:
uvx mcp-proxy https://api.beamstudio.ai/mcp --stateless --transport streamablehttp
3. Enable Required Tools
Once the MCP Server installation is complete, two tools will appear in the agent’s toolset:
beam_ai:startTask
beam_ai:listenTask
Enable both tools.
You’re Done
Your agent is now connected to the Beam platform via the Beam MCP Server and ready to process tasks in real-time.
If you need help, contact us at demo@beam.ai or refer to the Beam Shell Agent documentation in the Beam Academy.