Skip to content
Browse documentation
cli

Connect external tools

Let your agent use existing MCP tools through Smoothie, with a reviewed selection and per-session call limits.

Use your existing tools through Smoothie

Let your agent find and use tools from an MCP server you already run. Smoothie exposes only the tools you approve, with a call-attempt limit for each session.

This is optional. Connect the server directly to your agent if you do not need Smoothie's review, permissions, and discovery workflow. No Framework purchase is required.

1. Add a connection

Install and authenticate a local stdio MCP server first. Smoothie does not install it or manage its login. Add it to your project with a name such as github:

bash
smoothie mcp add github --project /absolute/my-product --interactive
smoothie mcp inspect --project /absolute/my-product --format json

Enter the executable's absolute path, arguments, working directory, and environment variable names—not secrets. Review the plan and type apply to save, or leave confirmation blank to cancel. Adding a connection does not start the server or approve tools.

Keep .smoothie/upstreams.local.json and its locks out of Git. For agent-driven setup without terminal prompts, use the automation options.

2. Review and approve tools

Copy the connection revision from inspect. Probe starts the server to list its tools; authorize its startup effects and credentials before running it. Without --run, it only plans.

bash
smoothie mcp probe github --project /absolute/my-product \
  --expect-revision <inspected-connection-revision> --save-review --run --format json
smoothie mcp review github --project /absolute/my-product --format json
smoothie mcp approve github --project /absolute/my-product --interactive

review reads the saved contracts offline, not live availability; they may contain sensitive metadata. approve selects nothing by default. Choose tools and a per-session limit, then confirm with apply. This replaces the previous selection. Changed contracts require fresh review and approval.

3. Connect your agent

bash
smoothie mcp serve --project /absolute/my-product --approved github

Follow agent setup to launch this command. Repeat --approved for more connections; do not mix it with manual registry, grant, or allowance flags.

Ask your agent to check connection_status for availability and remaining calls. For how tools are found and called, see Context and tool discovery.

Remove access

bash
smoothie mcp revoke github --project /absolute/my-product --format json

This only previews removal. Apply with --run --expect-plan and the returned data.planDigest. Success blocks later calls using this saved approval, including in existing sessions. It does not stop processes, undo sent calls, or remove manual grants. A failed revocation is not confirmed removal.

To restore access, review and approve again, then start a new session. Smoothie does not automatically reconnect or retry calls. See Tools and permissions for shared limits.