Browse the docs

Call MCP tool

Calls a tool on an MCP server and stores what it returns.

Call tool on server

Details #

The step names an MCP server and one of its tools, passes args as the tool's arguments, and stores the result in into.

This is the opposite direction from Switchboard's own MCP server, which lets an AI agent run your macros.

Parameters #

ParameterTypeRequiredValuesWhat it does
servertextYesRequired. The name of the MCP server.
tooltextYesRequired. The tool's name on that server.
argsrecordAn object of arguments for the tool.
intotextThe variable that would receive the result.
sampleany valueWhat into holds during a dry run.

Every step also accepts label, onFailure, timeout and dryRunSafe.

Examples #

Shape of an MCP call (not runnable yet)
Do
  1. Call search on notes
Open in Switchboard to try it

Gotchas #

  • Dry run. Nothing is called. into gets sample, or an empty string, so later steps still have a value.

  • Until it is available, use Send HTTP request or Run shell script to reach a tool.

See also #

Send HTTP request, Run shell script