January 2026 Update: We've simplified MCP integration! The new flowzap-mcp npm package replaces the old complex MCP server. One command install, no authentication required.

🚀 Quick Start (Recommended)

For Claude Desktop

Add to your claude_desktop_config.json:

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

Config file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

For Cursor

Add the same configuration to your Cursor MCP settings.

For Windsurf IDE

Add to your ~/.codeium/windsurf/mcp_config.json:

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

Windows Users: If tools don't appear in Cascade, use the absolute path for npx:

{
  "mcpServers": {
    "flowzap": {
      "command": "C:\Program Files\nodejs\npx.cmd",
      "args": ["-y", "flowzap-mcp"]
    }
  }
}

Find your npx path with: where.exe npx

All Compatible Coding Tools

The FlowZap MCP Server works with any tool that supports the Model Context Protocol (MCP). Here is the complete list:

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. They cannot use the FlowZap MCP npm package directly. Use the Public API instead.

For Comet Browser / Other AI Assistants

Comet and similar AI browsers don't support custom MCP servers directly. Instead, they can:

Generate FlowZap Code using the syntax documentation at flowzap.xyz/flowzap-code

Create playground URLs via the public API:

curl -X POST https://flowzap.xyz/api/playground/create   -H "Content-Type: application/json"   -d '{"code": "sales { n1: circle label:"Start" }"}'

Available Tools (v1.2.0)

Core Tools

Tool	Description
`flowzap_validate`	Validate FlowZap Code syntax
`flowzap_create_playground`	Create a shareable diagram URL
`flowzap_get_syntax`	Get FlowZap Code syntax documentation

Agent-Focused Tools (New in v1.1.0+)

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

Usage Examples

Ask your AI assistant:

"Create a workflow diagram for an order processing system"
"Make a flowchart showing user registration flow"
"Diagram a CI/CD pipeline with build, test, and deploy stages"

The assistant will:

Generate FlowZap Code based on your description
Validate the code
Create a playground URL you can view and share

FlowZap Code Example

sales {
  # Sales Team
  start: circle label:"Order Received"
  validate: rect label:"Validate Order"
  check: diamond label:"Valid?"
  start -> validate -> check
}

fulfillment {
  # Fulfillment
  process: rect label:"Process Order"
  ship: rect label:"Ship Items"
  end: circle label:"Complete"
  process -> ship -> end
}

Security

The flowzap-mcp package implements comprehensive security measures:

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 limiting — 30 requests/minute client-side protection
Input validation — 50KB max code size, sanitization
Request timeout — 30-second timeout prevents hanging

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/playground/create`	POST	5/min, 50/day	Create ephemeral playground URL (15-min TTL)

Note: AI-powered code generation (/api/ai-generate) requires authentication and is only available to logged-in FlowZap users.

Legacy Remote MCP (Deprecated)

⚠️ The remote MCP endpoints below are deprecated. Use the npm package above instead.

SSE: https://flowzap.xyz/mcp/api/sse
JSON-RPC: POST https://flowzap.xyz/mcp/api/rpc
Health: GET https://flowzap.xyz/mcp/api/health

FlowZap MCP: The open, agent-friendly bridge to real business diagrams. Build the workflows you want, how you want.

Introducing the FlowZap MCP Server: The Fastest Path from LLM Agent to Interactive Diagrams