Hummingbot MCP: Trading Agent
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
Requires Configuration
Requires Secrets
Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
Tools
| Name | Description |
|---|---|
deploy_bot_with_controllers | Deploy a bot with specified controller configurations. |
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 |
get_active_bots_status | Get the status of all active bots. Including the unrealized PnL, realized PnL, volume traded, latest logs, etc. |
get_candles | Get the real-time candles for a trading pair on a specific exchange connector. |
get_funding_rate | Get the latest funding rate for a trading pair on a specific exchange connector. Only works for perpetual connectors so the connector name must have _perpetual in it. |
get_order_book | Get order book data for a trading pair on a specific exchange connector, if the query type is different than snapshot, you need to provide query_value and is_buy |
get_orders | Get the orders manged by the connected accounts. |
get_portfolio_balances | Get portfolio balances and holdings across all connected exchanges. Returns detailed token balances, values, and available units for each account. Use this to check your portfolio, see what tokens you hold, and their current values. If passing accounts and connectors it will only return the filtered accounts and connectors, leave it empty to return all accounts and connectors. You can also get the portfolio distribution by setting `as_distribution` to True, which will return the distribution of tokens and their values across accounts and connectors and the percentage of each token in the portfolio. |
get_positions | Get the positions managed by the connected accounts. |
get_prices | Get the latest prices for the specified trading pairs on a specific exchange connector. |
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. |
place_order | Place a buy or sell order (supports USD values by adding at the start of the amount $). |
set_account_position_mode_and_leverage | Set position mode and leverage for an account on a specific exchange. If position mode is not specified, will only set the leverage. If leverage is not specified, will only set the position mode. |
setup_connector | Setup a new exchange connector for an account with credentials using progressive disclosure. This tool guides you through the entire process of connecting an exchange with a four-step flow: 1. No parameters → List available exchanges 2. Connector only → Show required credential fields 3. Connector + credentials, no account → Select account from available accounts 4. All parameters → Connect the exchange (with override confirmation if needed) |
stop_bot_or_controllers | Stop and archive a bot forever or stop the execution of a controller of a runnning bot. If the controllers to stop are not specified, it will stop the bot execution and archive it forever, if they are specified, will only stop the execution of those controllers and the bot will still be running with the rest of the controllers. |
Manual installation
You can install the MCP server using:
Installation for