Skip to content

mcc tool

Browse and call catalog tools.

list

List all registered tools.

mcc tool list [-l]

Options:

Option Description
-l, --long Show full signatures instead of just keys

info

Print the full signature of a tool by key.

mcc tool info <tool-key>

Example:

mcc tool info admin.shell

call

Invoke a tool by key and print the result.

mcc tool call <tool-key> [key=value ...] [--json JSON]

Arguments:

Argument Description
tool-key Exact tool key (e.g. admin.shell, public.request)
key=value Parameters as positional key=value pairs (repeatable)
--json Parameters as a JSON object string

Examples:

mcc tool call admin.auth.users.list_users
mcc tool call admin.shell command="ls -la"
mcc tool call my.tool name=foo count=3
mcc tool call my.tool --json '{"name": "foo", "count": 3}'

Output is syntax-highlighted JSON for dicts and lists, plain text otherwise.

reindex

Reload tool YAML files from disk and reindex them in Elasticsearch (or OpenSearch). This is the only operation that ever touches the tool index — server startup and every other mcc command leave it untouched. It's a full rebuild (drop, recreate, bulk-write every tool), not an incremental update, so run it once after first standing up your search backend and again whenever your tool YAML changes.

mcc tool reindex