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

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

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

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

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.