Skip to main content
The Toolshed CLI (toolshed) is the primary interface for working with a Toolshed server from your terminal. You use it to authenticate your local environment, execute TypeScript scripts against your role’s tool catalog, and start an MCP stdio server that AI agents like Claude or Cursor can connect to.

​
Installation

npm install -g @toolshed/cli
After installation, verify the binary is available: 
toolshed --version
# 0.0.1

​
Commands

login

Authenticate with the Toolshed server and save credentials to ~/.toolshed/config.json.

serve

Start the MCP stdio server so agents can connect and invoke your role’s tools.

run

Execute a TypeScript script in the configured runtime with full tool access.

​
Help output

Usage: toolshed [options] [command]

Toolshed CLI — execution layer for AI agents

Options:
  -V, --version   output the version number
  -h, --help      display help for command

Commands:
  login           Authenticate with the Toolshed server
  run <script>    Execute a TypeScript script in the sandbox
  serve           Start the MCP stdio server for agent connections
  help [command]  display help for command

​
Environment variables

Both serve and run respect the following environment variables. You can set them in your shell profile or prefix them on the command line.
VariableDescriptionDefault
TOOLSHED_SERVERURL of the Toolshed server to connect tohttp://localhost:3000
TOOLSHED_RUNTIMEExecution runtime: local or vercellocal
Set TOOLSHED_SERVER when you’re working against a remote or staging Toolshed server instead of a local instance.