Your hosting, from the terminal.

Inspect your sites and VPS, automate tasks and access the tool catalogue authorised for your account. One Python file, with no external dependencies.

Download hostbrid.py Full CLI guide

hostbrid · CLIPython 3

$ python3 ~/bin/hostbrid tools show hostbrid_get_plan

Current plan

Check your plan’s usage and limits for sites, databases, domains, mailboxes and disk space.

sitios:leer

{
  "type": "object",
  "properties": {}
}

Read-only examples · no resources created

Python 3 · standard library · JSON

01 / Install

Install once. Use it in your scripts.

You need Python 3. The download is saved locally, so you can inspect the file before running it. Examples use the full path; add ~/bin to your PATH if you prefer typing hostbrid.

Full CLI guide →

mkdir -p ~/bin
curl --fail --show-error --location \
  https://my.hostbrid.com/cli/hostbrid.py \
  --output ~/bin/hostbrid
chmod 700 ~/bin/hostbrid
python3 ~/bin/hostbrid --help

02 / Resources

Start with your resources

Direct commands cover everyday site, DNS, email and machine tasks. Use --help to inspect options and --json to process the response.

python3 ~/bin/hostbrid sites list
python3 ~/bin/hostbrid maquinas list
python3 ~/bin/hostbrid sites list --json

03 / Tools

Discover before you execute

tools list queries the MCP catalogue allowed by your key. tools show displays a tool’s schema; tools call runs it with JSON arguments. Direct commands and the MCP catalogue share the same client. Query the public plan catalogue without a key using --public; it is separate from your account catalogue.

MCP →

python3 ~/bin/hostbrid tools list
python3 ~/bin/hostbrid tools list --filter plan
python3 ~/bin/hostbrid tools show hostbrid_get_plan
python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments '{}'

python3 ~/bin/hostbrid tools call hostbrid_listar_planes_publicos \
  --arguments '{"tipo_recurso":"vps","limite":3}' --public

04 / JSON

JSON for your pipelines

Save a response, process it with jq or pass it to the next CI step. In tools call, load arguments from @arguments.json or standard input with @-. Check the exit code before continuing.

python3 ~/bin/hostbrid sites list --json > sites.json
jq . sites.json

printf '%s' '{}' | python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments @-

Authentication

A key with the permissions you need

Create a key in the panel and supply HOSTBRID_TOKEN to your process from a secrets manager. Keep it out of repositories, prompts and logs. New keys are read-only; additional permissions are granted separately. Revoke the key in the panel when you stop using it or if exposed.

Manage API keys →

API · CLI · MCP

Confirmations still apply

The CLI does not extend your key’s permissions or bypass server confirmations. Preparing a purchase does not pay for it: review and confirm payment in the panel. Deletions and other sensitive operations retain their previews and confirmation controls.