# kindgi tools

> Manage tool registrations

## `kindgi tools`

**Synopsis**

```sh signature
kindgi tools <command>
```

Manage tool registrations.

**Commands**

| Command                                                                                                      | Description                                                                                               |
| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| [`kindgi tools list`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-list)               | List registered tools.                                                                                    |
| [`kindgi tools get`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-get)                 | Fetch the latest active version of a tool.                                                                |
| [`kindgi tools publish`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-publish)         | Register a tool manifest at its version: the tool minus its handler, which the runtime must already have. |
| [`kindgi tools unregister`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-unregister)   | Unregister a specific tool version (semver); `kindgi tools reinstate` brings it back.                     |
| [`kindgi tools versions`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-versions)       | List published versions of a tool (active, and optionally unregistered).                                  |
| [`kindgi tools get-version`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-get-version) | Fetch a specific tool version by exact semver.                                                            |
| [`kindgi tools reinstate`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools-reinstate)     | Bring back an unregistered tool version (semver).                                                         |

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)

### `kindgi tools list`

**Synopsis**

```sh signature
kindgi tools list [--name=<prefix>] [--include-retired] [--limit=<n>] [--cursor=<c>]
```

List registered tools.

**Options**

| Option              | Default              | Description                                                                                            |
| ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------ |
| `--cursor <value>`  | none                 | Resume after this cursor, from the previous page's `nextCursor`.                                       |
| `--include-retired` | off                  | Include retired tools (every version unregistered), each as its highest version with `unregisteredAt`. |
| `--limit <value>`   | `25` (at most `100`) | The most tools to return (default 25, at most 100).                                                    |
| `--name <value>`    | none                 | Only the tools whose id starts with this prefix.                                                       |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

From [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md):

```sh
npx --yes @kindgi/cli@0.1 tools list --url "$URL"   # your pack's tools
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools get`

**Synopsis**

```sh signature
kindgi tools get <tool-id>
```

Fetch the latest active version of a tool.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

From [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md):

```sh
pnpm exec kindgi tools get inventory.stock_level
```

**See also**

- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools publish`

**Synopsis**

```sh signature
kindgi tools publish --manifest=<json-or-@file> [--project=<project-id>]
```

Register a tool manifest at its version: the tool minus its handler, which the runtime must already have.

**Options**

| Option               | Default                      | Description                                                                         |
| -------------------- | ---------------------------- | ----------------------------------------------------------------------------------- |
| `--manifest <value>` | required                     | The tool manifest as JSON, or `@<file>` to read it from a file. Required.           |
| `--project <value>`  | the tenant's Default project | The project to register the tool in, by id (default: the tenant's Default project). |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

Register a tool from a manifest file in the default project.

```sh
kindgi tools publish --manifest=@tools/acme.stock-level.json
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools unregister`

**Synopsis**

```sh signature
kindgi tools unregister <tool-id> <version>
```

Unregister a specific tool version (semver); `kindgi tools reinstate` brings it back.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

Unregister one version of a tool.

```sh
kindgi tools unregister acme.stock-level 0.1.0
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools versions`

**Synopsis**

```sh signature
kindgi tools versions <tool-id> [--include-unregistered] [--limit=<n>] [--cursor=<c>]
```

List published versions of a tool (active, and optionally unregistered).

**Options**

| Option                   | Default              | Description                                                        |
| ------------------------ | -------------------- | ------------------------------------------------------------------ |
| `--cursor <value>`       | none                 | Resume after this cursor, from the previous page's `nextCursor`.   |
| `--include-unregistered` | off                  | Include unregistered versions too, each with its `unregisteredAt`. |
| `--limit <value>`        | `25` (at most `100`) | The most versions to return (default 25, at most 100).             |

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

List a tool's versions, unregistered ones too.

```sh
kindgi tools versions acme.stock-level --include-unregistered
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools get-version`

**Synopsis**

```sh signature
kindgi tools get-version <tool-id> <version>
```

Fetch a specific tool version by exact semver.

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

Fetch one exact version of a tool.

```sh
kindgi tools get-version acme.stock-level 0.1.0
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)

### `kindgi tools reinstate`

**Synopsis**

```sh signature
kindgi tools reinstate <tool-id> <version>
```

Bring back an unregistered tool version (semver).

**Options**

Every command also takes the [global flags](https://docs.kindgi.com/v0.1.8/reference/cli.md#global-flags).

**Examples**

Bring back an unregistered tool version.

```sh
kindgi tools reinstate acme.stock-level 0.1.0
```

**See also**

- [Deploy on Azure Container Apps](https://docs.kindgi.com/v0.1.8/deploy/azure-container-apps.md)
- [Deploy on Google Cloud Run](https://docs.kindgi.com/v0.1.8/deploy/cloud-run.md)
- [Use an MCP server's tools](https://docs.kindgi.com/v0.1.8/guides/tools/mcp-servers.md)
- [`kindgi tools`](https://docs.kindgi.com/v0.1.8/reference/cli/tools.md#kindgi-tools)