scenario_tools_search
ManagementSearch Tool Catalog
Search the Scenario MCP tool catalog by keyword — find tools by name or purpose and get their executable input schemas.
Searches tool metadata, NOT platform content. To find models, assets, images, or workflows, use search instead.
Use this tool when:
- No visible tool fits the task (hosts may trim the active set or omit full schemas — the catalog is always complete)
- You need a tool's executable JSON input schema
- You need to know which executor runs a tool
Args:
- query: required — natural-language keywords (e.g. "delete api key", "wait for jobs")
- limit: optional — max matching tools, 1-20 (default 8)
Returns: { query, results } — each result carries name, title, permission (read | write | delete), description, inputSchema (identical to tools/list), and annotations. Run a result via the executor matching its permission: scenario_tool_execute_read, scenario_tool_execute_write, or scenario_tool_execute_delete, with parameters matching inputSchema.
Examples:
- "How do I revoke an API key?" -> query="delete api key"
- "Wait for generations to finish" -> query="wait for jobs"
Don't use when: the tool is already visible top-level — call it directly; or you want platform content — use search.
read-onlyidempotent
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | ✓ | Natural-language keywords describing the operation to find (e.g. "delete api key", "wait for jobs"). |
| limit | number | 8 | Maximum number of matching tools to return (1-20). |