CLI Reference

Hatago MCP Hub exposes the hatago command.

Install / Run

# npx (recommended)
npx @himorishige/hatago-mcp-hub --version

# or global
npm install -g @himorishige/hatago-mcp-hub

hatago init

Create hatago.config.json.

hatago init                    # interactive
hatago init --mode stdio       # STDIO template
hatago init --mode http        # HTTP template
hatago init --config my.json   # custom path

Options: --config, --force, --mode <stdio|http>

hatago serve

Start the hub.

hatago serve --stdio --config ./hatago.config.json  # STDIO
hatago serve --http                                 # HTTP
# Hot reload using external tools (v0.0.14+)
npx nodemon --exec "hatago serve" --watch hatago.config.json
hatago serve --tags dev,api                         # tag filter
hatago serve --verbose                              # verbose logs

Options: --stdio|--http, --config, --host, --port, --tags, --verbose|--quiet

Auto-reload Configuration (v0.0.14+)

Built-in config watching was removed in v0.0.14 for performance improvements. Use external tools for auto-reload:

# Using nodemon
npx nodemon --exec "hatago serve" --watch hatago.config.json

# Using PM2
pm2 start "hatago serve" --watch hatago.config.json

Client examples

Claude Code .mcp.json:

{
  "mcpServers": {
    "hatago": {
      "command": "npx",
      "args": ["@himorishige/hatago-mcp-hub", "serve", "--stdio", "--config", "./hatago.config.json"]
    }
  }
}

Codex CLI ~/.codex/config.toml:

[mcp_servers.hatago]
command = "npx"
args = ["-y", "@himorishige/hatago-mcp-hub", "serve", "--stdio", "--config", "./hatago.config.json"]