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.

Register installed tools with MCP host applications. Instead of manually editing each app’s JSON config, tool host writes the correct entries for you — and creates a backup before touching anything.

​
Subcommands

SubcommandAliasDescription
tool host addaRegister tools with a host
tool host removerRemove tools from a host
tool host listlList supported hosts and their status
tool host previewpPreview the config that would be written
tool host path—Print the config file path for a host

​
Supported hosts

claude-desktop

Aliases: claudedesktop, cd

cursor

Alias: cursor

claude-code

Aliases: claudecode, cc

vscode

Aliases: vs-code, vsc, code

codex

Alias: codex

windsurf

Alias: windsurf

zed

Alias: zed

gemini-cli

Aliases: geminicli, gemini

kiro

Alias: kiro

roo-code

Aliases: roocode, roo

opencode

Aliases: open-code, oc
Run tool host list to see all supported hosts and whether their config file currently exists on your machine.

​
tool host add

Register tools with a host application. By default, registers all installed tools. Pass specific tool references to register only those. 
tool host add <host> [tools]... [options]

​
Arguments

​
host
string
required
Target host name (e.g., claude-desktop, cursor, vscode). Aliases are accepted.
​
tools
string
One or more tool references to register. If omitted, all installed tools are registered.

​
Options

​
--dry-run
boolean
Preview the changes that would be made without modifying any files.
​
--overwrite
boolean
Overwrite existing entries for these tools if they are already present in the host config.
​
-y, --yes
boolean
Skip the confirmation prompt.

​
Examples

# Register all installed tools with Claude Desktop
tool host add claude-desktop

# Register a specific tool
tool host add claude-desktop appcypher/bash

# Register a tool with Cursor
tool host add cursor appcypher/bash

# Preview what would change (no files modified)
tool host add vscode --dry-run

# Overwrite existing entries
tool host add claude-code --overwrite

# Skip confirmation
tool host add claude-desktop -y
The command creates a timestamped backup of the host’s config file before making any changes, so your original config is always safe to restore.

​
tool host remove

Remove tool entries from a host’s config. By default, removes all entries that were added by tool-cli. Pass specific tool references to remove only those. 
tool host remove <host> [tools]... [options]

​
Arguments

​
host
string
required
Target host name.
​
tools
string
One or more tool references to remove. If omitted, all tool-cli managed entries are removed.

​
Options

​
--dry-run
boolean
Preview the changes without modifying any files.
​
-y, --yes
boolean
Skip the confirmation prompt.

​
Examples

# Remove all tool-cli managed tools from Claude Desktop
tool host remove claude-desktop

# Remove a specific tool
tool host remove claude-desktop appcypher/bash

# Preview removal without modifying files
tool host remove cursor --dry-run

# Remove without confirmation
tool host remove vscode -y

​
tool host list

List all supported hosts and whether their config file exists on the current machine. Pass a host name to show which tools are registered with that host. 
tool host list [host]

​
Arguments

​
host
string
A specific host to inspect. When provided, shows the tools registered with that host.

​
Examples

# List all supported hosts and their status
tool host list

# Show tools registered with a specific host
tool host list claude-desktop

​
tool host preview

Preview the MCP server config entries that would be written to a host’s config file, without making any changes. 
tool host preview <host> [tools]...

​
Arguments

​
host
string
required
Target host name.
​
tools
string
Specific tools to preview. If omitted, all installed tools are previewed.

​
Examples

# Preview config for all installed tools
tool host preview claude-desktop

# Preview config for a specific tool
tool host preview cursor appcypher/bash

​
tool host path

Print the absolute path to the config file for a given host. Useful for scripts or when you need to inspect the file directly. 
tool host path <host>

​
Arguments

​
host
string
required
Target host name.

​
Examples

# Print the Claude Desktop config path
tool host path claude-desktop

# Print the Cursor config path
tool host path cursor

Build docs developers (and LLMs) love

Get started for freeTalk to us