web-mcp-flow.vercel.app

add_node

Add a new node to the active flow. Valid node types: "start_end" (rounded pill; data.variant is "start" or "end"), "process" (rectangle; optional data.description), "decision" (diamond; optional data.condition; has two source handles "yes" and "no"), "io" (parallelogram; optional data.description), "note" (dashed box, annotation only — cannot be connected). `label` is the visible title. Placement, in priority order: (1) explicit `position` {x,y} in canvas coords; (2) `near` (a node id) with optional `direction` ("below" default | "above" | "left" | "right") — placed one step from that node and nudged clear of overlaps; (3) if neither is given and exactly one node is selected, placed below the selected node; (4) otherwise the canvas origin. Returns { success, nodeId }, or { success: false, error } if `near` refers to a missing node. All canvas tools act on the currently active/visible flow tab only, never other tabs.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "start_end",
        "process",
        "decision",
        "io",
        "note"
      ]
    },
    "label": {
      "type": "string"
    },
    "position": {
      "type": "object",
      "properties": {
        "x": {
          "type": "number"
        },
        "y": {
          "type": "number"
        }
      },
      "required": [
        "x",
        "y"
      ]
    },
    "near": {
      "type": "string"
    },
    "direction": {
      "type": "string",
      "enum": [
        "below",
        "above",
        "left",
        "right"
      ]
    }
  },
  "required": [
    "type",
    "label"
  ],
  "additionalProperties": false
}