search_tools

Search the Bridge Town MCP tool catalog with ranked, in-process matching. Use this when you know the task you want to do but not the exact tool name. Ranking combines tool name, description, domain tag, and curated aliases so queries like ‘export data to sheets’ or ‘approve merge request’ surface the best matching tools first. Optional domain narrows results to a specific tool area such as google_sheets, data, pull_requests, or templates. Returns: list[{name (str) — MCP tool name; description (str) — tool summary; domain (str) — canonical tool domain; score (float) — relative relevance score, higher is better}] ordered from highest to lowest relevance.

Parameters

Name	Type	Required	Default	Description
query	str	Yes	—
domain	`str	None`	No	None
limit	int	No	10

Returns

Returns a JSON array of objects with keys: name, description, score. See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "search_tools",
  "arguments": {
    "query": "create dashboard",
    "limit": 5
  }
}

Response

[
  {
    "name": "create_dashboard",
    "description": "Create or update a saved dashboard for a Bridge Town project.",
    "score": 0.92
  },
  {
    "name": "list_chart_types",
    "description": "List supported chart types for create_dashboard.",
    "score": 0.51
  }
]

Notes

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