Control tools

Learn the nine permanently loaded agent-facing control tools.

View Markdown

The MCP surface is exactly nine control tools. They are the stable interface over a catalog that can grow independently:

ToolPurposeCharges money?
search_toolsFind a provider-neutral job and its catalog tools.No
inspect_toolRead one selected catalog tool's live contract.No
run_toolExecute one catalog tool and settle its charge.Yes
get_runRead an existing run, its result, artifacts and cost.No
get_walletRead balance, holds and available spend.No
list_appsCheck which human-connected apps are available and ready.No
get_filesList files, renew reference URLs and check storage usage.No
upload_fileImport a reference or prepare a browser/CLI upload.No
delete_filePermanently delete an authorised workspace file.No

The normal loop

code
search_tools → inspect_tool → list_apps (when relevant) → run_tool → get_run → get_wallet

Use tool_id returned by search_tools for inspection and execution, and the returned run_id for retrieval. The retired MCP and CLI names are not aliases. HTTP keeps resource paths; see transports.

What is not a control tool

Categories, capabilities, providers and catalog tools are catalog data. list_apps reports readiness, but connection approval and management remain human dashboard actions. Skills are agent-side recipes. None becomes another MCP tool.

Check list_apps when a workflow depends on a connected account, start with search_tools for catalog work, or follow the manual tool walkthrough when you need the explicit sequence.

Control tools — Scrollport