Repository navigation
CLI Reference
devlomingo edited this page Nov 16, 2026
·
1 revision
All commands accept --config <path> to use a config other than
./toolsmith.config.json. NO_COLOR disables colored output.
| 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 |
| 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.
| 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 |
| 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 |
toolsmith-mcp · MIT · Repository · Report an issue · Changelog
Getting started
Using it
Operating it
Links