Skip to content

CLI Reference

devlomingo edited this page Nov 16, 2026 · 1 revision

CLI reference

All commands accept --config <path> to use a config other than ./toolsmith.config.json. NO_COLOR disables colored output.

Get started

Command What it does
toolsmith-mcp demo Run the whole lifecycle against a bundled demo API
toolsmith-mcp init Create toolsmith.config.json and .env with fresh tokens
toolsmith-mcp import <spec> --name <n> Turn a spec (file or URL) into tools
toolsmith-mcp start [--host H] [--port P] Run the gateway (HTTP + dashboard)
toolsmith-mcp start --stdio Run as a stdio MCP server, for desktop clients
toolsmith-mcp client-config Print config snippets for MCP clients
toolsmith-mcp doctor Check configuration, credentials and connectivity

Review and approve

Command What it does
list Integrations, composites and their status
show <name> Generated tools, findings and evaluation results (--json for full schemas)
evaluate <name> [--input JSON] [--no-live] Re-run evaluation, optionally with an example input
approve <name>[@v] [--allow-writes] [--allow-destructive] [--description "Use when …"] Approve a version
reject, publish, disable, enable, rollback <name>[@v] Manage versions
approve-call <id>, reject-call <id> Decide a pending destructive call

Commands that grant access (approve, approve-call, publish, enable, rollback) ask you to type yes and refuse to run without an interactive terminal. Use the dashboard for remote approval.

Discover

Command What it does
patterns Repeated workflows found in traces
discover Propose composite tools from those patterns
ask "<what you need>" Check whether the connected APIs can do it
traces [--tool <name>] [--limit N] Recent tool calls
usage How much published composites are used and what they save

Import flags

Flag Meaning
--base-url <url> API base URL when the spec has none
--token-env NAME Bearer token from an environment variable
--api-key-env NAME [--api-key-header H] API key from an environment variable
--allow-private-network Allow localhost and private addresses for this integration
--no-live Skip live verification of read operations

Clone this wiki locally