@squirrelnotes.app/mcp 1.29.3 → 1.31.0

package/dist/stdio-handler.js

@@ -22582,6 +22582,7 @@ var init_mcplog = __esm({
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  MARKDOWN_CAPABILITIES_DESCRIPTION: () => MARKDOWN_CAPABILITIES_DESCRIPTION,
   createMcpServer: () => createMcpServer,
   handleRequest: () => handleRequest,
   inferMimeType: () => inferMimeType
@@ -22659,6 +22660,22 @@ function inferMimeType(filePath) {
 }
 function createMcpServer(creds, opts = {}) {
   const server2 = new McpServer({ name: "squirrel-notes", version: "1.0.0" });
+  server2.prompt(
+    "markdown_capabilities",
+    "Describes the Markdown and Mermaid diagram features supported by Squirrel Notes. Use this to understand what rich content you can include when creating or updating notes.",
+    {},
+    () => ({
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: MARKDOWN_CAPABILITIES_DESCRIPTION
+          }
+        }
+      ]
+    })
+  );
   server2.tool(
     "list_notes",
     "List notes with decrypted titles. Use this as the starting point for most note operations. Supports optional filters: narrow by collection, tag, or pinned status. Returns tagIds so you can see which tags are applied without a separate call.",
@@ -22733,7 +22750,7 @@ function createMcpServer(creds, opts = {}) {
   );
   server2.tool(
     "create_note",
-    "Create a new note with a title and optional Markdown content. Optionally place it in a collection (omit collectionId to create in scratchpad). Do not use a smart collection ID \u2014 smart collections are computed automatically and notes cannot be manually placed in them.",
+    "Create a new note with a title and optional Markdown content. Optionally place it in a collection (omit collectionId to create in scratchpad). Do not use a smart collection ID \u2014 smart collections are computed automatically and notes cannot be manually placed in them. The content field supports full Markdown including Mermaid diagrams \u2014 use fenced ```mermaid blocks to embed flowcharts, sequence diagrams, ERDs, Gantt charts, and more. See the markdown_capabilities prompt for details.",
     {
       title: external_exports.string().describe("Note title (plaintext \u2014 will be encrypted)"),
       content: external_exports.string().optional().describe("Note content in Markdown (will be encrypted)"),
@@ -22761,7 +22778,7 @@ function createMcpServer(creds, opts = {}) {
   );
   server2.tool(
     "update_note",
-    "Update the title and/or content of an existing note. To move a note to a different collection use move_note_to_collection. To pin/unpin a note use pin_note.",
+    "Update the title and/or content of an existing note. To move a note to a different collection use move_note_to_collection. To pin/unpin a note use pin_note. The content field supports full Markdown including Mermaid diagrams \u2014 use fenced ```mermaid blocks to embed flowcharts, sequence diagrams, ERDs, Gantt charts, and more. See the markdown_capabilities prompt for details.",
     {
       id: external_exports.string().describe("Note ID"),
       title: external_exports.string().optional().describe("New title (plaintext)"),
@@ -22788,7 +22805,7 @@ function createMcpServer(creds, opts = {}) {
   );
   server2.tool(
     "append_to_note",
-    "Append text to the end of an existing note without replacing its content. Ideal for log notes, daily journals, or running lists. More efficient than get_note + update_note for append-only workflows.",
+    "Append text to the end of an existing note without replacing its content. Ideal for log notes, daily journals, or running lists. More efficient than get_note + update_note for append-only workflows. Supports full Markdown including Mermaid diagram blocks.",
     {
       id: external_exports.string().describe("Note ID"),
       content: external_exports.string().describe("Markdown content to append"),
@@ -23576,7 +23593,7 @@ async function handleRequest(event, creds) {
   });
   return { statusCode: response.status, headers: responseHeaders, body: responseBody };
 }
-var SQUIRREL_API_BASE_URL, AUDIT_INTERNAL_SECRET, MIME_TYPES;
+var SQUIRREL_API_BASE_URL, AUDIT_INTERNAL_SECRET, MIME_TYPES, MARKDOWN_CAPABILITIES_DESCRIPTION;
 var init_server3 = __esm({
   "src/server.ts"() {
     "use strict";
@@ -23606,6 +23623,30 @@ var init_server3 = __esm({
       mp4: "video/mp4",
       zip: "application/zip"
     };
+    MARKDOWN_CAPABILITIES_DESCRIPTION = `Squirrel Notes renders notes as rich Markdown with the following capabilities:
+
+- **Standard Markdown**: headings, bold, italic, lists, blockquotes, inline code, fenced code blocks, tables, links, images
+- **Mermaid diagrams**: fenced code blocks with the language tag \`mermaid\` are rendered as interactive diagrams in the app. Supported diagram types include:
+  - Flowcharts (\`graph TD\` / \`flowchart LR\`)
+  - Sequence diagrams (\`sequenceDiagram\`)
+  - Entity-relationship diagrams (\`erDiagram\`)
+  - Gantt charts (\`gantt\`)
+  - Class diagrams (\`classDiagram\`)
+  - State diagrams (\`stateDiagram-v2\`)
+  - Pie charts (\`pie\`)
+  - Mind maps (\`mindmap\`)
+  - Timeline diagrams (\`timeline\`)
+
+Use Mermaid diagrams whenever a visual representation would help: workflows, system architecture, data models, project timelines, etc.
+
+Example Mermaid block:
+\`\`\`mermaid
+graph TD
+  A[Start] --> B{Decision}
+  B -->|Yes| C[Do it]
+  B -->|No| D[Skip it]
+\`\`\`
+`;
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squirrelnotes.app/mcp",
-  "version": "1.29.3",
+  "version": "1.31.0",
   "description": "MCP stdio CLI for Squirrel Notes — bridges AI agents to the encrypted note-taking API",
   "type": "module",
   "bin": {