io.github.hummingbot/mcp

Deploy a bot with specified controller configurations. Args: bot_name: Name of the bot to deploy controllers_config: List of controller configs to use for the bot deployment. account_name: Account name to use for the bot (default: master_account) max_global_drawdown_quote: Maximum global drawdown in quote currency (optional) defaults to None. max_controller_drawdown_quote: Maximum drawdown per controller in quote currency (optional) defaults to None. image: Docker image to use for the bot (default: "hummingbot/hummingbot:latest")

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 Args: action: "list" to list controllers or "describe" to show details of a specific controller or config. controller_type: Type of controller to filter by (optional, e.g., 'directional_trading', 'market_making', 'generic'). controller_name: Name of the controller to describe (optional, only required for describe specific controller). config_name: Name of the config to describe (optional, only required for describe specific config).

Get the status of all active bots. Including the unrealized PnL, realized PnL, volume traded, latest logs, etc.

Get the real-time candles for a trading pair on a specific exchange connector. Args: connector_name: Exchange connector name (e.g., 'binance', 'binance_perpetual') trading_pair: Trading pair to get candles for (e.g., 'BTC-USDT') interval: Candle interval (default: '1h'). Options include '1m', '5m', '15m', '30m', '1h', '4h', '1d'. days: Number of days of historical data to retrieve (default: 30).

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. Args: connector_name: Exchange connector name (e.g., 'binance_perpetual', 'hyperliquid_perpetual') trading_pair: Trading pair to get funding rate for (e.g., 'BTC-USDT')

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 Args: connector_name: Connector name (e.g., 'binance', 'binance_perpetual') trading_pair: Trading pair (e.g., BTC-USDT) query_type: Order book query type ('snapshot', 'volume_for_price', 'price_for_volume', 'quote_volume_for_price', 'price_for_quote_volume') query_value: Only required if query_type is not 'snapshot'. The value to query against the order book. is_buy: Only required if query_type is not 'snapshot'. Is important to see what orders of the book analyze.

Get the orders manged by the connected accounts. Args: account_names: List of account names to filter by (optional). If empty, returns all accounts. connector_names: List of connector names to filter by (optional). If empty, returns all connectors. trading_pairs: List of trading pairs to filter by (optional). If empty, returns all trading pairs. status: Order status to filter by can be OPEN, PARTIALLY_FILLED, FILLED, CANCELED, FAILED (is optional). start_time: Start time (in seconds) to filter by (optional). end_time: End time (in seconds) to filter by (optional). limit: Number of orders to return defaults to 500, maximum is 1000. cursor: Cursor for pagination (optional, should be used if another request returned a cursor).

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. Args: account_names: List of account names to filter by (optional). If empty, returns all accounts. connector_names: List of connector names to filter by (optional). If empty, returns all connectors. as_distribution: If True, returns the portfolio distribution as a percentage of each token in the portfolio and their values across accounts and connectors. Defaults to False.

Get the positions managed by the connected accounts. Args: account_names: List of account names to filter by (optional). If empty, returns all accounts. connector_names: List of connector names to filter by (optional). If empty, returns all connectors. limit: Number of positions to return defaults to 100, maximum is 1000.

Get the latest prices for the specified trading pairs on a specific exchange connector. Args: connector_name: Exchange connector name (e.g., 'binance', 'binance_perpetual') trading_pairs: List of trading pairs to get prices for (e.g., ['BTC-USDT', 'ETH-USD'])

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. Args: action: "upsert" (create/update) or "delete" target: "controller" (template) or "config" (instance) confirm_override: Required True if overwriting existing config_data: For config creation, MUST contain all required controller parameters. Use explore_controllers first! Workflow for creating a config: 1. Use explore_controllers(action="describe", controller_name="<name>") to see required parameters 2. Create config_data dict with ALL required parameters from the controller template 3. Call modify_controllers with the complete config_data Examples: - Create new controller: modify_controllers("upsert", "controller", controller_type="market_making", ...) - Create config: modify_controllers("upsert", "config", config_name="pmm_btc", config_data={...}) - Modify config from bot: modify_controllers("upsert", "config", config_name="pmm_btc", config_data={...}, bot_name="my_bot") - Delete config: modify_controllers("delete", "config", config_name="old_strategy")

Place a buy or sell order (supports USD values by adding at the start of the amount $). Args: connector_name: Exchange connector name (e.g., 'binance', 'binance_perpetual') trading_pair: Trading pair (e.g., BTC-USDT, ETH-USD) trade_type: Order side ('BUY' or 'SELL') amount: Order amount (is always in base currency, if you want to use USD values, add a dollar sign at the start, e.g., '$100') order_type: Order type ('MARKET' or 'LIMIT') price: Price for limit orders (required for limit orders) position_action: Position action ('OPEN', 'CLOSE'). Defaults to 'OPEN' and is useful for perpetuals with HEDGE mode where you can hold a long and short position at the same time. account_name: Account name (default: master_account)

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. Args: account_name: Account name (default: master_account) connector_name: Exchange connector name (e.g., 'binance_perpetual') trading_pair: Trading pair (e.g., ETH-USD) only required for setting leverage position_mode: Position mode ('HEDGE' or 'ONE-WAY') leverage: Leverage to set (optional, required for HEDGE mode)

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) Args: connector: Exchange connector name (e.g., 'binance', 'binance_perpetual'). Leave empty to list available connectors. credentials: Credentials object with required fields for the connector. Leave empty to see required fields first. account: Account name to add credentials to. If not provided, prompts for account selection. confirm_override: Explicit confirmation to override existing connector. Required when connector already exists.

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. Args: bot_name: Name of the bot to stop controller_names: List of controller names to stop (optional, if not provided will stop the bot execution)