fix: restore readable skills/lucid/references/tool-guide.md
This commit is contained in:
@@ -1,204 +1,248 @@
|
|||||||
IyBMdWNpZCBNQ1AgVG9vbCBSZWZlcmVuY2UgR3VpZGUKCkZ1bGwgZGV0YWlsIG9uIGV2ZXJ5IEx1
|
# Lucid MCP Tool Reference Guide
|
||||||
Y2lkIE1DUCB0b29sOiB3aGF0IGl0IGRvZXMsIHdoZW4gdG8gdXNlIGl0LCBleGFtcGxlIHByb21w
|
|
||||||
dHMsIGFuZCBlZGdlIGNhc2VzLgoKLS0tCgojIyBUb29sOiBTZWFyY2ggRG9jdW1lbnRzCgoqKlB1
|
Full detail on every Lucid MCP tool: what it does, when to use it, example prompts, and edge cases.
|
||||||
cnBvc2U6KiogRnVsbC10ZXh0IHNlYXJjaCBhY3Jvc3MgdGhlIHVzZXIncyBlbnRpcmUgTHVjaWQg
|
|
||||||
bGlicmFyeSAoTHVjaWRjaGFydCArIEx1Y2lkc3BhcmspLgoKKipJbnB1dDoqKiBOYXR1cmFsIGxh
|
---
|
||||||
bmd1YWdlIHF1ZXJ5IGRlc2NyaWJpbmcgd2hhdCB0byBmaW5kLgoKKipPdXRwdXQ6KiogTGlzdCBv
|
|
||||||
ZiBtYXRjaGluZyBkb2N1bWVudHMgd2l0aCB0aXRsZXMsIGRvY3VtZW50IHR5cGVzLCBhbmQgZGly
|
## Tool: Search Documents
|
||||||
ZWN0IGxpbmtzLgoKKipFeGFtcGxlIHByb21wdHM6KioKLSAiRmluZCBteSBCaXJtaW5naGFtIHRy
|
|
||||||
YW5zaXQgYXJjaGl0ZWN0dXJlIGRpYWdyYW0iCi0gIlNlYXJjaCBmb3IgYW55IHByb2Nlc3MgZmxv
|
**Purpose:** Full-text search across the user's entire Lucid library (Lucidchart + Lucidspark).
|
||||||
d3MgcmVsYXRlZCB0byBkaXNwbGF5IGluc3RhbGxhdGlvbiIKLSAiRG8gSSBoYXZlIGEgZGlhZ3Jh
|
|
||||||
bSBzaG93aW5nIHRoZSBSRE1DIEFQSSBpbnRlZ3JhdGlvbj8iCi0gIkZpbmQgbGFzdCBtb250aCdz
|
**Input:** Natural language query describing what to find.
|
||||||
IHN0YW5kdXAgYm9hcmQiCgoqKkVkZ2UgY2FzZXM6KioKLSBJZiBubyByZXN1bHRzIGZvdW5kOiBh
|
|
||||||
c2sgdGhlIHVzZXIgZm9yIGFsdGVybmF0ZSBzZWFyY2ggdGVybXMgb3Igd2hldGhlciB0aGUgZG9j
|
**Output:** List of matching documents with titles, document types, and direct links.
|
||||||
dW1lbnQgbWlnaHQgYmUgaW4gYSBzaGFyZWQgZm9sZGVyCi0gSWYgbWFueSByZXN1bHRzOiBsaXN0
|
|
||||||
IHRvcCA1IHdpdGggdGl0bGVzLCBhc2sgdXNlciB0byBzZWxlY3QKLSBTZWFyY2ggbWF5IG5vdCBm
|
**Example prompts:**
|
||||||
aW5kIGNvbnRlbnQgb24gcGFnZXMgMisgb2YgYSBkb2N1bWVudCAoa25vd24gTHVjaWQgbGltaXRh
|
- "Find my Birmingham transit architecture diagram"
|
||||||
dGlvbiBhcyBvZiBNYXkgMjAyNikKCi0tLQoKIyMgVG9vbDogR2V0IERvY3VtZW50IENvbnRlbnQg
|
- "Search for any process flows related to display installation"
|
||||||
LyBTdW1tYXJ5CgoqKlB1cnBvc2U6KiogUmV0cmlldmUgdGhlIHRleHR1YWwgY29udGVudCwgc2hh
|
- "Do I have a diagram showing the RDMC API integration?"
|
||||||
cGUgbGFiZWxzLCBjb25uZWN0aW9ucywgYW5kIHN0cnVjdHVyZSBvZiBhIHNwZWNpZmljIEx1Y2lk
|
- "Find last month's standup board"
|
||||||
IGRvY3VtZW50LgoKKipJbnB1dDoqKiBEb2N1bWVudCBJRCBvciBVUkwuCgoqKk91dHB1dDoqKiBT
|
|
||||||
dHJ1Y3R1cmVkIGRlc2NyaXB0aW9uIG9mIGRvY3VtZW50IGNvbnRlbnQg4oCUIHNoYXBlcywgbGFi
|
**Edge cases:**
|
||||||
ZWxzLCBhcnJvd3MsIHN3aW0gbGFuZXMsIHBhZ2UgdGl0bGVzLgoKKipFeGFtcGxlIHByb21wdHM6
|
- If no results found: ask the user for alternate search terms or whether the document might be in a shared folder
|
||||||
KioKLSAiU3VtbWFyaXplIHRoZSBrZXkgc3RlcHMgaW4gdGhpcyBwcm9jZXNzIGRpYWdyYW06IFtV
|
- If many results: list top 5 with titles, ask user to select
|
||||||
UkxdIgotICJXaGF0IG5vZGVzIGFyZSBpbiB0aGUgYXJjaGl0ZWN0dXJlIGRpYWdyYW0gSSBqdXN0
|
- Search may not find content on pages 2+ of a document (known Lucid limitation as of May 2026)
|
||||||
IGZvdW5kPyIKLSAiTGlzdCBhbGwgdGhlIHNoYXBlcyBhbmQgY29ubmVjdGlvbnMgaW4gdGhpcyBm
|
|
||||||
bG93Y2hhcnQiCi0gIldoYXQncyB0aGUgZGF0YSBmbG93IHNob3duIGluIHRoaXMgRVIgZGlhZ3Jh
|
---
|
||||||
bT8iCgoqKlVzYWdlIHBhdHRlcm46KiogVHlwaWNhbGx5IGZvbGxvd3MgYSBzZWFyY2gg4oCUIHRh
|
|
||||||
a2UgdGhlIGRvY3VtZW50IFVSTCBmcm9tIHNlYXJjaCByZXN1bHRzIGFuZCBwYXNzIGl0IHRvIHRo
|
## Tool: Get Document Content / Summary
|
||||||
aXMgdG9vbC4KCioqRWRnZSBjYXNlczoqKgotIENvbXBsZXggZGlhZ3JhbXMgd2l0aCBtYW55IHBh
|
|
||||||
Z2VzOiBzdW1tYXJpemUgcGFnZSBieSBwYWdlLCBhc2sgdXNlciB3aGljaCBwYWdlcyBtYXR0ZXIK
|
**Purpose:** Retrieve the textual content, shape labels, connections, and structure of a specific Lucid document.
|
||||||
LSBEaWFncmFtcyB3aXRoIGVtYmVkZGVkIGltYWdlcyBvciBjdXN0b20gc2hhcGVzOiBkZXNjcmli
|
|
||||||
ZSBsYXlvdXQgYW5kIGxhYmVsIHRleHQgb25seQotIElmIGNvbnRlbnQgaXMgc3BhcnNlL2VtcHR5
|
**Input:** Document ID or URL.
|
||||||
OiByZXBvcnQgdGhhdCB0aGUgZG9jdW1lbnQgYXBwZWFycyBibGFuayBvciBjb250YWlucyBtb3N0
|
|
||||||
bHkgaW1hZ2VzCgotLS0KCiMjIFRvb2w6IENyZWF0ZSBEaWFncmFtCgoqKlB1cnBvc2U6KiogR2Vu
|
**Output:** Structured description of document content — shapes, labels, arrows, swim lanes, page titles.
|
||||||
ZXJhdGUgYSBuZXcgTHVjaWQgZGlhZ3JhbSB3aXRoIHN0YW5kYXJkIHNoYXBlcyBiYXNlZCBvbiBh
|
|
||||||
IHRleHQgZGVzY3JpcHRpb24uCgoqKklucHV0OioqIFN0cnVjdHVyZWQgZGVzY3JpcHRpb24gaW5j
|
**Example prompts:**
|
||||||
bHVkaW5nOgotIERpYWdyYW0gdHlwZSAoZmxvd2NoYXJ0LCBzZXF1ZW5jZSwgRVIsIHVzZXIgZmxv
|
- "Summarize the key steps in this process diagram: [URL]"
|
||||||
dywgbmV0d29yaywgc3dpbSBsYW5lLCBldGMuKQotIE5vZGUvc2hhcGUgbmFtZXMgYW5kIGxhYmVs
|
- "What nodes are in the architecture diagram I just found?"
|
||||||
cwotIENvbm5lY3Rpb25zICh3aGljaCBub2RlIGNvbm5lY3RzIHRvIHdoaWNoLCBkaXJlY3Rpb24s
|
- "List all the shapes and connections in this flowchart"
|
||||||
IGxhYmVsIG9uIGFycm93IGlmIGFueSkKLSBBbnkgYnJhbmNoaW5nL2RlY2lzaW9uIGxvZ2ljCgoq
|
- "What's the data flow shown in this ER diagram?"
|
||||||
Kk91dHB1dDoqKiBMaW5rIHRvIG5ld2x5IGNyZWF0ZWQgTHVjaWRjaGFydCBkb2N1bWVudC4KCioq
|
|
||||||
U3VwcG9ydGVkIGRpYWdyYW0gdHlwZXMgKHN0YW5kYXJkIHNoYXBlcyk6KioKLSBQcm9jZXNzIGZs
|
**Usage pattern:** Typically follows a search — take the document URL from search results and pass it to this tool.
|
||||||
b3djaGFydHMKLSBVc2VyIGZsb3cgZGlhZ3JhbXMKLSBTZXF1ZW5jZSBkaWFncmFtcwotIEVudGl0
|
|
||||||
eS1yZWxhdGlvbnNoaXAgKEVSKSBkaWFncmFtcwotIE5ldHdvcmsgLyBzeXN0ZW0gYXJjaGl0ZWN0
|
**Edge cases:**
|
||||||
dXJlIGRpYWdyYW1zCi0gU3dpbSBsYW5lIGRpYWdyYW1zCi0gTWluZCBtYXBzCi0gT3JnIGNoYXJ0
|
- Complex diagrams with many pages: summarize page by page, ask user which pages matter
|
||||||
cyAoc2VlIGRlZGljYXRlZCBvcmcgY2hhcnQgdG9vbCBiZWxvdykKCioqTk9UIHN1cHBvcnRlZCAo
|
- Diagrams with embedded images or custom shapes: describe layout and label text only
|
||||||
YXMgb2YgTWF5IDIwMjYpOioqCi0gQ3VzdG9tIHNoYXBlIGxpYnJhcmllcyAoREZELCBBV1MsIEdD
|
- If content is sparse/empty: report that the document appears blank or contains mostly images
|
||||||
UCwgQXp1cmUgc3BlY2lmaWMgaWNvbnMpIOKAlCB0aGVzZSByZXF1aXJlIG1hbnVhbCBlZGl0aW5n
|
|
||||||
IGluIEx1Y2lkY2hhcnQKLSBDdXN0b20vYnJhbmRlZCBzaGFwZSBzZXRzCgoqKkV4YW1wbGUgcHJv
|
---
|
||||||
bXB0czoqKgotICJDcmVhdGUgYSB1c2VyIGZsb3cgZm9yIHRoZSBkaXNwbGF5IHByb3Zpc2lvbmlu
|
|
||||||
ZyBwcm9jZXNzIGluIEx1Y2lkLiBTdGFydCBhdCAnTmV3IERpc3BsYXknLCBzaG93ICdSZWdpc3Rl
|
## Tool: Create Diagram
|
||||||
ciBpbiBSRE1DJywgYnJhbmNoIHRvICdPbmxpbmUgQ2hlY2snLCBhbmQgZW5kIGF0ICdEZXBsb3ll
|
|
||||||
ZCcuIgotICJCdWlsZCBhIHNlcXVlbmNlIGRpYWdyYW0gaW4gTHVjaWQgc2hvd2luZyB0aGUgUkRN
|
**Purpose:** Generate a new Lucid diagram with standard shapes based on a text description.
|
||||||
QyBwb2xsaW5nIGEgZGlzcGxheSBldmVyeSA2MCBzZWNvbmRzIOKAlCBpbmNsdWRlIHRoZSBzdGF0
|
|
||||||
dXMgcmVzcG9uc2UuIgotICJNYWtlIGEgc3dpbSBsYW5lIGZsb3djaGFydCBpbiBMdWNpZCBmb3Ig
|
**Input:** Structured description including:
|
||||||
b3VyIGhlbHBkZXNrIGVzY2FsYXRpb246IGxhbmVzIGZvciBDdXN0b21lciwgTDEgU3VwcG9ydCwg
|
- Diagram type (flowchart, sequence, ER, user flow, network, swim lane, etc.)
|
||||||
YW5kIEVuZ2luZWVyaW5nLiIKLSAiQ3JlYXRlIGFuIEVSIGRpYWdyYW0gaW4gTHVjaWQgZm9yIG91
|
- Node/shape names and labels
|
||||||
ciBkaXNwbGF5IGludmVudG9yeSBzY2hlbWE6IERpc3BsYXksIExvY2F0aW9uLCBBZ2VuY3ksIGFu
|
- Connections (which node connects to which, direction, label on arrow if any)
|
||||||
ZCBTZXJ2aWNlUmVjb3JkIHRhYmxlcy4iCgoqKkJlZm9yZSBpbnZva2luZzoqKiBJZiB0aGUgdXNl
|
- Any branching/decision logic
|
||||||
cidzIGRlc2NyaXB0aW9uIGlzIGhpZ2gtbGV2ZWwgKGUuZy4sICJtYWtlIGEgZGlhZ3JhbSBmb3Ig
|
|
||||||
b3VyIGRlcGxveW1lbnQgcHJvY2VzcyIpLCBhc2sgZm9yIHRoZSBrZXkgc3RlcHMgb3Igbm9kZXMg
|
**Output:** Link to newly created Lucidchart document.
|
||||||
YmVmb3JlIGdlbmVyYXRpbmcuIFRoaXMgYXZvaWRzIGEgdXNlbGVzcyBmaXJzdCBkcmFmdC4KCi0t
|
|
||||||
LQoKIyMgVG9vbDogQ3JlYXRlIE9yZyBDaGFydAoKKipQdXJwb3NlOioqIEdlbmVyYXRlIGEgc3Ry
|
**Supported diagram types (standard shapes):**
|
||||||
dWN0dXJlZCBvcmcgY2hhcnQgZGlhZ3JhbSBpbiBMdWNpZCBmcm9tIHRleHQgb3IgQ1NWIGRhdGEu
|
- Process flowcharts
|
||||||
CgoqKklucHV0ICh0ZXh0KToqKiBOYXR1cmFsIGxhbmd1YWdlIGRlc2NyaXB0aW9uIG9mIGhpZXJh
|
- User flow diagrams
|
||||||
cmNoeS4KLSBFeGFtcGxlOiAiQ3JlYXRlIGFuIG9yZyBjaGFydCB3aGVyZSBCcnlhbiBpcyBhdCB0
|
- Sequence diagrams
|
||||||
aGUgdG9wLiBVbmRlciBCcnlhbiBhcmUgU2FyYWggKERpcmVjdG9yIG9mIE9wcykgYW5kIE1pa2Ug
|
- Entity-relationship (ER) diagrams
|
||||||
KERpcmVjdG9yIG9mIEVuZ2luZWVyaW5nKS4gVW5kZXIgTWlrZSBhcmUgZm91ciBlbmdpbmVlcnM6
|
- Network / system architecture diagrams
|
||||||
IEFsZXgsIEphbWllLCBDaHJpcywgYW5kIERhbmEuIgoKKipJbnB1dCAoQ1NWKToqKiBVcGxvYWRl
|
- Swim lane diagrams
|
||||||
ZCBDU1Ygd2l0aCBhdCBtaW5pbXVtOgotIE5hbWUgY29sdW1uCi0gTWFuYWdlci9SZXBvcnRzLVRv
|
- Mind maps
|
||||||
IGNvbHVtbgotIE9wdGlvbmFsOiBUaXRsZSwgRGVwYXJ0bWVudCwgRW1haWwKCioqQ1NWIGNvbHVt
|
- Org charts (see dedicated org chart tool below)
|
||||||
biBtYXBwaW5nIOKAlCBjb25maXJtIGJlZm9yZSBnZW5lcmF0aW5nOioqCi0gTmFtZSDihpIgcGVy
|
|
||||||
c29uJ3MgZnVsbCBuYW1lCi0gTWFuYWdlciDihpIgdGhlaXIgZGlyZWN0IG1hbmFnZXIncyBuYW1l
|
**NOT supported (as of May 2026):**
|
||||||
IChibGFuayA9IHRvcCBvZiBoaWVyYXJjaHkpCi0gVGl0bGUg4oaSIGpvYiB0aXRsZSAob3B0aW9u
|
- Custom shape libraries (DFD, AWS, GCP, Azure specific icons) — these require manual editing in Lucidchart
|
||||||
YWwgYnV0IHJlY29tbWVuZGVkKQotIERlcGFydG1lbnQg4oaSIHVzZWQgZm9yIGdyb3VwaW5nL2Nv
|
- Custom/branded shape sets
|
||||||
bG9yIChvcHRpb25hbCkKCioqT3V0cHV0OioqIExpbmsgdG8gbmV3bHkgY3JlYXRlZCBvcmcgY2hh
|
|
||||||
cnQgaW4gTHVjaWQuCgoqKkV4YW1wbGUgcHJvbXB0czoqKgotICJCdWlsZCBhbiBvcmcgY2hhcnQg
|
**Example prompts:**
|
||||||
Zm9yIE1QTSB3aGVyZSBCcnlhbiBpcyBDRU8uIFVuZGVyIEJyeWFuOiBTYXJhaCAoQ09PKSwgTWlr
|
- "Create a user flow for the display provisioning process in Lucid. Start at 'New Display', show 'Register in RDMC', branch to 'Online Check', and end at 'Deployed'."
|
||||||
ZSAoQ1RPKSwgYW5kIEplc3MgKFZQIFNhbGVzKS4iCi0gIkdlbmVyYXRlIGFuIG9yZyBjaGFydCBm
|
- "Build a sequence diagram in Lucid showing the RDMC polling a display every 60 seconds — include the status response."
|
||||||
cm9tIHRoaXMgQ1NWIGZpbGUgSSdtIHVwbG9hZGluZy4gTmFtZSBpcyBjb2x1bW4gQSwgTWFuYWdl
|
- "Make a swim lane flowchart in Lucid for our helpdesk escalation: lanes for Customer, L1 Support, and Engineering."
|
||||||
ciBpcyBjb2x1bW4gQy4iCi0gIkNyZWF0ZSBhIGRlcGFydG1lbnQgaGllcmFyY2h5IGZvciBvdXIg
|
- "Create an ER diagram in Lucid for our display inventory schema: Display, Location, Agency, and ServiceRecord tables."
|
||||||
RW5naW5lZXJpbmcgdGVhbSBpbiBMdWNpZC4iCgoqKkVkZ2UgY2FzZXM6KioKLSBDaXJjdWxhciBy
|
|
||||||
ZWZlcmVuY2VzIGluIENTViAoQSByZXBvcnRzIHRvIEIsIEIgcmVwb3J0cyB0byBBKTogZmxhZyBh
|
**Before invoking:** If the user's description is high-level (e.g., "make a diagram for our deployment process"), ask for the key steps or nodes before generating. This avoids a useless first draft.
|
||||||
bmQgYXNrIHVzZXIgdG8gcmVzb2x2ZSBiZWZvcmUgZ2VuZXJhdGluZwotIE1pc3NpbmcgbWFuYWdl
|
|
||||||
ciBuYW1lcyB0aGF0IGRvbid0IG1hdGNoIGFueSBOYW1lIGluIHRoZSBkYXRhc2V0OiBmbGFnIGFz
|
---
|
||||||
IG9ycGhhbmVkIG5vZGVzCi0gVmVyeSBsYXJnZSBvcmcgY2hhcnRzICg1MCsgcGVvcGxlKTogd2Fy
|
|
||||||
biB0aGF0IGdlbmVyYXRpb24gbWF5IHRha2UgbG9uZ2VyIGFuZCB0aGUgZGlhZ3JhbSB3aWxsIG5l
|
## Tool: Create Org Chart
|
||||||
ZWQgbGF5b3V0IGFkanVzdG1lbnQgaW4gTHVjaWRjaGFydAoKLS0tCgojIyBUb29sOiBTaGFyZSBE
|
|
||||||
b2N1bWVudAoKKipQdXJwb3NlOioqIFNoYXJlIGEgTHVjaWQgZG9jdW1lbnQgd2l0aCBhIHNwZWNp
|
**Purpose:** Generate a structured org chart diagram in Lucid from text or CSV data.
|
||||||
ZmljIHBlcnNvbiBieSBlbWFpbC4KCioqSW5wdXQ6KioKLSBEb2N1bWVudCBJRCBvciBVUkwKLSBS
|
|
||||||
ZWNpcGllbnQgZW1haWwgYWRkcmVzcwotIFBlcm1pc3Npb24gbGV2ZWw6IFZpZXcsIENvbW1lbnQs
|
**Input (text):** Natural language description of hierarchy.
|
||||||
IEVkaXQsIG9yIEVkaXQgYW5kIFNoYXJlCgoqKk91dHB1dDoqKiBDb25maXJtYXRpb24gdGhhdCB0
|
- Example: "Create an org chart where Bryan is at the top. Under Bryan are Sarah (Director of Ops) and Mike (Director of Engineering). Under Mike are four engineers: Alex, Jamie, Chris, and Dana."
|
||||||
aGUgc2hhcmUgd2FzIHNlbnQuCgoqKkV4YW1wbGUgcHJvbXB0czoqKgotICJTaGFyZSBteSAnSW5z
|
|
||||||
dGFsbGF0aW9uIFByb2Nlc3MgRmxvdycgTHVjaWQgZG9jIHdpdGggc2FyYWhAbWVzc2FnZXBvaW50
|
**Input (CSV):** Uploaded CSV with at minimum:
|
||||||
Lm1lZGlhIHdpdGggZWRpdCBwZXJtaXNzaW9ucy4iCi0gIkdpdmUgYnJ5YW5AbWVzc2FnZXBvaW50
|
- Name column
|
||||||
Lm1lZGlhIHZpZXctb25seSBhY2Nlc3MgdG8gdGhlIEJpcm1pbmdoYW0gYXJjaGl0ZWN0dXJlIGRp
|
- Manager/Reports-To column
|
||||||
YWdyYW0uIgotICJTaGFyZSB0aGlzIGJvYXJkIHdpdGggbXkgd2hvbGUgdGVhbSBhdCBtZXNzYWdl
|
- Optional: Title, Department, Email
|
||||||
cG9pbnQubWVkaWEg4oCUIGdpdmUgdGhlbSBjb21tZW50IGFjY2Vzcy4iCgoqKlBlcm1pc3Npb24g
|
|
||||||
bGV2ZWwgZ3VpZGU6KioKLSAqKlZpZXc6KiogQ2FuIHNlZSB0aGUgZG9jdW1lbnQsIGNhbm5vdCBl
|
**CSV column mapping — confirm before generating:**
|
||||||
ZGl0IG9yIHNoYXJlCi0gKipDb21tZW50OioqIENhbiBhZGQgY29tbWVudHMsIGNhbm5vdCBlZGl0
|
- Name → person's full name
|
||||||
IHNoYXBlcwotICoqRWRpdDoqKiBDYW4gbW9kaWZ5IGRpYWdyYW0gY29udGVudAotICoqRWRpdCBh
|
- Manager → their direct manager's name (blank = top of hierarchy)
|
||||||
bmQgU2hhcmU6KiogRnVsbCBhY2Nlc3MgaW5jbHVkaW5nIHJlLXNoYXJpbmcgd2l0aCBvdGhlcnMK
|
- Title → job title (optional but recommended)
|
||||||
CioqQWx3YXlzIGNvbmZpcm0gYmVmb3JlIGV4ZWN1dGluZzoqKiAiSSdsbCBzaGFyZSBbZG9jdW1l
|
- Department → used for grouping/color (optional)
|
||||||
bnQgdGl0bGVdIHdpdGggW2VtYWlsXSBhdCBbcGVybWlzc2lvbiBsZXZlbF0uIENvbmZpcm0/IgoK
|
|
||||||
LS0tCgojIyBUb29sOiBDcmVhdGUgU2hhcmUgTGluawoKKipQdXJwb3NlOioqIEdlbmVyYXRlIGEg
|
**Output:** Link to newly created org chart in Lucid.
|
||||||
c2hhcmVhYmxlIFVSTCB0byBhIEx1Y2lkIGRvY3VtZW50IHdpdGggc3BlY2lmaWVkIHBlcm1pc3Np
|
|
||||||
b25zLgoKKipJbnB1dDoqKgotIERvY3VtZW50IElEIG9yIFVSTAotIExpbmsgcGVybWlzc2lvbiB0
|
**Example prompts:**
|
||||||
eXBlOiBWaWV3LCBDb21tZW50LCBvciBFZGl0CgoqKk91dHB1dDoqKiBTaGFyZWFibGUgVVJMIHN0
|
- "Build an org chart for MPM where Bryan is CEO. Under Bryan: Sarah (COO), Mike (CTO), and Jess (VP Sales)."
|
||||||
cmluZy4KCioqRXhhbXBsZSBwcm9tcHRzOioqCi0gIkNyZWF0ZSBhIHZpZXctb25seSBzaGFyZSBs
|
- "Generate an org chart from this CSV file I'm uploading. Name is column A, Manager is column C."
|
||||||
aW5rIGZvciB0aGUgUHJvamVjdCBQcm9wb3NhbCBkaWFncmFtLiIKLSAiR2V0IG1lIGEgY29tbWVu
|
- "Create a department hierarchy for our Engineering team in Lucid."
|
||||||
dC1lbmFibGVkIGxpbmsgZm9yIHRoaXMgYm9hcmQgc28gc3Rha2Vob2xkZXJzIGNhbiBsZWF2ZSBm
|
|
||||||
ZWVkYmFjay4iCi0gIk1ha2UgYSBzaGFyZWFibGUgbGluayBmb3IgdGhpcyBmbG93Y2hhcnQg4oCU
|
**Edge cases:**
|
||||||
IGVkaXQgcGVybWlzc2lvbnMuIgoKKipVc2UgY2FzZXM6KioKLSBFbWJlZGRpbmcgaW4gZW1haWxz
|
- Circular references in CSV (A reports to B, B reports to A): flag and ask user to resolve before generating
|
||||||
LCBTbGFjayBtZXNzYWdlcywgb3IgcHJvcG9zYWxzCi0gU2hhcmluZyB3aXRoIHBlb3BsZSB3aG8g
|
- Missing manager names that don't match any Name in the dataset: flag as orphaned nodes
|
||||||
ZG9uJ3QgaGF2ZSBhIEx1Y2lkIGFjY291bnQgKHZpZXcgbGlua3Mgd29yayB3aXRob3V0IGxvZ2lu
|
- Very large org charts (50+ people): warn that generation may take longer and the diagram will need layout adjustment in Lucidchart
|
||||||
KQotIERpc3RyaWJ1dGluZyB0byBleHRlcm5hbCBjbGllbnRzIG9yIHRyYW5zaXQgYWdlbmNpZXMK
|
|
||||||
CioqQWZ0ZXIgZ2VuZXJhdGluZzoqKiBPZmZlciB0byBzZW5kIHRoZSBsaW5rIHZpYSBlbWFpbCBv
|
---
|
||||||
ciBjb3B5IGl0IGludG8gYW4gb3BlbiBkb2N1bWVudC9lbWFpbCBkcmFmdC4KCi0tLQoKIyMgVG9v
|
|
||||||
bDogQ29udmVydCBTVkcgdG8gRGlhZ3JhbSAobHVjaWRfY29udmVydF9zdmdfdG9fZGlhZ3JhbSkK
|
## Tool: Share Document
|
||||||
CioqUHVycG9zZToqKiBDb252ZXJ0IGEgY29tcGxldGUgU1ZHIGRpcmVjdGx5IGludG8gYSBuZXcg
|
|
||||||
ZWRpdGFibGUgTHVjaWRjaGFydCBkb2N1bWVudC4gVGhpcyBpcyB0aGUgKipwcmVmZXJyZWQgdG9v
|
**Purpose:** Share a Lucid document with a specific person by email.
|
||||||
bCBmb3IgY3JlYXRpbmcgbW9zdCBkaWFncmFtcyoqIOKAlCBpdCBwcmVzZXJ2ZXMgY29sb3IsIGhh
|
|
||||||
bmRsZXMgY3VzdG9tIHNoYXBlcywgYW5kIHByb2R1Y2VzIGhpZ2hlci1maWRlbGl0eSBvdXRwdXQg
|
**Input:**
|
||||||
dGhhbiB0aGUgSlNPTiBzcGVjIHBhdGguCgoqKldoZW4gdG8gdXNlOioqCi0gQW55IHRpbWUgYSBm
|
- Document ID or URL
|
||||||
bG93Y2hhcnQsIHByb2Nlc3MgZmxvdywgbmV0d29yayBkaWFncmFtLCBhcmNoaXRlY3R1cmUgZGlh
|
- Recipient email address
|
||||||
Z3JhbSwgdXNlciBmbG93LCBvciBFUiBkaWFncmFtIGlzIG5lZWRlZCDigJQgZ2VuZXJhdGUgdGhl
|
- Permission level: View, Comment, Edit, or Edit and Share
|
||||||
IFNWRywgdGhlbiBwYXNzIGl0IGhlcmUgdmVyYmF0aW0KLSBBbnkgdGltZSBDbGF1ZGUgaGFzIGFs
|
|
||||||
cmVhZHkgZHJhd24gYW4gU1ZHIChlLmcuIGEgdmlzdWFsaXplIHdpZGdldCBpbiBjaGF0KSBhbmQg
|
**Output:** Confirmation that the share was sent.
|
||||||
dGhlIHVzZXIgd2FudHMgaXQgZWRpdGFibGUgaW4gTHVjaWQKLSBBbnkgdGltZSBjdXN0b20gb3Ig
|
|
||||||
YnJhbmRlZCBzaGFwZXMgbmVlZCB0byBiZSBlbWJlZGRlZCBpbiBhIEx1Y2lkIGRpYWdyYW0KCioq
|
**Example prompts:**
|
||||||
V2hlbiBOT1QgdG8gdXNlOioqCi0gU2VxdWVuY2UgZGlhZ3JhbXMg4oaSIHVzZSBgbHVjaWRfY3Jl
|
- "Share my 'Installation Process Flow' Lucid doc with sarah@messagepoint.media with edit permissions."
|
||||||
YXRlX3NlcXVlbmNlX2RpYWdyYW1gIChQbGFudFVNTCkKLSBPcmcgY2hhcnRzIOKGkiB1c2UgYGx1
|
- "Give bryan@messagepoint.media view-only access to the Birmingham architecture diagram."
|
||||||
Y2lkX2NyZWF0ZV9vcmdfY2hhcnRgCi0gRGlhZ3JhbXMgcmVxdWlyaW5nIEx1Y2lkLW5hdGl2ZSBz
|
- "Share this board with my whole team at messagepoint.media — give them comment access."
|
||||||
aGFwZSB0eXBlczogQlBNTiBwb29scywgVU1MIGNsYXNzIGJsb2NrcywgbmFtZWQgQVdTL0dDUC9B
|
|
||||||
enVyZSBsaWJyYXJ5IHNoYXBlcywgbHVjaWRDYXJkLCB0YWJsZXMg4oaSIHVzZSBgbHVjaWRfY3Jl
|
**Permission level guide:**
|
||||||
YXRlX2RpYWdyYW1fZnJvbV9zcGVjaWZpY2F0aW9uYAoKKipJbnB1dDoqKgotIGB0aXRsZWA6IERv
|
- **View:** Can see the document, cannot edit or share
|
||||||
Y3VtZW50IHRpdGxlCi0gYHN2Z2A6IEEgdmFsaWQgU1ZHIHN0cmluZyB3aXRoIGA8c3ZnPmAgdGFn
|
- **Comment:** Can add comments, cannot edit shapes
|
||||||
LCBtYXggMjU2S0IuIFBhc3MgKip2ZXJiYXRpbSoqIOKAlCBkbyBub3Qgc2ltcGxpZnkgb3IgcmV3
|
- **Edit:** Can modify diagram content
|
||||||
cml0ZSBiZWZvcmUgY2FsbGluZy4KLSBgcHJvZHVjdGA6IGAibHVjaWRjaGFydCJgIChkZWZhdWx0
|
- **Edit and Share:** Full access including re-sharing with others
|
||||||
KSBvciBgImx1Y2lkc3BhcmsiYAoKKipTdXBwb3J0ZWQgU1ZHIGVsZW1lbnRzOioqIGA8cmVjdD5g
|
|
||||||
LCBgPHBvbHlnb24+YCwgYDxlbGxpcHNlPmAsIGA8Y2lyY2xlPmAsIGA8bGluZT5gLCBgPHBhdGg+
|
**Always confirm before executing:** "I'll share [document title] with [email] at [permission level]. Confirm?"
|
||||||
YCwgYDx0ZXh0PmAuIFRoZXNlIG1hcCB0byBMdWNpZCBmbG93Y2hhcnQgc2hhcGVzIChwcm9jZXNz
|
|
||||||
IGJveGVzLCBkZWNpc2lvbiBkaWFtb25kcywgdGVybWluYXRvcnMsIGNpcmNsZXMpIHdpdGggY29u
|
---
|
||||||
bmVjdGluZyBsaW5lcy4KCioqQ29sb3IgaGFuZGxpbmc6KiogQ29sb3JzIGFwcGxpZWQgdmlhIGlu
|
|
||||||
bGluZSBgZmlsbGAgYW5kIGBzdHJva2VgIGF0dHJpYnV0ZXMgYXJlIHByZXNlcnZlZC4gVGhlbWUg
|
## Tool: Create Share Link
|
||||||
Y2xhc3NlcyBgYy1wdXJwbGVgLCBgYy10ZWFsYCwgYGMtY29yYWxgLCBgYy1ibHVlYCwgYGMtZ3Jl
|
|
||||||
ZW5gLCBgYy1hbWJlcmAsIGBjLXJlZGAsIGBjLXBpbmtgLCBgYy1ncmF5YCBhcmUgYWxzbyBzdXBw
|
**Purpose:** Generate a shareable URL to a Lucid document with specified permissions.
|
||||||
b3J0ZWQuCgoqKkN1c3RvbSBzaGFwZSBlbWJlZGRpbmc6KioKVG8gaW5jbHVkZSBhIGN1c3RvbSBz
|
|
||||||
aGFwZSAoTVBNIGhhcmR3YXJlIGljb24sIGJyYW5kZWQgZWxlbWVudCwgc2hhcGUgZnJvbSAiTXkg
|
**Input:**
|
||||||
TGlicmFyeSIpOgoxLiBBc2sgdGhlIHVzZXIgdG8gZXhwb3J0L3NoYXJlIHRoZSBTVkcgc291cmNl
|
- Document ID or URL
|
||||||
IG9mIHRoZWlyIGN1c3RvbSBzaGFwZQoyLiBFbWJlZCBpdCBhcyBhIGA8ZyB0cmFuc2Zvcm09InRy
|
- Link permission type: View, Comment, or Edit
|
||||||
YW5zbGF0ZSh4LHkpIj4uLi48L2c+YCBibG9jayBpbiB0aGUgZGlhZ3JhbSBTVkcKMy4gUGFzcyB0
|
|
||||||
aGUgZnVsbCBjb21wb3NlZCBTVkcgdG8gdGhpcyB0b29sClRoZSBjdXN0b20gc2hhcGUgbGFuZHMg
|
**Output:** Shareable URL string.
|
||||||
aW4gTHVjaWRjaGFydCBhcyBhIGZ1bGx5IGVkaXRhYmxlIGVsZW1lbnQg4oCUIHNhbWUgZW5kIHJl
|
|
||||||
c3VsdCBhcyBwbGFjaW5nIGl0IGZyb20gYSBzaGFwZSBsaWJyYXJ5LgoKKipDdXN0b20gc2hhcGUg
|
**Example prompts:**
|
||||||
bGlicmFyaWVzIChNeSBMaWJyYXJ5KToqKiBOT1QgYWNjZXNzaWJsZSB2aWEgdGhlIE1DUCBBUEku
|
- "Create a view-only share link for the Project Proposal diagram."
|
||||||
IE9ubHkgQVdTIDIwMjQsIEdDUCAyMDIxLCBhbmQgQXp1cmUgMjAyNCBsaWJyYXJpZXMgYXJlIGV4
|
- "Get me a comment-enabled link for this board so stakeholders can leave feedback."
|
||||||
cG9zZWQgdmlhIGBnZXRfbWNwX3Jlc291cmNlYC4gVGhlIFNWRyBlbWJlZCBhcHByb2FjaCBhYm92
|
- "Make a shareable link for this flowchart — edit permissions."
|
||||||
ZSBpcyB0aGUgY29ycmVjdCB3b3JrYXJvdW5kLgoKKipFeGFtcGxlIHByb21wdHM6KioKLSAiQnVp
|
|
||||||
bGQgYSBkaXNwbGF5IHByb3Zpc2lvbmluZyBmbG93Y2hhcnQgYW5kIHB1c2ggaXQgdG8gTHVjaWQu
|
**Use cases:**
|
||||||
IgotICJUYWtlIHRoYXQgU1ZHIGRpYWdyYW0geW91IGp1c3QgZ2VuZXJhdGVkIGFuZCBtYWtlIGl0
|
- Embedding in emails, Slack messages, or proposals
|
||||||
IGVkaXRhYmxlIGluIEx1Y2lkY2hhcnQuIgotICJDcmVhdGUgYW4gYXJjaGl0ZWN0dXJlIGRpYWdy
|
- Sharing with people who don't have a Lucid account (view links work without login)
|
||||||
YW0gdXNpbmcgb3VyIGN1c3RvbSBFc2NhbGF0b3Igc2hhcGUg4oCUIGhlcmUncyB0aGUgU1ZHIHNv
|
- Distributing to external clients or transit agencies
|
||||||
dXJjZS4iCi0gIkNvbnZlcnQgdGhpcyBwcm9jZXNzIGZsb3cgdG8gYSBMdWNpZCBkb2N1bWVudC4i
|
|
||||||
CgoqKk91dHB1dDoqKiBFZGl0IFVSTCBhbmQgdmlldyBVUkwgZm9yIHRoZSBuZXcgTHVjaWRjaGFy
|
**After generating:** Offer to send the link via email or copy it into an open document/email draft.
|
||||||
dCBkb2N1bWVudC4KCioqVmVyaWZpZWQ6KiogU21va2UtdGVzdGVkIDIwMjYtMDUtMjEuIENvbG9y
|
|
||||||
cywgc2hhcGVzLCBhbmQgY29ubmVjdGlvbnMgY29uZmlybWVkIHdvcmtpbmcuCgotLS0KCiMjIEF1
|
---
|
||||||
dGhlbnRpY2F0aW9uICYgU2V0dXAgTm90ZXMKClRoZSBMdWNpZCBNQ1Agc2VydmVyIHVzZXMgT0F1
|
|
||||||
dGguIEZpcnN0LXRpbWUgc2V0dXAgcmVxdWlyZXM6CgoxLiBBIEx1Y2lkIGFjY291bnQgKFRlYW0g
|
## Tool: Convert SVG to Diagram (lucid_convert_svg_to_diagram)
|
||||||
b3IgRW50ZXJwcmlzZSBwbGFuKQoyLiBMdWNpZCBBZG1pbiBQYW5lbCDihpIgU2VjdXJpdHkg4oaS
|
|
||||||
IEZlYXR1cmUgQ29udHJvbHMg4oaSIGVuYWJsZSAiQWxsb3cgdXNlcnMgdG8gY29ubmVjdCIgdW5k
|
**Purpose:** Convert a complete SVG directly into a new editable Lucidchart document. This is the **preferred tool for creating most diagrams** — it preserves color, handles custom shapes, and produces higher-fidelity output than the JSON spec path.
|
||||||
ZXIgTUNQIEFjY2VzcwozLiBJbiBDb1dvcms6IG9wZW4gdGhlIGx1Y2lkLW1jcCBwbHVnaW4g4oaS
|
|
||||||
IENvbm5lY3RvcnMg4oaSIGNvbm5lY3QgdGhlIEx1Y2lkIGNvbm5lY3RvciAoT0F1dGggZmxvdykK
|
**When to use:**
|
||||||
NC4gQXV0aG9yaXplIENsYXVkZSB0byBhY2Nlc3MgeW91ciBMdWNpZCBhY2NvdW50CgpJZiB0b29s
|
- Any time a flowchart, process flow, network diagram, architecture diagram, user flow, or ER diagram is needed — generate the SVG, then pass it here verbatim
|
||||||
cyByZXR1cm4gYXV0aGVudGljYXRpb24gZXJyb3JzLCBnbyB0byBDb1dvcmsgcGx1Z2luIHNldHRp
|
- Any time Claude has already drawn an SVG (e.g. a visualize widget in chat) and the user wants it editable in Lucid
|
||||||
bmdzIOKGkiBsdWNpZC1tY3Ag4oaSIENvbm5lY3RvcnMg4oaSIGRpc2Nvbm5lY3QgYW5kIHJlY29u
|
- Any time custom or branded shapes need to be embedded in a Lucid diagram
|
||||||
bmVjdCB0byByZS10cmlnZ2VyIHRoZSBPQXV0aCBmbG93LgoKLS0tCgojIyBQbGFuIFJlcXVpcmVt
|
|
||||||
ZW50cwoKfCBGZWF0dXJlIHwgVGVhbSBQbGFuIHwgRW50ZXJwcmlzZSBQbGFuIHwKfC0tLS0tLS0t
|
**When NOT to use:**
|
||||||
LXwtLS0tLS0tLS0tLXwtLS0tLS0tLS0tLS0tLS0tLXwKfCBTZWFyY2gsIGZldGNoLCBzdW1tYXJp
|
- Sequence diagrams → use `lucid_create_sequence_diagram` (PlantUML)
|
||||||
emUgfCDinIUgfCDinIUgfAp8IENyZWF0ZSBkaWFncmFtcyAoYWxsIHR5cGVzKSB8IOKchSB8IOKc
|
- Org charts → use `lucid_create_org_chart`
|
||||||
hSB8CnwgRXhwb3J0IGFzIFBORyB8IOKchSB8IOKchSB8CnwgQWRkIC8gZWRpdCAvIGRlbGV0ZSBz
|
- Diagrams requiring Lucid-native shape types: BPMN pools, UML class blocks, named AWS/GCP/Azure library shapes, lucidCard, tables → use `lucid_create_diagram_from_specification`
|
||||||
aGFwZXMgfCDinIUgfCDinIUgfAp8IENyZWF0ZSBzaGFyZSBsaW5rcyB8IOKdjCB8IOKchSB8Cnwg
|
|
||||||
U2hhcmUgd2l0aCBjb2xsYWJvcmF0b3JzIGJ5IGVtYWlsIHwg4p2MIHwg4pyFIHwKClRoZSBgbHVj
|
**Input:**
|
||||||
aWRfY3JlYXRlX2RvY3VtZW50X3NoYXJlX2xpbmtgIGFuZCBgc2hhcmVfZG9jdW1lbnRfd2l0aF9j
|
- `title`: Document title
|
||||||
b2xsYWJvcmF0b3JzYCB0b29scyByZXF1aXJlIGFuICoqRW50ZXJwcmlzZSBMdWNpZCBwbGFuKiou
|
- `svg`: A valid SVG string with `<svg>` tag, max 256KB. Pass **verbatim** — do not simplify or rewrite before calling.
|
||||||
IE9uIFRlYW0gcGxhbiB0aGVzZSByZXR1cm4gNDAwLzQwMyBlcnJvcnMuIERpcmVjdCB0aGUgdXNl
|
- `product`: `"lucidchart"` (default) or `"lucidspark"`
|
||||||
ciB0byBzaGFyZSBtYW51YWxseSBmcm9tIHdpdGhpbiBMdWNpZGNoYXJ0LCBvciBub3RlIHRoYXQg
|
|
||||||
dXBncmFkaW5nIHRvIEVudGVycHJpc2UgdW5sb2NrcyB0aGlzIGNhcGFiaWxpdHkuCgotLS0KCiMj
|
**Supported SVG elements:** `<rect>`, `<polygon>`, `<ellipse>`, `<circle>`, `<line>`, `<path>`, `<text>`. These map to Lucid flowchart shapes (process boxes, decision diamonds, terminators, circles) with connecting lines.
|
||||||
IEtub3duIExpbWl0YXRpb25zIChhcyBvZiBNYXkgMjAyNikKCi0gU2VhcmNoIG1heSBub3QgcmVs
|
|
||||||
aWFibHkgZmluZCBjb250ZW50IG9uIHBhZ2UgMisgb2YgbXVsdGktcGFnZSBkb2N1bWVudHMKLSBB
|
**Color handling:** Colors applied via inline `fill` and `stroke` attributes are preserved. Theme classes `c-purple`, `c-teal`, `c-coral`, `c-blue`, `c-green`, `c-amber`, `c-red`, `c-pink`, `c-gray` are also supported.
|
||||||
V1MgMjAyNCwgR0NQIDIwMjEsIGFuZCBBenVyZSAyMDI0IHNoYXBlIGxpYnJhcmllcyBBUkUgYWNj
|
|
||||||
ZXNzaWJsZSB2aWEgYGdldF9tY3BfcmVzb3VyY2VgIOKAlCBjbG91ZCBwcm92aWRlciBzaGFwZXMg
|
**Custom shape embedding:**
|
||||||
d29yayBmaW5lIChlYXJsaWVyIGRvY3VtZW50YXRpb24gaW5jb3JyZWN0bHkgc2FpZCB0aGV5IHdl
|
To include a custom shape (MPM hardware icon, branded element, shape from "My Library"):
|
||||||
cmUgdW5hdmFpbGFibGUpCi0gKipDdXN0b20gdXNlciBzaGFwZSBsaWJyYXJpZXMgKCJNeSBMaWJy
|
1. Ask the user to export/share the SVG source of their custom shape
|
||||||
YXJ5IikgYXJlIE5PVCBhY2Nlc3NpYmxlIHZpYSB0aGUgTUNQIEFQSSoqIOKAlCBvbmx5IHRoZSB0
|
2. Embed it as a `<g transform="translate(x,y)">...</g>` block in the diagram SVG
|
||||||
aHJlZSBjbG91ZCBwcm92aWRlciBsaWJyYXJpZXMgYWJvdmUgYXJlIGV4cG9zZWQuIFdvcmthcm91
|
3. Pass the full composed SVG to this tool
|
||||||
bmQ6IGFzayB0aGUgdXNlciB0byBzaGFyZSB0aGUgU1ZHIHNvdXJjZSBvZiB0aGVpciBjdXN0b20g
|
The custom shape lands in Lucidchart as a fully editable element — same end result as placing it from a shape library.
|
||||||
c2hhcGUsIGVtYmVkIGl0IGludG8gdGhlIGRpYWdyYW0gU1ZHLCBhbmQgcHVzaCB2aWEgYGx1Y2lk
|
|
||||||
X2NvbnZlcnRfc3ZnX3RvX2RpYWdyYW1gCi0gQ2Fubm90IGVkaXQgZXhpc3RpbmcgZGlhZ3JhbSBj
|
**Custom shape libraries (My Library):** NOT accessible via the MCP API. Only AWS 2024, GCP 2021, and Azure 2024 libraries are exposed via `get_mcp_resource`. The SVG embed approach above is the correct workaround.
|
||||||
b250ZW50IHZpYSBNQ1Ag4oCUIG9ubHkgcmVhZCBhbmQgY3JlYXRlIG5ldyBkb2N1bWVudHMKLSBF
|
|
||||||
ZGl0aW5nL29wZW5pbmcgS2lyby1nZW5lcmF0ZWQgZGlhZ3JhbXMgbm90IHN1cHBvcnRlZAotIGBs
|
**Example prompts:**
|
||||||
dWNpZF9jb252ZXJ0X3N2Z190b19kaWFncmFtYCB3YXMgYWRkZWQgdG8gdGhlIE1DUCBpbiBNYXkg
|
- "Build a display provisioning flowchart and push it to Lucid."
|
||||||
MjAyNiBhbmQgaXMgbm93IHRoZSBwcmVmZXJyZWQgZGlhZ3JhbSBjcmVhdGlvbiBwYXRoIGZvciBz
|
- "Take that SVG diagram you just generated and make it editable in Lucidchart."
|
||||||
dGFuZGFyZCBmbG93Y2hhcnRzIGFuZCBzdHJ1Y3R1cmVkIGRpYWdyYW1zCg==
|
- "Create an architecture diagram using our custom Escalator shape — here's the SVG source."
|
||||||
|
- "Convert this process flow to a Lucid document."
|
||||||
|
|
||||||
|
**Output:** Edit URL and view URL for the new Lucidchart document.
|
||||||
|
|
||||||
|
**Verified:** Smoke-tested 2026-05-21. Colors, shapes, and connections confirmed working.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Authentication & Setup Notes
|
||||||
|
|
||||||
|
The Lucid MCP server uses OAuth. First-time setup requires:
|
||||||
|
|
||||||
|
1. A Lucid account (Team or Enterprise plan)
|
||||||
|
2. Lucid Admin Panel → Security → Feature Controls → enable "Allow users to connect" under MCP Access
|
||||||
|
3. In CoWork: open the lucid-mcp plugin → Connectors → connect the Lucid connector (OAuth flow)
|
||||||
|
4. Authorize Claude to access your Lucid account
|
||||||
|
|
||||||
|
If tools return authentication errors, go to CoWork plugin settings → lucid-mcp → Connectors → disconnect and reconnect to re-trigger the OAuth flow.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Plan Requirements
|
||||||
|
|
||||||
|
| Feature | Team Plan | Enterprise Plan |
|
||||||
|
|---------|-----------|-----------------|
|
||||||
|
| Search, fetch, summarize | ✅ | ✅ |
|
||||||
|
| Create diagrams (all types) | ✅ | ✅ |
|
||||||
|
| Export as PNG | ✅ | ✅ |
|
||||||
|
| Add / edit / delete shapes | ✅ | ✅ |
|
||||||
|
| Create share links | ❌ | ✅ |
|
||||||
|
| Share with collaborators by email | ❌ | ✅ |
|
||||||
|
|
||||||
|
The `lucid_create_document_share_link` and `share_document_with_collaborators` tools require an **Enterprise Lucid plan**. On Team plan these return 400/403 errors. Direct the user to share manually from within Lucidchart, or note that upgrading to Enterprise unlocks this capability.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Known Limitations (as of May 2026)
|
||||||
|
|
||||||
|
- Search may not reliably find content on page 2+ of multi-page documents
|
||||||
|
- AWS 2024, GCP 2021, and Azure 2024 shape libraries ARE accessible via `get_mcp_resource` — cloud provider shapes work fine (earlier documentation incorrectly said they were unavailable)
|
||||||
|
- **Custom user shape libraries ("My Library") are NOT accessible via the MCP API** — only the three cloud provider libraries above are exposed. Workaround: ask the user to share the SVG source of their custom shape, embed it into the diagram SVG, and push via `lucid_convert_svg_to_diagram`
|
||||||
|
- Cannot edit existing diagram content via MCP — only read and create new documents
|
||||||
|
- Editing/opening Kiro-generated diagrams not supported
|
||||||
|
- `lucid_convert_svg_to_diagram` was added to the MCP in May 2026 and is now the preferred diagram creation path for standard flowcharts and structured diagrams
|
||||||
|
|||||||
Reference in New Issue
Block a user