io.github.hummingbot/mcp

MCP server exposing Hummingbot API for automated multi-exchange trading

io.github.hummingbot/mcp · Repository · version 0.1.0 · 59 stars · listed from registry

Install

The sweep pulls the image and runs it in a throwaway container, but this is the command a user would run:

docker run -i --rm docker.io/hummingbot/hummingbot-mcp:0.1.0

Needs credentials: HUMMINGBOT_API_URL, HUMMINGBOT_USERNAME, HUMMINGBOT_PASSWORD. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-08-16 · probed over oci

2 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Traceback (most recent call last):
  File "/app/hummingbot_mcp/settings.py", line 52, in get_settings
    return Settings(
           ^^^^^^^^^
  File "/app/.venv/lib/python3.12/site-packages/pydantic/main.py", line 253, in __init__
    validated_self = self.__pydantic_validator__.validate_python(data, self_instance=self)
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pydantic_core._pydantic_core.ValidationError: 1 validation error for Settings
api_url
  Value error, API URL must start with http:// or https:// [type=value_error, input_value='DOES_IT_INSTALL_PLACEHOLDER', input_type=str]
    For further information visit https://errors.pydantic.dev/2.11/v/value_error

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/app/main.py", line 10, in <module>
    from hummingbot_mcp import main
  File "/app/hummingbot_mcp/__init__.py", line 11, in <module>
    from .server import main
  File "/app/hummingbot_mcp/server.py", line 13, in <module>
    from hummingbot_mcp.hummingbot_client import hummingbot_client
  File "/app/hummingbot_mcp/hummingbot_client.py", line 11, in <module>
    from hummingbot_mcp.settings import settings
  File "/app/hummingbot_mcp/settings.py", line 66, in <module>
    settings = get_settings()
               ^^^^^^^^^^^^^^
  File "/app/hummingbot_mcp/settings.py", line 62, in get_settings
    raise ConfigurationError(f"Failed to load configuration: {e}")
hummingbot_mcp.exceptions.ConfigurationError: Failed to load configuration: 1 validation error for Settings
api_url
  Value error, API URL must start with http:// or https:// [type=value_error, input_value='DOES_IT_INSTALL_PLACEHOLDER', input_type=str]
    For further information visit https://errors.pydantic.dev/2.11/v/value_error

macOS

not tested2026-08-16

2 recorded runs, oldest first.

docker not available on this runner, so container distributions are probed on Linux only

Windows

not tested2026-08-16

2 recorded runs, oldest first.

docker not available on this runner, so container distributions are probed on Linux only

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.hummingbot__mcp.json)](https://doesitinstall.com/s/io.github.hummingbot__mcp.html)