Repository navigation
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-configIn every example below, replace /absolute/path/to/toolsmith.config.json
with the file toolsmith-mcp init created.
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 mcp add toolsmith -- toolsmith-mcp start --stdio --config /absolute/path/to/toolsmith.config.jsonAdd the same mcpServers block as Claude Desktop to ~/.cursor/mcp.json
(all projects) or .cursor/mcp.json (one project).
In .vscode/mcp.json:
{
"servers": {
"toolsmith": {
"type": "stdio",
"command": "toolsmith-mcp",
"args": ["start", "--stdio", "--config", "/absolute/path/to/toolsmith.config.json"]
}
}
}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.
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.
| 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.
toolsmith-mcp · MIT · Repository · Report an issue · Changelog
Getting started
Using it
Operating it
Links