HiveFlow MCP Server

Instructions

Implementation Reference

• src/index.js:609-628 (handler)

  The main handler function that implements the create_flow tool. It sends a POST request to the HiveFlow API to create a new workflow with the provided name, description, and optional nodes, then returns a success message with the created flow's ID and status.

  async createFlow(args) {
    const response = await this.hiveflowClient.post('/api/flows', {
      name: args.name,
      description: args.description,
      nodes: args.nodes || [],
      edges: [],
      status: 'draft'
    });
    
    const flow = response.data.data;
    
    return {
      content: [
        {
          type: 'text',
          text: `✅ Flujo "${args.name}" creado exitosamente.\nID: ${flow._id}\nEstado: ${flow.status}`
        }
      ]
    };
  }

• src/index.js:51-69 (schema)

  Input schema definition for the create_flow tool, specifying the expected arguments: required 'name' and 'description' strings, and optional 'nodes' array.

  inputSchema: {
    type: 'object',
    properties: {
      name: {
        type: 'string',
        description: 'Nombre del flujo'
      },
      description: {
        type: 'string',
        description: 'Descripción del flujo'
      },
      nodes: {
        type: 'array',
        description: 'Nodos del flujo (opcional)',
        items: { type: 'object' }
      }
    },
    required: ['name', 'description']
  }

• src/index.js:48-70 (registration)

  Registers the 'create_flow' tool in the ListToolsRequestSchema response, including its name, description, and input schema.

  {
    name: 'create_flow',
    description: 'Crea un nuevo flujo de trabajo en HiveFlow',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Nombre del flujo'
        },
        description: {
          type: 'string',
          description: 'Descripción del flujo'
        },
        nodes: {
          type: 'array',
          description: 'Nodos del flujo (opcional)',
          items: { type: 'object' }
        }
      },
      required: ['name', 'description']
    }
  },

• src/index.js:214-215 (registration)

  In the CallToolRequestSchema handler, dispatches calls to 'create_flow' by invoking the createFlow method.

  case 'create_flow':
    return await this.createFlow(args);