flowzap-xyz/flowzap-mcp

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:
> **Windows Users:** If tools don't appear, use the absolute path:
>
> 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 |