{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bk5qa2ccn6ea","handle":"appkit-mcp-bpmn","url":"https://wellknown.network/agents/appkit-mcp-bpmn","links":{"self":"https://wellknown.network/agents/appkit-mcp-bpmn/record.json","html":"https://wellknown.network/agents/appkit-mcp-bpmn","markdown":"https://wellknown.network/agents/appkit-mcp-bpmn/record.md","api":"https://wellknown.network/api/v1/agents/appkit-mcp-bpmn","status":"https://wellknown.network/api/v1/agents/appkit-mcp-bpmn/status","claim":"https://wellknown.network/agents/appkit-mcp-bpmn/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/appkit-mcp-bpmn/claim.json","badge":"https://wellknown.network/agents/appkit-mcp-bpmn/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/appkit-mcp-bpmn/history","tools":"https://wellknown.network/api/v1/agents/appkit-mcp-bpmn/tools"},"ard":{"identifier":"urn:air::server:appkit-mcp-bpmn","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"appkit-mcp-bpmn","summary":"MCP BPMN 2.0 Diagram Server","description":"# appkit-mcp-bpmn\n\nMCP server component for generating and viewing BPMN 2.0 diagrams.\n\n## Features\n\n- **Generate BPMN diagrams** from natural language descriptions via LLM\n- **Save & validate** BPMN 2.0 XML with schema-aware validation\n- **Render diagrams** in-browser using bpmn-js Viewer (read-only)\n- **Download** diagrams as `.bpmn` files\n- **Public API** — no authentication required\n\n## MCP Tools\n\n### `generate_bpmn_diagram`\n\nGenerate a BPMN 2.0 diagram from a natural language description.\n\n**Parameters:**\n- `description` (str, required): Workflow description in natural language\n- `diagram_type` (str, optional): `\"process\"` | `\"collaboration\"` | `\"choreography\"` (default: `\"process\"`)\n\n**Returns:** JSON with `{success, id, xml, download_url, view_url, error}`\n\n### `save_bpmn_diagram`\n\nSave pre-built BPMN 2.0 XML to the filesystem.\n\n**Parameters:**\n- `xml` (str, required): Complete BPMN 2.0 XML string\n\n**Returns:** JSON with `{success, id, xml, download_url, view_url, error}`\n\n## MCP Resource\n\n### `ui://appkit/bpmn_viewer.html`\n\nInteractive BPMN diagram viewer powered by bpmn-js. Renders tool results via the MCP App `ui/notifications/tool-result` protocol.\n\n**Features:**\n- Zoom to fit viewport\n- Download diagram as `.bpmn` file\n- Error display for invalid XML\n\n## Quick Start\n\n```python\nfrom appkit_mcp_bpmn.server import create_bpmn_mcp_server\n\nmcp = create_bpmn_mcp_server()\napp = mcp.http_app(path=\"/mcp\", transport=\"streamable-http\")\n```\n\n## Example Workflow\n\n```\n1. User: \"Create an expense approval workflow\"\n2. LLM calls generate_bpmn_diagram(description=\"...\", diagram_type=\"process\")\n3. Server generates XML via LLM, validates, saves to uploaded_files/\n4. Returns {id, view_url, download_url}\n5. MCP App renders diagram in bpmn-js Viewer\n```\n\n## Dependencies\n\n- `appkit-commons` — Configuration and logging\n- `appkit-mcp-commons` — Shared MCP base models\n- `lxml` — XML parsing and validation\n- `openai` (optional) — LLM generation via OpenAI API","publisher":{"name":"Jens Rehpöhler","url":null},"homepage":"https://github.com/jenreh/appkit/tree/main/docs","repository":"https://github.com/jenreh/appkit/tree/main/docs","version":"1.16.2","license":"MIT","protocols":["mcp"],"tags":["bpmn","diagram","fastmcp","mcp","reflex","workflow"],"pricing":null,"endpoints":[{"url":"pypi:appkit-mcp-bpmn","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"appkit-mcp-bpmn","registry":"pypi","observedAt":"2026-10-21T17:27:43.342Z","publishedAt":"2026-10-18T18:30:10.158748Z","latestVersion":"1.16.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"appkit-mcp-bpmn","url":"https://pypi.org/project/appkit-mcp-bpmn/","firstSeenAt":"2026-09-09T09:23:14.151Z","fetchedAt":"2026-10-21T17:25:52.495Z","normalizedAt":"2026-10-21T17:25:52.495Z"}]},"firstSeenAt":"2026-09-09T09:23:14.151Z","updatedAt":"2026-10-21T17:27:43.342Z"}