Skip to main content
There are two general approaches you can use to install the watsonx Orchestrate MCP Server. The first and recommended way uses tools like pipx or uvx, which automatically install the package in an isolated environment and run it for you. The second approach involves installing and running the package manually.

​
Before you begin

​
Required software

The watsonx Orchestrate MCP Server requires the use of the watsonx Orchestrate ADK. Make sure you have all the necessary dependencies.

​
Package Runner Approach

You can run the watsonx Orchestrate MCP Server using either pipx or uvx. This method combines file installation and server startup into a single command.
  • uvx
  • pipx
uv is a new Python package and environment manager written in Rust. It replaces many common tools such as pip, pip-tools, pipx, poetry, pyenv, twine, and virtualenv in a single tool. For more information, see Install uv.
BASH
uvx ibm-watsonx-orchestrate-mcp-server

​
Local Installation Approach

You can install the package locally. For this approach, use a virtual environment to avoid package conflicts.
  • System installation
  • Virtual environments
  • uv
  1. Install the MCP Server package on your system:
BASH
pip install  --upgrade ibm-watsonx-orchestrate-mcp-server
  1. Start the MCP Server:
BASH
ibm-watsonx-orchestrate-mcp-server
⌘I