io.github.flowzap-xyz/flowzap

Official13 toolsLive

by flowzap-xyz · TypeScript

Create workflow, sequence, architecture, and mind map diagrams via AI assistants.

FlowZap MCP Server (io.github.flowzap-xyz/flowzap)

This MCP server enables AI assistants to generate workflow-related diagrams from prompts. It supports creating workflow, sequence, and architecture diagrams, using AI assistants such as Claude, Cursor, and Windsurf, along with other MCP-compatible tools.

🛠️ Key Features

Creates workflow, sequence, and architecture diagrams via AI assistants
Uses a text-based DSL called FlowZap Code
Versioned as MCP 2.0.0 (per readme excerpt)

🚀 Use Cases

Generate triple-view diagrams from text prompts
Draft visual workflow documentation (workflow, sequence, architecture)

⚡ Developer Benefits

Integrates with MCP-compatible AI assistants to create diagrams
Input is text prompts that are transformed into diagrams using FlowZap Code

⚠️ Limitations

Diagram generation scope described is workflow, sequence, and architecture (no other diagram types stated)

Captured live from the server via tools/list.

flowzap_validate

Validate FlowZap Code syntax. Returns errors and stats.

Parameters2

code	string	required	FlowZap Code to validate
lng	string	optional	Language of the messages returned by this tool. Default: 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to validate"
    },
    "lng": {
      "type": "string",
      "enum": [
        "en",
        "fr",
        "zh"
      ],
      "description": "Language of the messages returned by this tool. Default: 'en'."
    }
  },
  "required": [
    "code"
  ]
}

flowzap_fix

Deterministically repair mechanical FlowZap Code errors: non-sequential node numbering, inferred edge handles, node/edge label syntax, missing lane display labels, emoji and non-printable characters. Returns the repaired code plus the list of corrections that were applied. Errors that cannot be repaired are reported as-is — the repairer never invents content.

Parameters2

code	string	required	FlowZap Code to repair
lng	string	optional	Language of the messages returned by this tool. Default: 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to repair"
    },
    "lng": {
      "type": "string",
      "enum": [
        "en",
        "fr",
        "zh"
      ],
      "description": "Language of the messages returned by this tool. Default: 'en'."
    }
  },
  "required": [
    "code"
  ]
}

flowzap_mindmap_validate

Validate FlowZap Code syntax specifically for Mind Map diagrams. Checks syntax validity and whether the code is mind-map-ready (no diamonds, no taskboxes, at least one circle for the root, at least one rectangle for branches). Use this before flowzap_mindmap_approve and flowzap_mindmap_create_playground.

Parameters1

code

string

required

FlowZap Code to validate for mind map readiness

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to validate for mind map readiness"
    }
  },
  "required": [
    "code"
  ]
}

flowzap_mindmap_approve

Check if valid FlowZap Code is suitable for Mind Map rendering. Returns structured verdict with errors (blocking), warnings (advisory), and info. Rules: diamonds and taskboxes are ERROR (not rendered in mind maps), multiple circles produce WARNING (only the first is the root), edge directions are INFO (ignored by renderer), large/deep diagrams produce advisory warnings. Uses local parsing only - no API call.

Parameters1

code

string

required

FlowZap Code to inspect for mind map readiness

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to inspect for mind map readiness"
    }
  },
  "required": [
    "code"
  ]
}

flowzap_mindmap_template

Generate a ready-to-extend FlowZap Code skeleton for a Mind Map. Returns a tree structure with a central circle root, rectangle branches and sub-branches, and optional cross-links between branches. Use this to bootstrap a new mind map.

Parameters3

topic	string	optional	Central topic label for the mind map root (default: 'Central Topic')
branches	number	optional	Number of main branches from the root (default: 3, max: 8)
depth	number	optional	Depth of sub-branches per main branch (default: 2, max: 4)

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Central topic label for the mind map root (default: 'Central Topic')"
    },
    "branches": {
      "type": "number",
      "description": "Number of main branches from the root (default: 3, max: 8)"
    },
    "depth": {
      "type": "number",
      "description": "Depth of sub-branches per main branch (default: 2, max: 4)"
    }
  }
}

flowzap_mindmap_create_playground

Create a FlowZap playground session that opens directly in Mind Map view (?view=mindmap). Validates the code first, then creates a shareable URL. Use this after flowzap_mindmap_validate and flowzap_mindmap_approve have passed.

Parameters1

code

string

required

FlowZap Code to load in a mind map playground

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to load in a mind map playground"
    }
  },
  "required": [
    "code"
  ]
}

flowzap_create_playground

Create a shareable FlowZap playground URL. Set view to 'architecture', 'sequence', or 'mindmap' when appropriate.

Parameters3

code	string	required	FlowZap Code to render
view	string	optional	View mode. Default: 'workflow'.
lng	string	optional	Language of the messages returned by this tool. Default: 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to render"
    },
    "view": {
      "type": "string",
      "enum": [
        "workflow",
        "sequence",
        "architecture",
        "mindmap"
      ],
      "description": "View mode. Default: 'workflow'."
    },
    "lng": {
      "type": "string",
      "enum": [
        "en",
        "fr",
        "zh"
      ],
      "description": "Language of the messages returned by this tool. Default: 'en'."
    }
  },
  "required": [
    "code"
  ]
}

flowzap_get_syntax

Get FlowZap Code syntax documentation and examples.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

flowzap_export_graph

Parse FlowZap Code into a structured JSON graph (lanes, nodes, edges).

Parameters1

code

string

required

FlowZap Code to parse

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to parse"
    }
  },
  "required": [
    "code"
  ]
}

flowzap_artifact_to_diagram

Convert HTTP logs, OpenAPI specs, or code snippets into a FlowZap diagram.

Parameters3

artifactType	string	required
content	string	required	Raw artifact content
view	string	optional	Preferred view mode

Raw schema

{
  "type": "object",
  "properties": {
    "artifactType": {
      "type": "string",
      "enum": [
        "http_logs",
        "openapi",
        "code"
      ]
    },
    "content": {
      "type": "string",
      "description": "Raw artifact content"
    },
    "view": {
      "type": "string",
      "enum": [
        "workflow",
        "sequence",
        "architecture"
      ],
      "description": "Preferred view mode"
    }
  },
  "required": [
    "artifactType",
    "content"
  ]
}

flowzap_diff

Compare two FlowZap Code versions and return a structured diff.

Parameters2

oldCode	string	required	Original FlowZap Code
newCode	string	required	Updated FlowZap Code

Raw schema

{
  "type": "object",
  "properties": {
    "oldCode": {
      "type": "string",
      "description": "Original FlowZap Code"
    },
    "newCode": {
      "type": "string",
      "description": "Updated FlowZap Code"
    }
  },
  "required": [
    "oldCode",
    "newCode"
  ]
}

flowzap_apply_change

Apply structured patch operations (insert/remove/update nodes or edges) to FlowZap Code.

Parameters2

code	string	required	Current FlowZap Code
operations	array	required	Array of patch operations

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Current FlowZap Code"
    },
    "operations": {
      "type": "array",
      "description": "Array of patch operations",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "code",
    "operations"
  ]
}

flowzap_compliance_check

Run an automated SOC2 / GDPR / PIPL / EU AI Act architectural compliance review of a FlowZap Code data flow. Returns a Markdown summary of findings (control · status · detail · recommendation) for each framework whose elements are detectable in the diagram. Free quota: 10 free compliance reviews per client per rolling 30-day period. For unlimited manual reviews, paste your code at https://flowzap.xyz/soc2-gdpr-pipl-compliance-checker. Processor disclosure (GDPR Art. 13): analysis powered by Deepseek (Hangzhou DeepSeek AI, China) — see https://flowzap.xyz/legal/subprocessors. This is an advisory architectural review, not legal advice.

Parameters2

code	string	required	FlowZap Code to audit
lng	string	optional	Output language for findings. Default: 'en'.

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "FlowZap Code to audit"
    },
    "lng": {
      "type": "string",
      "enum": [
        "en",
        "fr",
        "zh"
      ],
      "description": "Output language for findings. Default: 'en'."
    }
  },
  "required": [
    "code"
  ]
}

README.md11 KBView on GitHub

FlowZap MCP Server

Create workflow, sequence, architecture, and mind map diagrams using AI assistants like Claude, Cursor, Windsurf, and 8 other MCP-compatible tools.

FlowZap is a visual workflow diagramming tool with a text-based DSL called FlowZap Code. This MCP server lets AI assistants create diagrams for you.

What is FlowZap?

FlowZap turns text prompts into quad-view diagrams (Workflow, Sequence, Architecture & Mind Map) using FlowZap Code DSL. It is NOT Mermaid, NOT PlantUML - it is a unique domain-specific language designed for simplicity and AI generation.

Key Facts:

Only 4 shapes: circle, rectangle, diamond, taskbox
Node attributes use colon: label:"Text"
Edge labels use equals: [label="Text"]
Handles required: n1.handle(right) -> n2.handle(left)
Lane display label must be on the same line as the opening brace: laneName { # Label
Sequence diagram quality: every cross-lane request needs a matching response edge before the next major request; define edges in chronological order; keep a strict request → response → next request rhythm; no orphaned nodes

Installation

The FlowZap MCP Server works with any tool that supports the Model Context Protocol (MCP):

All Compatible Coding Tools

Tool	How to Configure
Claude Desktop	Add to `claude_desktop_config.json`: macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Claude Code	Run: `claude mcp add --transport stdio flowzap -- npx -y flowzap-mcp` Or add to `.mcp.json` in your project root.
Cursor	Open Settings → Features → MCP Servers → Add Server. Use the same JSON config.
Windsurf IDE	Add to `~/.codeium/windsurf/mcp_config.json`
OpenAI Codex	Add to `~/.codex/config.toml`: `[mcp_servers.flowzap]` `command = "npx"` `args = ["-y", "flowzap-mcp"]` Or run: `codex mcp add flowzap -- npx -y flowzap-mcp`
Warp Terminal	Settings → MCP Servers → Click "+ Add" → Paste the JSON config.
Zed Editor	Add to `settings.json`: `{"context_servers": {"flowzap": {"command": "npx", "args": ["-y", "flowzap-mcp"]}}}`
Cline (VS Code)	Open Cline sidebar → MCP Servers icon → Edit `cline_mcp_settings.json`
Roo Code (VS Code)	Add to `.roo/mcp.json` in project or global settings.
Continue.dev	Create `.continue/mcpServers/flowzap.yaml` with: `name: FlowZap` `mcpServers:` `- name: flowzap` `command: npx` `args: ["-y", "flowzap-mcp"]`
Sourcegraph Cody	Add to VS Code `settings.json` via `openctx.providers` configuration.

Not Compatible: Replit and Lovable.dev only support remote MCP servers via URL. Use the Public API instead.

JSON Configuration

All tools use the same JSON configuration format:

json

{
  "mcpServers": {
    "flowzap": {
      "command": "npx",
      "args": ["-y", "flowzap-mcp"]
    }
  }
}

Windows Users: If tools don't appear, use the absolute path:
json
"command": "C:\\Program Files\\nodejs\\npx.cmd"
Find your npx path with: where.exe npx

Available Tools

Core Tools

Tool	Description
`flowzap_validate`	Validate FlowZap Code syntax
`flowzap_fix`	Deterministically repair mechanical FlowZap Code errors (numbering, inferred handles, label syntax, missing lane labels, emoji/control chars) and return the repaired code plus the corrections applied
`flowzap_create_playground`	Create a shareable diagram URL
`flowzap_get_syntax`	Get FlowZap Code syntax documentation

Agent-Focused Tools

Tool	Description
`flowzap_export_graph`	Export FlowZap Code as structured JSON graph (lanes, nodes, edges) for reasoning
`flowzap_artifact_to_diagram`	Parse HTTP logs, OpenAPI specs, or code into FlowZap diagrams
`flowzap_diff`	Compare two versions of FlowZap Code and get structured diff
`flowzap_apply_change`	Apply structured patch operations (insert/remove/update nodes/edges)

Compliance Tool

Tool	Description
`flowzap_compliance_check`	Run automated SOC2, GDPR, and PIPL compliance analysis on a FlowZap Code data-flow diagram. Backed by Deepseek LLM with strict rate limits (3/day per IP, 1/hour burst, global 5-min circuit breaker). Returns a shareable ephemeral result URL (60-min TTL).

Mind Map Tools

Tool	Description
`flowzap_mindmap_validate`	Validate FlowZap Code syntax and mind-map readiness
`flowzap_mindmap_approve`	Check if code is suitable for Mind Map rendering (diamonds/taskboxes = ERROR)
`flowzap_mindmap_template`	Generate a ready-to-extend Mind Map tree skeleton
`flowzap_mindmap_create_playground`	Create a playground URL with `?view=mindmap`

Usage Examples

Basic Diagram Creation

Ask your AI assistant:

"Generate a Sequence diagram of the current Sign In flow implemented in this App"
"Create a workflow diagram for an order processing system"
"Create an architecture diagram for a microservices API gateway"
"Make a flowchart showing user registration flow"
"Diagram a CI/CD pipeline with build, test, and deploy stages"

Agent-Focused Workflows

Parse HTTP Logs into Diagrams:

code

"Here are my nginx access logs. Create a sequence diagram showing the request flow."

The agent uses flowzap_artifact_to_diagram with artifactType: "http_logs".

Analyze Diagram Structure:

code

"Which steps in this workflow touch the database?"

The agent uses flowzap_export_graph to get a JSON graph, then queries it.

Show What Changed:

code

"I updated the workflow. What's different from the previous version?"

The agent uses flowzap_diff to compare old and new code.

Safe Incremental Updates:

code

"Add a logging step after the API call in this diagram."

The agent uses flowzap_apply_change with a structured patch instead of regenerating.

Repair Invalid Code:

code

"My FlowZap Code fails validation. Fix the mechanical errors for me."

The agent uses flowzap_fix to deterministically repair numbering, inferred handles, label syntax, lane labels, emoji and control characters, then validates the repaired code. Anything the repairer cannot fix is reported as-is — it never invents content.

Compliance Audit:

code

"Check my data flow diagram for SOC2, GDPR, and PIPL compliance."

The agent uses flowzap_compliance_check to run an automated audit and returns a shareable result page.

Mind Map Creation:

code

"Create a mind map about AI agent architecture"

The agent uses flowzap_mindmap_template to generate a skeleton, then validates and creates a playground with ?view=mindmap.

The assistant will:

Generate FlowZap Code based on your description
Validate the code
Create a playground URL with the appropriate view (workflow, sequence, or architecture) to view and share

FlowZap Code Example

code

sales { # Sales Team
  n1: circle label:"Order Received"
  n2: rectangle label:"Submit Order"
  n5: rectangle label:"Receive decision"
  n1.handle(right) -> n2.handle(left)
  n2.handle(bottom) -> fulfillment.n3.handle(top) [label="Submit"]
}

fulfillment { # Fulfillment
  n3: rectangle label:"Review Order"
  n4: rectangle label:"Return decision"
  n3.handle(right) -> n4.handle(left)
  n4.handle(top) -> sales.n5.handle(bottom) [label="Approved"]
}

Public API Endpoints

These endpoints are available for external integrations (no authentication required):

Endpoint	Method	Rate Limit	Description
`/api/validate`	POST	30/min	Validate FlowZap Code syntax
`/api/fix`	POST	30/min	Deterministically repair mechanical FlowZap Code errors and return the repaired code + applied corrections
`/api/playground/create`	POST	5/min, 50/day	Create ephemeral playground URL (15-min TTL)
`/api/compliance-check`	POST	5/min, 30/day	Run SOC2/GDPR/PIPL compliance analysis on FlowZap Code. Returns frameworks + shareable result URL (60-min TTL). Backed by Deepseek LLM.

Security

No authentication required - Uses only public FlowZap APIs
No user data access - Cannot read your diagrams or account
Runs locally - The MCP server runs on your machine
SSRF protected - Only connects to flowzap.xyz
Rate limited - 30 requests/minute client-side
Input validation - 50KB max code size

Agent Skill (skills.sh)

Install the FlowZap skill for 40+ compatible coding agents via skills.sh:

bash

npx skills add flowzap-xyz/flowzap-mcp

skills.sh listing: https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams
Skill source: skills/flowzap-diagrams/
Compatible with: Claude Code, Cursor, Windsurf, Codex, Gemini CLI, GitHub Copilot, Cline, Roo Code, Augment, OpenCode, and more.

Public MCP Adoption Signals

Public MCP Usage Stats: https://flowzap.xyz/.well-known/flowzap-stats.json
MCP Calls Badge JSON: https://flowzap.xyz/.well-known/flowzap-stats-badge.json

Official Listings

Official MCP Registry: https://registry.modelcontextprotocol.io/?q=flowzap
Smithery Server: https://smithery.ai/server/@flowzap/flowzap
Smithery Skill: https://smithery.ai/skills/Flowzap/diagram-skill
PulseMCP: https://www.pulsemcp.com/servers/flowzap
Glama: https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp
MCPServers.org: https://mcpservers.org/servers/flowzap-xyz-docs-mcp
AIBase: https://mcp.aibase.com/server/1639702939289526535

License

MIT

Install

Tools (13)

flowzap_validateflowzap_fixflowzap_mindmap_validateflowzap_mindmap_approveflowzap_mindmap_templateflowzap_mindmap_create_playgroundflowzap_create_playgroundflowzap_get_syntax

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "flowzap": {
      "command": "npx",
      "args": [
        "-y",
        "flowzap-mcp@2.1.0"
      ]
    }
  }
}

FlowZap MCP Server (io.github.flowzap-xyz/flowzap)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

flowzap_validate

flowzap_fix

flowzap_mindmap_validate

flowzap_mindmap_approve

flowzap_mindmap_template

flowzap_mindmap_create_playground

flowzap_create_playground

flowzap_get_syntax

flowzap_export_graph

flowzap_artifact_to_diagram

flowzap_diff

flowzap_apply_change

flowzap_compliance_check

FlowZap MCP Server

What is FlowZap?

Installation

All Compatible Coding Tools

JSON Configuration

Available Tools

Core Tools

Agent-Focused Tools

Compliance Tool

Mind Map Tools

Usage Examples

Basic Diagram Creation

Agent-Focused Workflows

FlowZap Code Example

Public API Endpoints

Security

Agent Skill (skills.sh)

Public MCP Adoption Signals

Official Listings

Links

License

Install

Related servers