{
  "markdown": "# FlowZap MCP Server\n\n[![npm version](https://img.shields.io/npm/v/flowzap-mcp)](https://www.npmjs.com/package/flowzap-mcp) [![MCP](https://img.shields.io/badge/MCP-2.0.0-purple)](https://flowzap.xyz/docs/mcp)\n\nCreate workflow, sequence, and architecture diagrams using AI assistants like Claude, Cursor, Windsurf, and 8 other MCP-compatible tools.\n\n[FlowZap](https://flowzap.xyz) is a visual workflow diagramming tool with a text-based DSL called **FlowZap Code**. This MCP server lets AI assistants create diagrams for you.\n\n## What is FlowZap?\n\nFlowZap turns text prompts into triple-view diagrams (Workflow, Sequence & Architecture) using FlowZap Code DSL. It is NOT Mermaid, NOT PlantUML - it is a unique domain-specific language designed for simplicity and AI generation.\n\n**Key Facts:**\n- Only 4 shapes: `circle`, `rectangle`, `diamond`, `taskbox`\n- Node attributes use colon: `label:\"Text\"`\n- Edge labels use equals: `[label=\"Text\"]`\n- Handles required: `n1.handle(right) -> n2.handle(left)`\n- Lane display label must be on the same line as the opening brace: `laneName { # Label`\n- 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\n\n## Installation\n\nThe FlowZap MCP Server works with **any tool that supports the Model Context Protocol (MCP)**:\n\n### All Compatible Coding Tools\n\n| Tool | How to Configure |\n|------|------------------|\n| **Claude Desktop** | Add to `claude_desktop_config.json`:<br>**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`<br>**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| **Claude Code** | Run: `claude mcp add --transport stdio flowzap -- npx -y flowzap-mcp`<br>Or add to `.mcp.json` in your project root. |\n| **Cursor** | Open Settings → Features → MCP Servers → Add Server. Use the same JSON config. |\n| **Windsurf IDE** | Add to `~/.codeium/windsurf/mcp_config.json` |\n| **OpenAI Codex** | Add to `~/.codex/config.toml`:<br>`[mcp_servers.flowzap]`<br>`command = \"npx\"`<br>`args = [\"-y\", \"flowzap-mcp\"]`<br>Or run: `codex mcp add flowzap -- npx -y flowzap-mcp` |\n| **Warp Terminal** | Settings → MCP Servers → Click \"+ Add\" → Paste the JSON config. |\n| **Zed Editor** | Add to `settings.json`:<br>`{\"context_servers\": {\"flowzap\": {\"command\": \"npx\", \"args\": [\"-y\", \"flowzap-mcp\"]}}}` |\n| **Cline** (VS Code) | Open Cline sidebar → MCP Servers icon → Edit `cline_mcp_settings.json` |\n| **Roo Code** (VS Code) | Add to `.roo/mcp.json` in project or global settings. |\n| **Continue.dev** | Create `.continue/mcpServers/flowzap.yaml` with:<br>`name: FlowZap`<br>`mcpServers:`<br>`  - name: flowzap`<br>`    command: npx`<br>`    args: [\"-y\", \"flowzap-mcp\"]` |\n| **Sourcegraph Cody** | Add to VS Code `settings.json` via `openctx.providers` configuration. |\n\n> **Not Compatible:** Replit and Lovable.dev only support remote MCP servers via URL. Use the [Public API](https://flowzap.xyz/api/playground/create) instead.\n\n### JSON Configuration\n\nAll tools use the same JSON configuration format:\n\n```json\n{\n  \"mcpServers\": {\n    \"flowzap\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"flowzap-mcp\"]\n    }\n  }\n}\n```\n\n> **Windows Users:** If tools don't appear, use the absolute path:\n> ```json\n> \"command\": \"C:\\\\Program Files\\\\nodejs\\\\npx.cmd\"\n> ```\n> Find your npx path with: `where.exe npx`\n\n## Available Tools\n\n### Core Tools\n| Tool | Description |\n|------|-------------|\n| `flowzap_validate` | Validate FlowZap Code syntax |\n| `flowzap_create_playground` | Create a shareable diagram URL |\n| `flowzap_get_syntax` | Get FlowZap Code syntax documentation |\n\n### Agent-Focused Tools\n| Tool | Description |\n|------|-------------|\n| `flowzap_export_graph` | Export FlowZap Code as structured JSON graph (lanes, nodes, edges) for reasoning |\n| `flowzap_artifact_to_diagram` | Parse HTTP logs, OpenAPI specs, or code into FlowZap diagrams |\n| `flowzap_diff` | Compare two versions of FlowZap Code and get structured diff |\n| `flowzap_apply_change` | Apply structured patch operations (insert/remove/update nodes/edges) |\n\n### Compliance Tool\n| Tool | Description |\n|------|-------------|\n| `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). |\n\n### Mind Map Tools\n| Tool | Description |\n|------|-------------|\n| `flowzap_mindmap_validate` | Validate FlowZap Code syntax and mind-map readiness |\n| `flowzap_mindmap_approve` | Check if code is suitable for Mind Map rendering (diamonds/taskboxes = ERROR) |\n| `flowzap_mindmap_template` | Generate a ready-to-extend Mind Map tree skeleton |\n| `flowzap_mindmap_create_playground` | Create a playground URL with `?view=mindmap` |\n\n## Usage Examples\n\n### Basic Diagram Creation\nAsk your AI assistant:\n- \"Generate a Sequence diagram of the current Sign In flow implemented in this App\"\n- \"Create a workflow diagram for an order processing system\"\n- \"Create an architecture diagram for a microservices API gateway\"\n- \"Make a flowchart showing user registration flow\"\n- \"Diagram a CI/CD pipeline with build, test, and deploy stages\"\n\n### Agent-Focused Workflows\n\n**Parse HTTP Logs into Diagrams:**\n```\n\"Here are my nginx access logs. Create a sequence diagram showing the request flow.\"\n```\nThe agent uses `flowzap_artifact_to_diagram` with `artifactType: \"http_logs\"`.\n\n**Analyze Diagram Structure:**\n```\n\"Which steps in this workflow touch the database?\"\n```\nThe agent uses `flowzap_export_graph` to get a JSON graph, then queries it.\n\n**Show What Changed:**\n```\n\"I updated the workflow. What's different from the previous version?\"\n```\nThe agent uses `flowzap_diff` to compare old and new code.\n\n**Safe Incremental Updates:**\n```\n\"Add a logging step after the API call in this diagram.\"\n```\nThe agent uses `flowzap_apply_change` with a structured patch instead of regenerating.\n\n**Compliance Audit:**\n```\n\"Check my data flow diagram for SOC2, GDPR, and PIPL compliance.\"\n```\nThe agent uses `flowzap_compliance_check` to run an automated audit and returns a shareable result page.\n\n**Mind Map Creation:**\n```\n\"Create a mind map about AI agent architecture\"\n```\nThe agent uses `flowzap_mindmap_template` to generate a skeleton, then validates and creates a playground with `?view=mindmap`.\n\nThe assistant will:\n1. Generate FlowZap Code based on your description\n2. Validate the code\n3. Create a playground URL with the appropriate view (workflow, sequence, or architecture) to view and share\n\n## FlowZap Code Example\n\n```\nsales { # Sales Team\n  n1: circle label:\"Order Received\"\n  n2: rectangle label:\"Submit Order\"\n  n5: rectangle label:\"Receive decision\"\n  n1.handle(right) -> n2.handle(left)\n  n2.handle(bottom) -> fulfillment.n3.handle(top) [label=\"Submit\"]\n}\n\nfulfillment { # Fulfillment\n  n3: rectangle label:\"Review Order\"\n  n4: rectangle label:\"Return decision\"\n  n3.handle(right) -> n4.handle(left)\n  n4.handle(top) -> sales.n5.handle(bottom) [label=\"Approved\"]\n}\n```\n\n## Public API Endpoints\n\nThese endpoints are available for external integrations (no authentication required):\n\n| Endpoint | Method | Rate Limit | Description |\n|----------|--------|------------|-------------|\n| `/api/validate` | POST | 30/min | Validate FlowZap Code syntax |\n| `/api/playground/create` | POST | 5/min, 50/day | Create ephemeral playground URL (15-min TTL) |\n| `/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. |\n\n## Security\n\n- **No authentication required** - Uses only public FlowZap APIs\n- **No user data access** - Cannot read your diagrams or account\n- **Runs locally** - The MCP server runs on your machine\n- **SSRF protected** - Only connects to flowzap.xyz\n- **Rate limited** - 30 requests/minute client-side\n- **Input validation** - 50KB max code size\n\n## Agent Skill (skills.sh)\n\nInstall the FlowZap skill for 40+ compatible coding agents via [skills.sh](https://skills.sh):\n\n```bash\nnpx skills add flowzap-xyz/flowzap-mcp\n```\n\n- **skills.sh listing:** [https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams](https://skills.sh/flowzap-xyz/flowzap-mcp/flowzap-diagrams)\n- **Skill source:** [skills/flowzap-diagrams/](https://github.com/flowzap-xyz/flowzap-mcp/tree/main/skills/flowzap-diagrams)\n- Compatible with: Claude Code, Cursor, Windsurf, Codex, Gemini CLI, GitHub Copilot, Cline, Roo Code, Augment, OpenCode, and more.\n\n## Public MCP Adoption Signals\n\n- **Public MCP Usage Stats:** [https://flowzap.xyz/.well-known/flowzap-stats.json](https://flowzap.xyz/.well-known/flowzap-stats.json)\n- **MCP Calls Badge JSON:** [https://flowzap.xyz/.well-known/flowzap-stats-badge.json](https://flowzap.xyz/.well-known/flowzap-stats-badge.json)\n\n## Official Listings\n\n- **Official MCP Registry:** [https://registry.modelcontextprotocol.io/?q=flowzap](https://registry.modelcontextprotocol.io/?q=flowzap)\n- **Smithery Server:** [https://smithery.ai/server/@flowzap/flowzap](https://smithery.ai/server/@flowzap/flowzap)\n- **Smithery Skill:** [https://smithery.ai/skills/Flowzap/diagram-skill](https://smithery.ai/skills/Flowzap/diagram-skill)\n- **PulseMCP:** [https://www.pulsemcp.com/servers/flowzap](https://www.pulsemcp.com/servers/flowzap)\n- **Glama:** [https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp](https://glama.ai/mcp/servers/flowzap-xyz/flowzap-mcp)\n- **MCPServers.org:** [https://mcpservers.org/servers/flowzap-xyz-docs-mcp](https://mcpservers.org/servers/flowzap-xyz-docs-mcp)\n- **AIBase:** [https://mcp.aibase.com/server/1639702939289526535](https://mcp.aibase.com/server/1639702939289526535)\n\n## Links\n\n- [FlowZap Website](https://flowzap.xyz)\n- [FlowZap Code Documentation](https://flowzap.xyz/flowzap-code)\n- [FlowZap MCP Blog](https://flowzap.xyz/blog/introducing-the-flowzap-mcp-server)\n- [LLM Context](https://flowzap.xyz/llms.txt)\n- [Templates Library](https://flowzap.xyz/templates)\n- [npm Package](https://www.npmjs.com/package/flowzap-mcp)\n- [GitHub Repository](https://github.com/flowzap-xyz/flowzap-mcp)\n\n## License\n\nMIT\n",
  "bytes": 10307,
  "sha": "f97906e6d38892f9d8e3672d694181f93c6a05eb0afc536db2ca49ce7c809496",
  "repo_slug": "flowzap-xyz/flowzap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_flowzap_xyz_flowzap_a9ee0127/readme"
}