Skip to content

Connect Your Client

devlomingo edited this page Nov 16, 2026 · 1 revision

Connect your client

Toolsmith is a standard MCP server. Any client that speaks MCP over stdio or Streamable HTTP works. Run this to get snippets with your real paths:

toolsmith-mcp client-config

In every example below, replace /absolute/path/to/toolsmith.config.json with the file toolsmith-mcp init created.

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "mcpServers": {
    "toolsmith": {
      "command": "toolsmith-mcp",
      "args": ["start", "--stdio", "--config", "/absolute/path/to/toolsmith.config.json"]
    }
  }
}

Restart Claude Desktop.

Claude Code

claude mcp add toolsmith -- toolsmith-mcp start --stdio --config /absolute/path/to/toolsmith.config.json

Cursor

Add the same mcpServers block as Claude Desktop to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "toolsmith": {
      "type": "stdio",
      "command": "toolsmith-mcp",
      "args": ["start", "--stdio", "--config", "/absolute/path/to/toolsmith.config.json"]
    }
  }
}

Over HTTP (shared gateway)

Run toolsmith-mcp start, then point the client at the endpoint with the token from .env:

{
  "mcpServers": {
    "toolsmith": {
      "type": "http",
      "url": "http://127.0.0.1:7420/mcp",
      "headers": { "Authorization": "Bearer <TOOLSMITH_MCP_TOKEN from .env>" }
    }
  }
}

With OAuth configured, clients that support the MCP authorization spec sign in on their own and need only the URL. See Team Deployment.

Tip: group an agent's calls

Workflow discovery works best when it knows which calls belong to one run. Over HTTP, send a stable header per agent run:

X-Toolsmith-Session: <anything stable per agent run>

It only groups traces; it never changes what a client may do. Over stdio, each process is already one session.

What the agent sees

Tool Comes from
<integration>__<operation> Approved operations of an imported API
<upstream>__<tool> Tools of another MCP server you aggregate
flow__<name> Approved composite tools
toolsmith__request_capability Ask whether something not covered is possible
toolsmith__search_tools Find tools by description in large catalogs

A tool approved in the dashboard or CLI appears in running sessions within about 2 seconds.

Full details: MCP-INTEGRATION.md.

Clone this wiki locally