execute_workflow
Run automated workflows in Folderr by providing workflow ID and required inputs to trigger predefined processes.
Instructions
Execute a workflow with the required inputs
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workflow_id | Yes | ID of the workflow | |
| inputs | Yes | Input values required by the workflow |
Implementation Reference
- src/index.ts:442-471 (handler)The handler function that checks authentication, makes a POST request to /api/workflows/api-client/{workflow_id} with inputs, and returns the response or error.
private async handleExecuteWorkflow(args: any) { if (!this.config.token) { throw new McpError(ErrorCode.InvalidRequest, 'Not logged in'); } try { const response = await this.axiosInstance.post( `/api/workflows/api-client/${args.workflow_id}`, args.inputs ); return { content: [ { type: 'text', text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error: any) { return { content: [ { type: 'text', text: `Failed to execute workflow: ${error.response?.data?.message || error.message}`, }, ], isError: true, }; } } - src/index.ts:193-211 (schema)The input schema for the execute_workflow tool, defining workflow_id and inputs as required parameters.
{ name: 'execute_workflow', description: 'Execute a workflow with the required inputs', inputSchema: { type: 'object', properties: { workflow_id: { type: 'string', description: 'ID of the workflow', }, inputs: { type: 'object', description: 'Input values required by the workflow', additionalProperties: true, }, }, required: ['workflow_id', 'inputs'], }, }, - src/index.ts:229-230 (registration)The switch case in CallToolRequestSchema handler that dispatches execute_workflow calls to the handleExecuteWorkflow method.
case 'execute_workflow': return await this.handleExecuteWorkflow(request.params.arguments); - src/index.ts:109-213 (registration)The ListToolsRequestSchema handler that registers the execute_workflow tool by including it in the tools list.
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ { name: 'set_api_token', description: 'Set an API token for authentication (alternative to login)', inputSchema: { type: 'object', properties: { token: { type: 'string', description: 'API token generated from Folderr developers section', }, }, required: ['token'], }, }, { name: 'login', description: 'Login to Folderr with email and password', inputSchema: { type: 'object', properties: { email: { type: 'string', description: 'User email', }, password: { type: 'string', description: 'User password', }, }, required: ['email', 'password'], }, }, { name: 'list_assistants', description: 'List all available assistants', inputSchema: { type: 'object', properties: {}, required: [], }, }, { name: 'ask_assistant', description: 'Ask a question to a specific assistant', inputSchema: { type: 'object', properties: { assistant_id: { type: 'string', description: 'ID of the assistant to ask', }, question: { type: 'string', description: 'Question to ask the assistant', }, }, required: ['assistant_id', 'question'], }, }, { name: 'list_workflows', description: 'List all available workflows', inputSchema: { type: 'object', properties: {}, required: [], }, }, { name: 'get_workflow_inputs', description: 'Get the required inputs for a workflow', inputSchema: { type: 'object', properties: { workflow_id: { type: 'string', description: 'ID of the workflow', }, }, required: ['workflow_id'], }, }, { name: 'execute_workflow', description: 'Execute a workflow with the required inputs', inputSchema: { type: 'object', properties: { workflow_id: { type: 'string', description: 'ID of the workflow', }, inputs: { type: 'object', description: 'Input values required by the workflow', additionalProperties: true, }, }, required: ['workflow_id', 'inputs'], }, }, ], }));