content/docs/plugins.mdx

@@ -17,6 +17,30 @@ figures out how to load it based on its shape.
 
 ---
 
+## Service proxies — bring a service into a workspace
+
+A plugin doesn't have to be only a skill or a hook. Because the **MCP server**
+shape lets a plugin wrap an external service, a plugin can act as a *service
+proxy*: install it on a workspace and the agent gains that capability directly —
+no separate website to sign into or configure. The platform's built-in **LLM
+proxy** (platform-managed model routing) is the canonical, shipping example; the
+same mechanism generalises to other services — voice, video generation, search,
+and more — surfaced to the agent as MCP tools (available on MCP-capable runtimes
+today, expanding to more).
+
+Because plugins install **per workspace** and UNION with org defaults, each role
+gets exactly the services it needs, and nothing it doesn't.
+
+<Callout type="info">
+  **Roadmap — the Molecule Marketplace.** A hosted marketplace where third-party
+  developers publish and sell plugins (including service-proxy plugins) is on the
+  roadmap. Today, plugins install from the platform's curated `local://` registry
+  or from pinned `github://` refs (see [Sources](#sources-where)) — Molecule AI
+  does not yet ship a hosted plugin marketplace.
+</Callout>
+
+---
+
 ## Two-Axis Model
 
 ### Sources (where)

public/diagrams/platform-architecture.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1360 1284" font-family="Inter, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1360 1410" font-family="Inter, -apple-system, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif">
   <defs>
     <style>
       @keyframes mol-flow { to { stroke-dashoffset: -18; } }
@@ -17,7 +17,7 @@
     <marker id="ai" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#4f46e5"/></marker>
     <marker id="ag" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0,0 L10,5 L0,10 z" fill="#10b981"/></marker>
   </defs>
-  <rect width="1360" height="1284" fill="#fbfcfe"/>
+  <rect width="1360" height="1410" fill="#fbfcfe"/>
 
   <!-- ===== Title ===== -->
   <text x="44" y="48" font-size="26" font-weight="700" fill="#15181f">Molecule AI — the open-source OS for AI agent organizations</text>
@@ -212,4 +212,26 @@
 
   <!-- runtime -> provider -->
   <path class="mol-flow-slow" d="M904,1130 L920,1130" stroke="#64748b" stroke-width="1.6" fill="none" marker-end="url(#a)"/>
+
+  <!-- ===== PLUGINS — per-workspace capabilities & service proxies ===== -->
+  <text x="44" y="1276" font-size="12" font-weight="700" fill="#64748b" letter-spacing="0.4">PLUGINS — install capabilities &amp; services per workspace (no external site to configure)</text>
+  <g filter="url(#sh)"><rect x="44" y="1286" width="1272" height="112" rx="14" fill="#f3fbf6" stroke="#10b981" stroke-width="1.5"/></g>
+  <text x="66" y="1312" font-size="13" font-weight="700" fill="#047857">Per-workspace · installed like an app · UNION with org defaults</text>
+  <text x="470" y="1312" font-size="10.5" fill="#0f766e">any dev can build a plugin; one plugin contract, two axes (source × shape)</text>
+  <text x="66" y="1342" font-size="10.5" font-weight="700" fill="#0f766e">Capabilities</text>
+  <g font-size="11.5" font-weight="600" text-anchor="middle">
+    <rect x="150" y="1326" width="100" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="200" y="1346" fill="#15181f">skills</text>
+    <rect x="260" y="1326" width="100" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="310" y="1346" fill="#15181f">hooks</text>
+    <rect x="370" y="1326" width="160" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="450" y="1346" fill="#15181f">slash-commands</text>
+    <rect x="540" y="1326" width="130" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="605" y="1346" fill="#15181f">MCP tools</text>
+  </g>
+  <text x="66" y="1380" font-size="10.5" font-weight="700" fill="#0f766e">Service proxies <tspan font-size="9" font-weight="500" fill="#0f766e">(via MCP)</tspan></text>
+  <g font-size="11.5" font-weight="600" text-anchor="middle">
+    <rect x="200" y="1364" width="96" height="30" rx="8" fill="#ecfdf5" stroke="#10b981" stroke-width="1.4"/><text x="248" y="1384" fill="#047857">LLM ✓</text>
+    <rect x="306" y="1364" width="96" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="354" y="1384" fill="#15181f">voice</text>
+    <rect x="412" y="1364" width="96" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="460" y="1384" fill="#15181f">video</text>
+    <rect x="518" y="1364" width="96" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="566" y="1384" fill="#15181f">search</text>
+    <rect x="624" y="1364" width="60" height="30" rx="8" fill="#fff" stroke="#a7e3c5"/><text x="654" y="1384" fill="#5b6472">…</text>
+    <rect x="740" y="1364" width="556" height="30" rx="8" fill="#fff7ed" stroke="#f4b860" stroke-width="1.4" stroke-dasharray="5 4"/><text x="1018" y="1384" fill="#b45309">Molecule Marketplace — third-party devs publish &amp; sell · roadmap</text>
+  </g>
 </svg>