FlowForge MCP Server

Professional MCP server that connects LLMs to FlowForge workflow automation platform.

Installation

npm install -g flowforge

Setup

1. Set your FlowForge API key:

export FLOWFORGE_API_KEY="ff_sk_your_api_key_here"
export FLOWFORGE_API_URL="http://localhost:8080"  # Optional, defaults to localhost

2. Run the MCP server:

flowforge-mcp

MCP Tools

Node Discovery

• flowforge_discover_nodes - Get available node types
• flowforge_get_node_schema - Get node configuration requirements
• flowforge_get_node_examples - Get real-world config examples

Workflow Operations

• flowforge_validate_workflow - Validate workflow before creation
• flowforge_test_workflow - Dry-run workflow execution
• flowforge_create_workflow - Create workflow from DSL
• flowforge_list_workflows - List existing workflows
• flowforge_manage_workflow - Update/delete/test workflows

Example Usage

Create E-commerce Workflow

LLM: Use flowforge_create_workflow with:
dsl: "webhook -> ai_agent -> slack"
configs: {
  "webhook": {"endpoint": "/orders"},
  "ai_agent": {
    "model": {"provider": "openai", "model_name": "gpt-4"},
    "prompt": {"system_prompt": "Sales analyst", "user_prompt": "Analyze: {{webhook.data}}"}
  },
  "slack": {"channel": "#sales", "message": "Order: {{ai_agent.output}}"}
}

Validate Before Creating

LLM: Use flowforge_validate_workflow to check configuration

Test Workflow

LLM: Use flowforge_test_workflow with sample data

Configuration

Required environment variables:

• FLOWFORGE_API_KEY - Your FlowForge API key
• FLOWFORGE_API_URL - FlowForge server URL (optional)

License

MIT