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, then McpReceive method. Provide a tool name in the ToolName property.
Click + to add a Step, choose the MCP Node, 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
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 Delegatd MCP User Key by going to API Keys, New API Key, choose Delegated MCP User from 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