diff --git a/README.md b/README.md
index 170a4b6..fd9b10d 100644
--- a/README.md
+++ b/README.md
@@ -1,56 +1,79 @@
-IyBsdWNpZC1tY3AgUGx1Z2luCgpDb25uZWN0IENvV29yayB0byB0aGUgTHVjaWQgTUNQIHNlcnZl
-ciDigJQgc2VhcmNoIGRvY3VtZW50cywgZ2VuZXJhdGUgZGlhZ3JhbXMsIGJ1aWxkIG9yZyBjaGFy
-dHMsIGFuZCBzaGFyZSBMdWNpZGNoYXJ0L0x1Y2lkc3BhcmsgY29udGVudCB3aXRob3V0IGxlYXZp
-bmcgQ2xhdWRlLgoKIyMgT3ZlcnZpZXcKClRoaXMgcGx1Z2luIHdpcmVzIHRoZSBvZmZpY2lhbCBb
-THVjaWQgTUNQIFNlcnZlcl0oaHR0cHM6Ly9tY3AubHVjaWQuYXBwL21jcCkgaW50byBDb1dvcmss
-IGdpdmluZyBDbGF1ZGUgZGlyZWN0IGFjY2VzcyB0byB5b3VyIEx1Y2lkIGFjY291bnQuIFlvdSBj
-YW4gZGVzY3JpYmUgd2hhdCB5b3Ugd2FudCBpbiBwbGFpbiBsYW5ndWFnZSBhbmQgQ2xhdWRlIHdp
-bGwgc2VhcmNoLCBjcmVhdGUsIG9yIHNoYXJlIEx1Y2lkIGNvbnRlbnQgb24geW91ciBiZWhhbGYu
-CgojIyBDb21wb25lbnRzCgp8IENvbXBvbmVudCB8IFR5cGUgfCBQdXJwb3NlIHwKfC0tLS0tLS0t
-LS0tfC0tLS0tLXwtLS0tLS0tLS18CnwgYGx1Y2lkYCBza2lsbCB8IFNraWxsIHwgR3VpZGVzIENs
-YXVkZSBvbiB3aGVuIGFuZCBob3cgdG8gdXNlIGVhY2ggTHVjaWQgdG9vbCB8CnwgTHVjaWQgTUNQ
-IFNlcnZlciB8IE1DUCAoSFRUUC9PQXV0aCkgfCBMaXZlIGNvbm5lY3Rpb24gdG8gYGh0dHBzOi8v
-bWNwLmx1Y2lkLmFwcC9tY3BgIHwKCiMjIFNldHVwCgojIyMgUHJlcmVxdWlzaXRlcwotIEEgTHVj
-aWQgYWNjb3VudCAoVGVhbSBvciBFbnRlcnByaXNlIHBsYW4pCi0gQWRtaW4gUGFuZWwgYWNjZXNz
-CgojIyMgU3RlcHMKCjEuICoqRW5hYmxlIE1DUCBhY2Nlc3MgaW4gTHVjaWQgQWRtaW4gUGFuZWwq
-KgogICAtIExvZyBpbiB0byBMdWNpZCDihpIgQWRtaW4g4oaSIFNlY3VyaXR5IOKGkiBGZWF0dXJl
-IENvbnRyb2xzCiAgIC0gVW5kZXIgIk1DUCBBY2Nlc3MiLCB0b2dnbGUgb24gKipBbGxvdyB1c2Vy
-cyB0byBjb25uZWN0KioKCjIuICoqQ29ubmVjdCBpbiBDb1dvcmsqKgogICAtIEluc3RhbGwgdGhp
-cyBwbHVnaW4KICAgLSBHbyB0byBwbHVnaW4gc2V0dGluZ3Mg4oaSIGx1Y2lkLW1jcCDihpIgQ29u
-bmVjdG9ycyDihpIgY29ubmVjdCBMdWNpZAogICAtIENvbXBsZXRlIHRoZSBPQXV0aCBmbG93IGlu
-IHlvdXIgYnJvd3NlcgogICAtIElmIHRoZSBicm93c2VyIHNob3dzIGEgbG9jYWxob3N0IGVycm9y
-IHBhZ2UsIGNvcHkgdGhlIGZ1bGwgVVJMIGZyb20gdGhlIGFkZHJlc3MgYmFyIGFuZCBwYXN0ZSBp
-dCBiYWNrIGludG8gQ29Xb3JrCgozLiAqKlZlcmlmeSoqCiAgIC0gVHJ5OiAiRmluZCBteSBtb3N0
-IHJlY2VudCBMdWNpZGNoYXJ0IGRpYWdyYW0iCiAgIC0gQ2xhdWRlIHNob3VsZCByZXR1cm4gbWF0
-Y2hpbmcgZG9jdW1lbnRzIHdpdGggbGlua3MKCiMjIFVzYWdlCgojIyMgU2VhcmNoICYgU3VtbWFy
-aXplCi0gIkZpbmQgbXkgQmlybWluZ2hhbSBkZXBsb3ltZW50IGFyY2hpdGVjdHVyZSBkaWFncmFt
-IgotICJTdW1tYXJpemUgdGhlIHByb2Nlc3MgZmxvdyBJIGhhdmUgZm9yIGRpc3BsYXkgaW5zdGFs
-bGF0aW9uIgotICJXaGF0J3MgaW4gdGhlIFJETUMgaW50ZWdyYXRpb24gZGlhZ3JhbT8iCgojIyMg
-Q3JlYXRlIERpYWdyYW1zCi0gIkJ1aWxkIGEgZmxvd2NoYXJ0IGluIEx1Y2lkIGZvciBvdXIgZGlz
-cGxheSBwcm92aXNpb25pbmcgcHJvY2VzcyIKLSAiQ3JlYXRlIGEgc2VxdWVuY2UgZGlhZ3JhbSBz
-aG93aW5nIFJETUMgcG9sbGluZyBlYWNoIGRpc3BsYXkgZXZlcnkgNjAgc2Vjb25kcyIKLSAiTWFr
-ZSBhIHN3aW0gbGFuZSBkaWFncmFtIGZvciBvdXIgaGVscGRlc2sgZXNjYWxhdGlvbiDigJQgbGFu
-ZXMgZm9yIEN1c3RvbWVyLCBMMSwgYW5kIEVuZ2luZWVyaW5nIgotICJHZW5lcmF0ZSBhbiBFUiBk
-aWFncmFtIGZvciBvdXIgaW52ZW50b3J5IHNjaGVtYTogRGlzcGxheSwgTG9jYXRpb24sIEFnZW5j
-eSwgU2VydmljZVJlY29yZCIKCiMjIyBDcmVhdGUgT3JnIENoYXJ0cwotICJCdWlsZCBhbiBvcmcg
-Y2hhcnQgd2hlcmUgQnJ5YW4gaXMgQ0VPLCB3aXRoIFNhcmFoLCBNaWtlLCBhbmQgSmVzcyByZXBv
-cnRpbmcgdG8gaGltIgotICJDcmVhdGUgYW4gb3JnIGNoYXJ0IGZyb20gdGhpcyBDU1YgZmlsZSDi
-gJQgTmFtZSBpcyBjb2x1bW4gQSwgTWFuYWdlciBpcyBjb2x1bW4gQyIKCiMjIyBTaGFyZQotICJT
-aGFyZSB0aGUgUHJvamVjdCBQcm9wb3NhbCBkaWFncmFtIHdpdGggc2FyYWhAbWVzc2FnZXBvaW50
-Lm1lZGlhIHdpdGggZWRpdCBwZXJtaXNzaW9ucyIKLSAiQ3JlYXRlIGEgdmlldy1vbmx5IHNoYXJl
-IGxpbmsgZm9yIHRoZSBCaXJtaW5naGFtIGFyY2hpdGVjdHVyZSBkaWFncmFtIgotICJHaXZlIGNv
-bW1lbnQgYWNjZXNzIHRvIHRoaXMgYm9hcmQgZm9yIG91ciB0cmFuc2l0IGFnZW5jeSBjbGllbnQi
-CgojIyBQbGFuIFJlcXVpcmVtZW50cwoKfCBGZWF0dXJlIHwgVGVhbSB8IEVudGVycHJpc2UgfAp8
-LS0tLS0tLS0tfC0tLS0tLXwtLS0tLS0tLS0tLS18CnwgU2VhcmNoLCByZWFkLCBzdW1tYXJpemUg
-fCDinIUgfCDinIUgfAp8IENyZWF0ZSBhbGwgZGlhZ3JhbSB0eXBlcyB8IOKchSB8IOKchSB8Cnwg
-RXhwb3J0IGFzIFBORyB8IOKchSB8IOKchSB8CnwgQWRkIC8gZWRpdCAvIGRlbGV0ZSBzaGFwZXMg
-fCDinIUgfCDinIUgfAp8IFNoYXJlIGxpbmtzICYgZW1haWwgc2hhcmluZyB8IOKdjCB8IOKchSB8
-CgojIyBLbm93biBMaW1pdGF0aW9ucyAoTWF5IDIwMjYpCgotIFNlYXJjaCBtYXkgbWlzcyBjb250
-ZW50IG9uIHBhZ2UgMisgb2YgbXVsdGktcGFnZSBkb2N1bWVudHMKLSBNQ1AgY2Fubm90IGVkaXQg
-ZXhpc3RpbmcgZGlhZ3JhbXMg4oCUIG9ubHkgcmVhZCBhbmQgY3JlYXRlIG5ldyBvbmVzCi0gQVdT
-LCBHQ1AsIGFuZCBBenVyZSBzaGFwZSBsaWJyYXJpZXMgQVJFIGF2YWlsYWJsZSB2aWEgdGhlIE1D
-UCAodXNlIGBnZXRfbWNwX3Jlc291cmNlYCB0byBhY2Nlc3MgdGhlbSkKCiMjIFN1cHBvcnQKCi0g
-W0x1Y2lkIE1DUCBTZXJ2ZXIgSGVscCBBcnRpY2xlXShodHRwczovL2hlbHAubHVjaWQuY28vaGMv
-ZW4tdXMvYXJ0aWNsZXMvNDI1Nzg4MDE4MDc1MDgtSW50ZWdyYXRlLUx1Y2lkLXdpdGgtQUktdG9v
-bHMtdXNpbmctdGhlLUx1Y2lkLU1DUC1zZXJ2ZXIpCi0gW0x1Y2lkIENvbW11bml0eV0oaHR0cHM6
-Ly9jb21tdW5pdHkubHVjaWQuY28pCg==
\ No newline at end of file
+# lucid-mcp Plugin
+
+Connect CoWork to the Lucid MCP server — search documents, generate diagrams, build org charts, and share Lucidchart/Lucidspark content without leaving Claude.
+
+## Overview
+
+This plugin wires the official [Lucid MCP Server](https://mcp.lucid.app/mcp) into CoWork, giving Claude direct access to your Lucid account. You can describe what you want in plain language and Claude will search, create, or share Lucid content on your behalf.
+
+## Components
+
+| Component | Type | Purpose |
+|-----------|------|---------|
+| `lucid` skill | Skill | Guides Claude on when and how to use each Lucid tool |
+| Lucid MCP Server | MCP (HTTP/OAuth) | Live connection to `https://mcp.lucid.app/mcp` |
+
+## Setup
+
+### Prerequisites
+- A Lucid account (Team or Enterprise plan)
+- Admin Panel access
+
+### Steps
+
+1. **Enable MCP access in Lucid Admin Panel**
+   - Log in to Lucid → Admin → Security → Feature Controls
+   - Under "MCP Access", toggle on **Allow users to connect**
+
+2. **Connect in CoWork**
+   - Install this plugin
+   - Go to plugin settings → lucid-mcp → Connectors → connect Lucid
+   - Complete the OAuth flow in your browser
+   - If the browser shows a localhost error page, copy the full URL from the address bar and paste it back into CoWork
+
+3. **Verify**
+   - Try: "Find my most recent Lucidchart diagram"
+   - Claude should return matching documents with links
+
+## Usage
+
+### Search & Summarize
+- "Find my Birmingham deployment architecture diagram"
+- "Summarize the process flow I have for display installation"
+- "What's in the RDMC integration diagram?"
+
+### Create Diagrams
+- "Build a flowchart in Lucid for our display provisioning process"
+- "Create a sequence diagram showing RDMC polling each display every 60 seconds"
+- "Make a swim lane diagram for our helpdesk escalation — lanes for Customer, L1, and Engineering"
+- "Generate an ER diagram for our inventory schema: Display, Location, Agency, ServiceRecord"
+
+### Create Org Charts
+- "Build an org chart where Bryan is CEO, with Sarah, Mike, and Jess reporting to him"
+- "Create an org chart from this CSV file — Name is column A, Manager is column C"
+
+### Share
+- "Share the Project Proposal diagram with sarah@messagepoint.media with edit permissions"
+- "Create a view-only share link for the Birmingham architecture diagram"
+- "Give comment access to this board for our transit agency client"
+
+## Plan Requirements
+
+| Feature | Team | Enterprise |
+|---------|------|------------|
+| Search, read, summarize | ✅ | ✅ |
+| Create all diagram types | ✅ | ✅ |
+| Export as PNG | ✅ | ✅ |
+| Add / edit / delete shapes | ✅ | ✅ |
+| Share links & email sharing | ❌ | ✅ |
+
+## Known Limitations (May 2026)
+
+- Search may miss content on page 2+ of multi-page documents
+- MCP cannot edit existing diagrams — only read and create new ones
+- AWS, GCP, and Azure shape libraries ARE available via the MCP (use `get_mcp_resource` to access them)
+
+## Support
+
+- [Lucid MCP Server Help Article](https://help.lucid.co/hc/en-us/articles/42578801807508-Integrate-Lucid-with-AI-tools-using-the-Lucid-MCP-server)
+- [Lucid Community](https://community.lucid.co)