COMPOSIO_SEARCH_TOOLS
Tags: important, openWorldHint, readOnlyHint
Discovers the right tools across 500+ apps for a task and returns them with an execution plan, connection status, and the session_id that ties the rest of the workflow together.
When to use it
CallCOMPOSIO_SEARCH_TOOLS first, at the start of any task that touches an external app or service. Run it again whenever the user pivots to a new use case so you get a fresh session_id and a plan scoped to the new work.
Split a request into atomic queries (one query per tool call) and name the app in each query so intent stays scoped. The response tells you which toolkits already have an active connection and which need
COMPOSIO_MANAGE_CONNECTIONS.Input parameters
Structured English search queries to process in parallel. Split independent app/API actions into separate queries, including hidden prerequisites. Each query returns 4-6 tools.
Session context for correlating meta tool calls within a workflow. Always pass this parameter. Use {generate_id: true} for new workflows or {id: “EXISTING_ID”} to continue existing workflows.
Client LLM model name (recommended). Used to optimize planning/search behavior. Ignored if omitted or invalid.
Search path to use. Use auto normally. If the returned plan does not match the current request or an expected tool is missing, retry with tool_search to bypass cached plans and run direct tool search. Default:
auto. Possible values: auto, tool_search.Response
Error if any occurred during the execution. Format: “X out of Y searches failed, reasons: <details>”