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.

Download and register MCP tools so they are available for tool run, tool call, tool info, and tool host add. Supports registry packages, versioned references, and local directories.

​
Synopsis

tool install <name[@version]|path> [...] [flags]

​
Arguments

​
<names>
string[]
required
One or more tool references to install. Each entry is either:
  • A registry reference: namespace/name or namespace/name@version
  • A local path: ./my-local-tool, ~/tools/custom, etc.
Multiple references can be provided in a single command.

​
Flags

​
--platform
string
Override automatic platform detection. Pass a platform identifier such as darwin-arm64, linux-x64, or win32-arm64 to force a specific bundle. Use universal to install the platform-agnostic bundle regardless of your system architecture.

​
Platform detection

When a tool has been published with multiple platform-specific bundles, tool install automatically selects the bundle that matches your operating system and CPU architecture (e.g., darwin-arm64 on Apple Silicon). If no exact match is found, it falls back to the universal bundle. Use --platform=universal to explicitly request the universal bundle, or specify a different target platform (useful when preparing packages for redistribution or testing).

​
Examples

# Install the latest version of a registry tool
tool install appcypher/bash

# Install a specific version
tool install appcypher/bash@1.0.0

# Install from a local directory
tool install ./my-local-tool

# Install from a path in your home directory
tool install ~/tools/custom

# Install multiple packages in one command
tool install ./local ns/a ns/b

# Install the universal bundle explicitly
tool install ns/tool --platform=universal
After installing, use tool host add <host> to register the tool with your AI client (Claude Desktop, Cursor, VS Code, etc.).
tool install does not download a file for you to keep — it installs the tool into tool-cli’s managed store. To download a bundle file to a specific directory without installing it, use tool download instead.

Build docs developers (and LLMs) love

Get started for freeTalk to us