Search tools
Cross-entity find-by-name — locate a workflow, chart, dashboard, or dataset by keyword, then fetch it with the matching get tool.
1 tool. Each is callable over MCP with a Bearer agx_ key that holds the required scope. The catalog is public (tools/list isn't scope-filtered); the scope below is enforced when the tool is called (tools/call) — a key without it is refused (default-deny).
search
Find a workflow, chart, dashboard, or dataset BY NAME OR KEYWORD (case-insensitive substring match) — use this instead of list_workflows/list_charts/list_dashboards/list_datasets whenever you're looking for one SPECIFIC item rather than browsing everything; those list tools return every row and can truncate on a large org. Returns compact hits (id, type, name) — follow up with get_workflow/get_chart/get_dashboard/get_dataset using the id to fetch full detail. Only types you have access to are searched (requires workflows:read and/or analytics:read).
Required scope: search:read
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | ✓ | Name or keyword to search for. |
types | array<enum(workflow, chart, dashboard, dataset)> | Optional: narrow the search to specific artifact types. Default: all. |
Example
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"q": "acme"
}
}
}