Workflow MCP Server

The Workflow MCP Server allows published Flowgear Workflows to be exposed as MCP tools.

This works well for two broad categories of scenarios:

Utility Workflows - perform a specific task such as approving a purchase order, listing service tickets or updating the status of a record.
Exploratory Workflows - allow an AI agent to progressively find the data it needs by creating three MCP tool workflows - one to list available entities (e.g. tables), one to obtain the structure of an entity (e.g. fields) and one to run a query.

To use the Workflow MCP Server tools, register the Workflow MCP Server at https://your-environment-hostname.flowgear.net/mcp, where your-environment-hostname is the subdomain of the Environment you want to target.

Steps

Create an MCP Tool Workflow

Create a new v2 Workflow.
Click + to add a Step, choose the MCP Node, and then McpReceive method. Provide a tool name in the ToolName property.
Click + to add a Step, choose the MCP Node, and then McpRespond method.
Add Steps between the receive and respond Steps.
Adjust the receive and respond step schemas by clicking ... on the step, and choosing Edit Properties. Edit as desired.
Save the Workflow.

Here's a simple example MCP Tool Workflow. Use it from the Workflow screen by clicking Code, and then pasting this content.

Steps:
  - Name: "mcpreceive"
    Description: "Waits for an MCP tool invocation."
    Node: "v2.Mcp@0.0.0.13"
    Method: "McpReceive"
    Parameters:
      ToolName:
        Type: "string"
        Value: "hello_world"
    Returns:
      Method:
        Type: "string"
      Uri:
        Type: "string"
      Headers:
        Type: "object"
      Parameters:
        Type: "object"
      Body:
        Type: "stream"
      Tool:
        Type: "string"
      Arguments:
        Type: "object"
  - Name: "mcprespond"
    Description: "Writes an MCP response for the active request."
    Node: "v2.Mcp@0.0.0.13"
    Method: "McpRespond"
    Parameters:
      StatusCode:
        Type: "number"
      Headers:
        Type: "object"
      Body:
        Type: "object"
        Properties:
          response:
            Type: "string"
            Value: "hello world!"

Enable the Workflow and Configure Access

After saving the Workflow (and publishing it to the correct Environment if you're using Release Management), click <- to go to the landing pane. Choose Workflow Status and tick the checkbox against the Environment you want to enable the Workflow for (e.g. Test).
Create a Delegated MCP User Key by going to API Keys, and then New API Key. Choose Delegated MCP User for API Key Type.
Provide a name for the key, choose the correct Environment, choose the list of users who should be able to run the Workflow from the Permitted Users list, and choose the list of Workflows (i.e. the one you just created) from the Assigned Workflows list.
Click Save.
Follow the steps at Connect Flowgear MCP to Claude or Connect Flowgear MCP to ChatGPT to start using the MCP Tool.

Workflow MCP Server

Steps

Create an MCP Tool Workflow

Enable the Workflow and Configure Access

See also