search_workflows
Find workflow executions using advanced query syntax with multiple criteria. Supports pagination and sorting for efficient troubleshooting and management.
Instructions
Advanced search for workflow executions using query syntax. Supports complex queries with multiple criteria.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED') | |
| start | No | Start index for pagination (default: 0) | |
| size | No | Number of results to return (default: 100) | |
| sort | No | Sort field and order (e.g., 'startTime:DESC') |
Implementation Reference
- src/index.ts:592-613 (handler)Handler implementation for the 'search_workflows' tool. It destructures the input arguments, builds query parameters including query, start, size, and optional sort, makes an API call to Conductor's /workflow/search-v2 endpoint, and returns the response as formatted JSON text content.case "search_workflows": { const { query, start = 0, size = 100, sort } = args as any; const params: any = { start, size, query, }; if (sort) params.sort = sort; const response = await conductorClient.get("/workflow/search-v2", { params }); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; }
- src/index.ts:207-228 (schema)Input schema definition for the 'search_workflows' tool, specifying the expected parameters: required 'query' string and optional pagination/sort parameters.inputSchema: { type: "object", properties: { query: { type: "string", description: "Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED')", }, start: { type: "number", description: "Start index for pagination (default: 0)", }, size: { type: "number", description: "Number of results to return (default: 100)", }, sort: { type: "string", description: "Sort field and order (e.g., 'startTime:DESC')", }, }, required: ["query"], },
- src/index.ts:203-229 (registration)Registration of the 'search_workflows' tool in the global tools array used for listing available tools via MCP protocol.{ name: "search_workflows", description: "Advanced search for workflow executions using query syntax. Supports complex queries with multiple criteria.", inputSchema: { type: "object", properties: { query: { type: "string", description: "Query string (e.g., 'workflowType=MyWorkflow AND status=FAILED')", }, start: { type: "number", description: "Start index for pagination (default: 0)", }, size: { type: "number", description: "Number of results to return (default: 100)", }, sort: { type: "string", description: "Sort field and order (e.g., 'startTime:DESC')", }, }, required: ["query"], }, },