# Tool

URL: https://docs.hanzo.ai/docs/cli/tool

> The `hanzo tool` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/tool) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/tool) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Everything your org can call, in one list: connector actions, functions, agents, skills and your own MCP servers.

[API reference →](https://docs.hanzo.ai/docs/openapi/tool)

```bash
hanzo tool skills list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command           | What it does                                                                                                           |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `hanzo tool call` | Runs one of the caller's activated tools and answers with its output.                                                  |
| `hanzo tool get`  | Lists every tool the caller's org and project can reach, from every source, each flagged with whether it is activated. |

### Activation

| Command                         | What it does                                                                                              |
| ------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `hanzo tool activation get`     | Reports which tools are switched on for the caller's org and project.                                     |
| `hanzo tool activation replace` | Switches tools on and off for the caller's org and project, and answers with the resulting activated set. |

### Catalog

| Command                       | What it does                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo tool catalog get <id>` | Returns one catalog entry in full: the publisher's description, its repository and site, every package form with the runtime that launches it, and every hosted endpoint. |
| `hanzo tool catalog list`     | Lists the MCP servers the public registries publish, as we hold them: our canonical copy of registry.modelcontextprotocol.io, plus what we decided about each entry.      |

### MCP

| Command                          | What it does                                                                                                            |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `hanzo tool mcp servers create`  | Gives the caller's org one more external MCP server, so its tools join the org's tool plane and the fleet's MCP server. |
| `hanzo tool mcp servers list`    | Lists the external MCP servers the caller's org has registered.                                                         |
| `hanzo tool mcp servers rm <id>` | Deregisters one of the caller org's external MCP servers, so its tools leave the registry.                              |

### Plugins

| Command                               | What it does                                                                                                                |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `hanzo tool plugins authored list`    | Lists the plugins the caller's org BUILT, newest first, each with the TypeScript as authored.                               |
| `hanzo tool plugins authored rm <id>` | Removes one of the caller org's built plugins, so the runtime can no longer load it.                                        |
| `hanzo tool plugins build`            | Builds and stores one plugin for the caller's org.                                                                          |
| `hanzo tool plugins get`              | Reports what this deployment actually mounted: every subsystem the composition root declared and whether it is switched on. |

### Skills

| Command                      | What it does                                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo tool skills authored` | Lists the caller org's OWN skills with their SKILL.md bodies.                                                                                    |
| `hanzo tool skills create`   | Adds or revises one of the caller org's own skills, and answers 201 with the stored record.                                                      |
| `hanzo tool skills list`     | Lists the skills the caller's org can reach — the brand's embedded catalogue plus the org's own authored ones — with each one's activation flag. |
| `hanzo tool skills rm <id>`  | Removes one of the caller org's authored skills.                                                                                                 |