search_tools

Use search_tools when the task is clear but the tool name is unknown

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

Returns

Returns a structured object. Top-level fields:

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

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": "skills"
  }
}

Response

{
  "items": [],
  "total_count": 0,
  "truncated": false,
  "skill_matches": [
    {
      "name": "bridge-town-gsheet-formatting",
      "title": "Bridge Town Gsheet Formatting",
      "description": "Use whenever a Bridge Town agent is about to write model output to Google Sheets.",
      "resource_uri": "skill://bridge-town-gsheet-formatting",
      "related_tools": [
        "write_gsheet",
        "format_gsheet",
        "modify_gsheet_structure",
        "ingest_data_source"
      ],
      "next_action": "get_skill(name='bridge-town-gsheet-formatting', include_template=true)"
    }
  ]
}

Notes

• Module: Tool Discovery
• Requires authentication via API token or Auth0 JWT.