MCP BPMN 2.0 Diagram Server
Until 2026-09-25 this record combined several servers published from one repository. The others now have records of their own: appkit-mcp-image, appkit-mcp-commons, appkit-mcp-user. Checks from before that date include them.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"appkit-mcp-bpmn","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# appkit-mcp-bpmn MCP server component for generating and viewing BPMN 2.0 diagrams. ## Features - **Generate BPMN diagrams** from natural language descriptions via LLM - **Save & validate** BPMN 2.0 XML with schema-aware validation - **Render diagrams** in-browser using bpmn-js Viewer (read-only) - **Download** diagrams as `.bpmn` files - **Public API** — no authentication required ## MCP Tools ### `generate_bpmn_diagram` Generate a BPMN 2.0 diagram from a natural language description. **Parameters:** - `description` (str, required): Workflow description in natural language - `diagram_type` (str, optional): `"process"` | `"collaboration"` | `"choreography"` (default: `"process"`) **Returns:** JSON with `{success, id, xml, download_url, view_url, error}` ### `save_bpmn_diagram` Save pre-built BPMN 2.0 XML to the filesystem. **Parameters:** - `xml` (str, required): Complete BPMN 2.0 XML string **Returns:** JSON with `{success, id, xml, download_url, view_url, error}` ## MCP Resource ### `ui://appkit/bpmn_viewer.html` Interactive BPMN diagram viewer powered by bpmn-js. Renders tool results via the MCP App `ui/notifications/tool-result` protocol. **Features:** - Zoom to fit viewport - Download diagram as `.bpmn` file - Error display for invalid XML ## Quick Start ```python from appkit_mcp_bpmn.server import create_bpmn_mcp_server mcp = create_bpmn_mcp_server() app = mcp.http_app(path="/mcp", transport="streamable-http") ``` ## Example Workflow ``` 1. User: "Create an expense approval workflow" 2. LLM calls generate_bpmn_diagram(description="...", diagram_type="process") 3. Server generates XML via LLM, validates, saves to uploaded_files/ 4. Returns {id, view_url, download_url} 5. MCP App renders diagram in bpmn-js Viewer ``` ## Dependencies - `appkit-commons` — Configuration and logging - `appkit-mcp-commons` — Shared MCP base models - `lxml` — XML parsing and validation - `openai` (optional) — LLM generation via OpenAI API
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.