Hummingbot MCP is an open-source toolset that lets you control and monitor your Hummingbot trading bots through AI-powered commands and automation.
15 Tools
Version 4.43 or later needs to be installed to add the server automatically
Tools
Name | Description |
---|---|
explore_controllers | Explore and understand controllers and their configs. Use this tool to discover what's available and understand how things work. Progressive flow: 1. action="list" → List all controllers and their configs 2. action="list" + controller_type → List controllers of that type with config counts 3. action="describe" + controller_name → Show controller code + list its configs + explain parameters 4. action="describe" + config_name → Show specific config details + which controller it uses Common Enum Values for Controller Configs: Position Mode (position_mode): - "HEDGE" - Allows holding both long and short positions simultaneously - "ONEWAY" - Allows only one direction position at a time - Note: Use as string value, e.g., position_mode: "HEDGE" Trade Side (side): - 1 or "BUY" - For long/buy positions - 2 or "SELL" - For short/sell positions - 3 - Other trade types - Note: Numeric values are required for controller configs Order Type (order_type, open_order_type, take_profit_order_type, etc.): - 1 or "MARKET" - Market order - 2 or "LIMIT" - Limit order - 3 or "LIMIT_MAKER" - Limit maker order (post-only) - 4 - Other order types - Note: Numeric values are required for controller configs |
modify_controllers | Create, update, or delete controllers and their configurations. If bot name is provided, it can only modify the config in the bot deployed with that name. IMPORTANT: When creating a config without specifying config_data details, you MUST first use the explore_controllers tool with action="describe" and the controller_name to understand what parameters are required. The config_data must include ALL relevant parameters for the controller to function properly. Controllers = are essentially strategies that can be run in Hummingbot. Configs = are the parameters that the controller uses to run. |
Manual installation
You can install the MCP server using:
Installation for