@live-context/mcp 0.4.0 → 0.7.1

package/README.md

@@ -40,7 +40,15 @@ For Claude Desktop, Cursor, or any other MCP client, add this to your `mcpServer
 
 ## Tools
 
-`get_context`, `list_spaces`, `list_collections`, `list_notebooks`, `list_context`, `write_context`, `health_check`. See the [Live Context docs](https://live-context.com/docs) for usage.
+**Read** — `get_context`, `list_spaces`, `list_collections`, `list_notebooks`, `list_context`
+
+**Write** — `write_context` (knowledge → Spaces or Notebooks). Honors `write_mode='review_required'` Spaces: writes to those queue as proposals for admin approval. Pass `trigger_message` (min 10 chars) explaining why the write should be applied when targeting such a Space.
+
+**Propose** *(v0.4.0+)* — `propose_space`, `propose_project`, `list_my_proposals`. Use these when the user asks for a new container. Both `propose_*` tools require a `trigger_message` (min 10 chars). Auto-approves when the caller is a team admin; otherwise queues for review at `live-context.com/dashboard/proposals`.
+
+**Health** — `health_check`
+
+See the [Live Context docs](https://live-context.com/docs) for full schemas and examples.
 
 ## Get a key
 

package/dist/index.js

@@ -91,7 +91,7 @@ async function callMcpApi(tool, args, method = 'POST') {
 // ---------------------------------------------------------------------------
 const server = new McpServer({
     name: 'live-context-mcp',
-    version: '0.3.0', // bumped for Wave 5 hosted-proxy rewrite
+    version: '0.7.1', // 0.7.0 added body_tiptap; 0.7.1 adds width_mode (fixed | wide)
 });
 server.registerTool('get_context', {
     description: 'Retrieve relevant context entries. Returns L0 summaries (title, type, snippet) by default. Pass drawer_id to get full page body.',
@@ -204,6 +204,19 @@ Use for time-bound work (launches, fundraises, redesigns). For ongoing knowledge
         trigger_message: z.string().describe('Why this Project should exist (min 10 chars). Required.'),
     },
 }, (args) => callMcpApi('propose-project', args));
+server.registerTool('propose_collection', {
+    description: `Propose a new Collection inside an existing Space — a grouping layer for related drawers (e.g. "Tokens" inside "design-system"). When the caller is a team admin of the Space's owner team, the proposal auto-approves and the Collection is created immediately. Otherwise it queues for admin review.
+
+trigger_message is REQUIRED — explain WHY this Collection should exist (min 10 chars). Cite the drawers or topic that motivated it.
+
+Use when several drawers in a Space cluster around a sub-topic that deserves its own grouping. For new top-level containers, use propose_space instead.`,
+    inputSchema: {
+        space_id: z.string().describe('Parent Space ID. Find via list_spaces.'),
+        name: z.string().describe('Collection name (e.g. "Tokens", "Migrations")'),
+        description: z.string().optional().describe('Short description of what goes in this Collection.'),
+        trigger_message: z.string().describe('Why this Collection should exist (min 10 chars). Required.'),
+    },
+}, (args) => callMcpApi('propose-collection', args));
 server.registerTool('list_my_proposals', {
     description: 'List your proposals (Spaces + Projects you proposed) plus any proposals you can see based on team_visible setting. Filter by status.',
     inputSchema: {
@@ -213,6 +226,91 @@ server.registerTool('list_my_proposals', {
             .describe('Filter by proposal status.'),
     },
 }, (args) => callMcpApi('list-my-proposals', args));
+server.registerTool('write_page', {
+    description: `Compose a Page — a human-readable, evidence-backed narrative document — into a Space or Notebook. Pages are how research, decisions, and synthesis get forwarded to other humans; drawers stay atomic for retrieval, Pages are the readable artifact.
+
+When to use:
+- The user asks to "write up", "summarise", "synthesise", "hand off", or "share with someone" a body of team knowledge.
+- An empty Page draft exists (created from the dashboard) — fill it by passing page_id.
+
+Body format — pick ONE:
+
+1) body_tiptap (preferred — full formatting). A Tiptap document JSON tree. Top shape:
+   { "type": "doc", "content": [...nodes] }
+
+   Block node types you can emit:
+   - paragraph: { "type": "paragraph", "content": [...inline] }
+   - heading: { "type": "heading", "attrs": { "level": 1|2|3|4 }, "content": [...inline] }
+   - bulletList / orderedList: { "type": "bulletList"|"orderedList", "content": [{ "type": "listItem", "content": [...blocks] }] }
+   - taskList: { "type": "taskList", "content": [{ "type": "taskItem", "attrs": { "checked": false }, "content": [...blocks] }] }
+   - blockquote: { "type": "blockquote", "content": [...blocks] }
+   - codeBlock: { "type": "codeBlock", "attrs": { "language": "ts" }, "content": [{ "type": "text", "text": "..." }] }
+   - horizontalRule: { "type": "horizontalRule" }
+   - table: { "type": "table", "attrs": { "width": "inline"|"wide"|"full" }, "content": [{ "type": "tableRow", "content": [{ "type": "tableHeader"|"tableCell", "content": [...blocks] }] }] }
+   - details (collapsible / Confluence Expand): { "type": "details", "content": [{ "type": "detailsSummary", "content": [...inline] }, { "type": "detailsContent", "content": [...blocks] }] }
+
+   Inline node types:
+   - text: { "type": "text", "text": "string", "marks": [...] }
+   - hardBreak: { "type": "hardBreak" }
+   - drawerCitation (clickable evidence chip — use these to ground claims!): { "type": "drawerCitation", "attrs": { "drawerId": "<uuid>", "drawerTitle": "<title>", "drawerType": "decision|constraint|..." } }
+   - mention (person): { "type": "mention", "attrs": { "id": "<user_uuid>", "label": "Display Name" } }
+
+   Marks (applied to text nodes via the "marks" array):
+   - bold, italic, underline, strike, code
+   - highlight: { "type": "highlight" }
+   - subscript, superscript
+   - link: { "type": "link", "attrs": { "href": "https://..." } }
+   - textAlign: paragraphs and headings accept "attrs": { "textAlign": "left"|"center"|"right" }
+
+   Use drawerCitation inline anywhere you would cite. The server auto-extracts cited drawer_ids from your doc and snapshots each drawer's body so the Page stays interpretable even if drawers later change. You do NOT need to also pass "citations" — extraction is automatic.
+
+2) body_markdown (legacy — limited). Markdown string. Supports headings, paragraphs, lists, blockquote, code blocks, bold/italic/strike, links, inline code, horizontal rule. Does NOT support tables, details, mentions, highlight, alignment, underline. Use \`[[drawer:<uuid>|<title>]]\` inline for citations. Prefer body_tiptap.
+
+Always retrieve evidence with get_context first; never compose from training data when team knowledge exists.`,
+    inputSchema: {
+        title: z.string().describe('Page title — short, descriptive, sentence case.'),
+        body_tiptap: z
+            .object({
+            type: z.literal('doc'),
+            content: z.array(z.any()).optional(),
+        })
+            .passthrough()
+            .optional()
+            .describe('Preferred. Tiptap document JSON — see tool description for full node + mark schema.'),
+        body_markdown: z
+            .string()
+            .optional()
+            .describe('Legacy fallback. Markdown subset (no tables, details, mentions). Prefer body_tiptap.'),
+        scope: z.enum(['team', 'personal']).optional().describe("'team' (default — writes to a Space) or 'personal' (writes to a Notebook; requires user token)."),
+        space: z.string().optional().describe('Target Space name (required for team scope).'),
+        notebook: z.string().optional().describe('Target Notebook name (required for personal scope).'),
+        page_id: z.string().optional().describe('If filling an existing empty draft, the draft id. Else omit to create new.'),
+        citations: z
+            .array(z.object({ drawer_id: z.string() }))
+            .optional()
+            .describe('Optional. If body_tiptap is passed, citations auto-extract from drawerCitation nodes. Pass explicitly only to attribute drawers that don\'t appear inline.'),
+        width_mode: z
+            .enum(['fixed', 'wide'])
+            .optional()
+            .describe("Optional. 'fixed' (default, ~768px reading width) or 'wide' (~1024px). Use 'wide' for pages dominated by tables, wide code blocks, or side-by-side comparisons. Matches Confluence's per-page Full-width toggle."),
+    },
+}, (args) => callMcpApi('write-page', args));
+server.registerTool('list_pages', {
+    description: 'List Pages in the team or in a specific Space/Notebook. Returns title + container + updated_at. Use get_page for full body and citations.',
+    inputSchema: {
+        scope: z.enum(['team', 'personal', 'all']).optional().describe("Default 'all'. 'team' = Space pages; 'personal' = Notebook pages."),
+        space: z.string().optional().describe('Filter by Space name.'),
+        notebook: z.string().optional().describe('Filter by Notebook name (requires user token).'),
+        limit: z.number().int().positive().max(100).optional().describe('Page size (default 20, max 100).'),
+        offset: z.number().int().min(0).optional().describe('Pagination offset (default 0).'),
+    },
+}, (args) => callMcpApi('list-pages', args));
+server.registerTool('get_page', {
+    description: 'Fetch a Page by id. Returns title, body_json (Tiptap doc), container, and citations enriched with current drawer title/type. Use this before re-composing so you can show what already exists.',
+    inputSchema: {
+        page_id: z.string().describe('Page id (from list_pages or write_page result).'),
+    },
+}, (args) => callMcpApi('get-page', args));
 server.registerTool('health_check', {
     description: 'Returns server health status and resolved team identity',
 }, () => callMcpApi('health-check', undefined, 'GET'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@live-context/mcp",
-  "version": "0.4.0",
+  "version": "0.7.1",
   "private": false,
   "description": "Live Context MCP — stdio proxy to live-context.com hosted API. Customer-side has no Supabase dependency.",
   "type": "module",