Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/superradcompany/tool-cli/llms.txt

Use this file to discover all available pages before exploring further.

Search the registry

Use tool search to find MCP tools by keyword. Results include names, descriptions, and download counts.
tool search filesystem       # find file-related tools
tool search weather          # find weather tools
tool search "database sql"   # multi-word search
tool search bash -c          # concise output for scripts

Preview before installing

Inspect a tool from the registry without downloading it. This lets you see its available methods, input/output schemas, and description before committing to an install.
tool preview appcypher/bash          # preview tool from registry
tool preview appcypher/bash@1.0.0    # preview specific version
tool preview ns/tool -m exec         # show specific method details
tool preview ns/tool --tools         # list tools only
tool preview ns/tool --json          # JSON output for parsing
tool preview ns/tool -c              # concise output

Discovery to install flow

1

Search for a tool

Start by searching the registry for tools that match your use case.
tool search filesystem
2

Preview a candidate

Inspect a tool before installing to understand what it exposes.
tool preview appcypher/bash
To drill into a specific method:
tool preview appcypher/bash -m exec
3

Install the tool

Install once you’re ready. The CLI resolves the right bundle for your platform automatically.
tool install appcypher/bash
4

Verify the install

List installed tools to confirm it’s there.
tool list

Install tools

Install from the registry by namespace/name, with an optional version pin. You can also install from a local path.
tool install appcypher/bash              # install from registry (latest)
tool install appcypher/bash@1.0.0        # install specific version
tool install ./my-local-tool             # install from local directory
tool install ~/tools/custom              # install from home directory
tool install ./local ns/a ns/b           # install multiple packages
tool install ns/tool --platform=universal # install universal bundle
tool install auto-detects your OS and architecture (e.g. darwin-arm64 on Apple Silicon) and downloads the matching bundle. Pass --platform to override this behavior.

List installed tools

tool list                  # list all installed tools
tool list bash             # filter by name pattern
tool list -c               # concise output for scripts
tool list --full           # include tools, prompts, resources
tool list --json           # JSON output for parsing

Uninstall tools

tool uninstall appcypher/bash     # remove installed tool
tool uninstall my-local-tool      # remove local tool
tool uninstall tool1 tool2 tool3  # remove multiple tools
tool uninstall --all              # remove all installed tools
tool uninstall --all -y           # remove all without confirmation

Download without installing

Use tool download to fetch a bundle to disk without adding it to your installed tools. Useful for inspecting bundles, caching, or CI pipelines.
tool download appcypher/bash                   # download to current dir
tool download appcypher/bash@1.0.0             # download specific version
tool download ns/a ns/b ns/c                   # download multiple packages
tool download ns/tool -o ./dist                # download to specific directory
tool download ns/tool --platform=darwin-arm64  # download for specific platform
tool download ns/tool --platform=universal     # download universal bundle

Build docs developers (and LLMs) love