Skip to content

Quick Start

devlomingo edited this page Nov 16, 2026 · 1 revision

Quick start

1. Try the demo (one minute)

npm install -g toolsmith-mcp
toolsmith-mcp demo

Needs Node.js 22.13 or newer. The demo uses a bundled shop API and walks through the whole lifecycle:

  1. imports the API's spec and verifies every read operation;
  2. approves it read-only;
  3. simulates an agent doing the same workflow several times;
  4. discovers the workflow and proposes a composite tool;
  5. checks the composite returns identical results, then publishes it;
  6. leaves the gateway and the dashboard running for you to explore.

Nothing is written outside a temporary directory.

2. Use your own API

mkdir my-tools && cd my-tools
toolsmith-mcp init        # writes toolsmith.config.json and .env with fresh tokens
toolsmith-mcp import https://petstore3.swagger.io/api/v3/openapi.json --name petstore
toolsmith-mcp show petstore     # review what was generated
toolsmith-mcp approve petstore  # read-only tools go live

3. Connect your agent

toolsmith-mcp client-config

prints the snippet for your MCP client with the real config path. See Connect Your Client for Claude Desktop, Claude Code, Cursor and VS Code.

4. Let it learn

Use your agent normally. When a workflow has repeated in at least 3 sessions:

toolsmith-mcp patterns    # what it found
toolsmith-mcp discover    # propose and evaluate composite tools
toolsmith-mcp approve flow-get-user-orders-details \
  --description "Use when the user asks about a customer's orders or payments."

Or do all of this in the dashboard: toolsmith-mcp start prints a sign-in link.

Next: Composite Tools explains what gets discovered and why it is safe.

Clone this wiki locally