search_tools

Use search_tools when the task is clear but the tool name is unknown. Search by domain, inspect the match with get_tool, and note whether its schema takes workspace_id before calling it against a non-default workspace.

Parameters

Name	Type	Required	Default	Description
query	Annotated[str, Field(description="Natural-language description of what you want to accomplish (e.g. 'run a financial model', 'list branches').")]	Yes	—
domain	`Annotated[Domain	None, Field(description=“Optional domain to restrict the search to (e.g. ‘execution’, ‘models’, ‘data’).”)]`	No	None
limit	Annotated[int, Field(ge=1, le=5, description='Maximum number of tools to return. Defaults to 5.')]	No	5
cursor	`Annotated[str	None, Field(description=‘Opaque continuation cursor from a previous search_tools response.’)]`	No	None

Returns

Returns a structured object. Top-level fields:

• items (array<object>)
• total_count (integer)
• truncated (boolean)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "search_tools",
  "arguments": {
    "query": "write model output to Google Sheets",
    "domain": "google_sheets"
  }
}

Response

{
  "items": [
    {
      "name": "publish_run_output_to_google_sheet",
      "title": "Publish Run Output To Google Sheet",
      "domain": "google_sheets",
      "summary": "Publish a model run's output to a Google Sheet.",
      "score": 42.0,
      "read_only": false,
      "destructive": false,
      "required_role": null
    }
  ],
  "total_count": 1,
  "truncated": false
}

Notes

• Module: Tool Discovery
• Requires an authenticated Bridge Town session (OAuth) or an API token.