@socialneuron/mcp-server 1.7.4 → 1.7.9

package/dist/index.js

@@ -14,7 +14,7 @@ var MCP_VERSION;
 var init_version = __esm({
   "src/lib/version.ts"() {
     "use strict";
-    MCP_VERSION = "1.7.4";
+    MCP_VERSION = "1.7.9";
   }
 });
 
@@ -1273,6 +1273,13 @@ var init_tool_catalog = __esm({
         scope: "mcp:read"
       },
       // carousel (already listed in content section above)
+      // apps (MCP Apps — interactive UI inside the host)
+      {
+        name: "open_content_calendar",
+        description: "Open an interactive drag-drop calendar of the user's scheduled posts inside the host (Claude Desktop / claude.ai). Renders an MCP App; backed by list_recent_posts, schedule_post, find_next_slots \u2014 no new tools needed.",
+        module: "apps",
+        scope: "mcp:read"
+      },
       // recipes
       {
         name: "list_recipes",
@@ -1297,6 +1304,19 @@ var init_tool_catalog = __esm({
         description: "Check the status and progress of a running recipe execution",
         module: "recipes",
         scope: "mcp:read"
+      },
+      // platform connection deep-link flow
+      {
+        name: "start_platform_connection",
+        description: "Mint a single-use deep link for a user to complete platform OAuth in their browser",
+        module: "distribution",
+        scope: "mcp:distribute"
+      },
+      {
+        name: "wait_for_connection",
+        description: "Poll until a platform connection becomes active or timeout",
+        module: "distribution",
+        scope: "mcp:read"
       }
     ];
   }
@@ -3309,9 +3329,9 @@ async function runSetup() {
   console.error(`  Key prefix: ${apiKey.substring(0, 12)}...`);
   const configPaths = getConfigPaths();
   let configured = false;
-  for (const { path, name } of configPaths) {
-    if (configureMcpClient(path)) {
-      console.error(`  Configured ${name}: ${path}`);
+  for (const { path: path2, name } of configPaths) {
+    if (configureMcpClient(path2)) {
+      console.error(`  Configured ${name}: ${path2}`);
       configured = true;
     }
   }
@@ -3978,7 +3998,12 @@ var TOOL_SCOPES = {
   suggest_next_content: "mcp:read",
   // mcp:analytics (digest and anomalies are analytics-scoped)
   generate_performance_digest: "mcp:analytics",
-  detect_anomalies: "mcp:analytics"
+  detect_anomalies: "mcp:analytics",
+  // mcp:read (Apps — entry tool for the Content Calendar MCP App; reads recent posts)
+  open_content_calendar: "mcp:read",
+  // platform connection deep-link flow
+  start_platform_connection: "mcp:distribute",
+  wait_for_connection: "mcp:read"
 };
 function hasScope(userScopes, required) {
   if (userScopes.includes(required)) return true;
@@ -5747,7 +5772,7 @@ var ERROR_PATTERNS = [
   // Generic sensitive patterns (API keys, URLs with secrets)
   [/[a-z0-9]{32,}.*key|Bearer [a-zA-Z0-9._-]+/i, "An internal error occurred. Please try again."]
 ];
-function sanitizeError2(error) {
+function sanitizeError(error) {
   const msg = error instanceof Error ? error.message : typeof error === "string" ? error : "Unknown error";
   if (process.env.NODE_ENV !== "production") {
     console.error("[Error]", msg);
@@ -5760,6 +5785,171 @@ function sanitizeError2(error) {
   return "An unexpected error occurred. Please try again.";
 }
 
+// src/lib/ssrf.ts
+var BLOCKED_IP_PATTERNS = [
+  // IPv4 localhost/loopback
+  /^127\./,
+  /^0\./,
+  // IPv4 private ranges (RFC 1918)
+  /^10\./,
+  /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+  /^192\.168\./,
+  // IPv4 link-local
+  /^169\.254\./,
+  // Cloud metadata endpoint (AWS, GCP, Azure)
+  /^169\.254\.169\.254$/,
+  // IPv4 broadcast
+  /^255\./,
+  // Shared address space (RFC 6598)
+  /^100\.(6[4-9]|[7-9][0-9]|1[0-1][0-9]|12[0-7])\./
+];
+var BLOCKED_IPV6_PATTERNS = [
+  /^::1$/i,
+  // loopback
+  /^::$/i,
+  // unspecified
+  /^fe[89ab][0-9a-f]:/i,
+  // link-local fe80::/10
+  /^fc[0-9a-f]:/i,
+  // unique local fc00::/7
+  /^fd[0-9a-f]:/i,
+  // unique local fc00::/7
+  /^::ffff:127\./i,
+  // IPv4-mapped localhost
+  /^::ffff:(0|10|127|169\.254|172\.(1[6-9]|2[0-9]|3[0-1])|192\.168)\./i
+  // IPv4-mapped private
+];
+var BLOCKED_HOSTNAMES = [
+  "localhost",
+  "localhost.localdomain",
+  "local",
+  "127.0.0.1",
+  "0.0.0.0",
+  "[::1]",
+  "[::ffff:127.0.0.1]",
+  // Cloud metadata endpoints
+  "metadata.google.internal",
+  "metadata.goog",
+  "instance-data",
+  "instance-data.ec2.internal"
+];
+var ALLOWED_PROTOCOLS = ["http:", "https:"];
+var BLOCKED_PORTS = [22, 23, 25, 110, 143, 445, 3306, 5432, 6379, 27017, 11211];
+function isBlockedIP(ip) {
+  const normalized = ip.replace(/^\[/, "").replace(/\]$/, "");
+  if (normalized.includes(":")) {
+    return BLOCKED_IPV6_PATTERNS.some((pattern) => pattern.test(normalized));
+  }
+  return BLOCKED_IP_PATTERNS.some((pattern) => pattern.test(normalized));
+}
+function isBlockedHostname(hostname) {
+  return BLOCKED_HOSTNAMES.includes(hostname.toLowerCase());
+}
+function isIPAddress(hostname) {
+  const ipv4Pattern = /^(\d{1,3}\.){3}\d{1,3}$/;
+  const ipv6Pattern = /^\[?[a-fA-F0-9:]+\]?$/;
+  return ipv4Pattern.test(hostname) || ipv6Pattern.test(hostname);
+}
+async function validateUrlForSSRF(urlString) {
+  try {
+    const url = new URL(urlString);
+    if (!ALLOWED_PROTOCOLS.includes(url.protocol)) {
+      return {
+        isValid: false,
+        error: `Invalid protocol: ${url.protocol}. Only HTTP and HTTPS are allowed.`
+      };
+    }
+    if (url.username || url.password) {
+      return {
+        isValid: false,
+        error: "URLs with embedded credentials are not allowed."
+      };
+    }
+    const hostname = url.hostname.toLowerCase();
+    if (isBlockedHostname(hostname)) {
+      return {
+        isValid: false,
+        error: "Access to internal/localhost addresses is not allowed."
+      };
+    }
+    if (isIPAddress(hostname) && isBlockedIP(hostname)) {
+      return {
+        isValid: false,
+        error: "Access to private/internal IP addresses is not allowed."
+      };
+    }
+    const port = url.port ? parseInt(url.port, 10) : url.protocol === "https:" ? 443 : 80;
+    if (BLOCKED_PORTS.includes(port)) {
+      return {
+        isValid: false,
+        error: `Access to port ${port} is not allowed.`
+      };
+    }
+    let resolvedIP;
+    if (!isIPAddress(hostname)) {
+      try {
+        const dns = await import("node:dns");
+        const resolver = new dns.promises.Resolver();
+        const resolvedIPs = [];
+        try {
+          const aRecords = await resolver.resolve4(hostname);
+          resolvedIPs.push(...aRecords);
+        } catch {
+        }
+        try {
+          const aaaaRecords = await resolver.resolve6(hostname);
+          resolvedIPs.push(...aaaaRecords);
+        } catch {
+        }
+        if (resolvedIPs.length === 0) {
+          return {
+            isValid: false,
+            error: "DNS resolution failed: hostname did not resolve to any address."
+          };
+        }
+        for (const ip of resolvedIPs) {
+          if (isBlockedIP(ip)) {
+            return {
+              isValid: false,
+              error: "Hostname resolves to a private/internal IP address."
+            };
+          }
+        }
+        resolvedIP = resolvedIPs[0];
+      } catch {
+        return {
+          isValid: false,
+          error: "DNS resolution failed. Cannot verify hostname safety."
+        };
+      }
+    }
+    return { isValid: true, sanitizedUrl: url.toString(), resolvedIP };
+  } catch (error) {
+    return {
+      isValid: false,
+      error: `Invalid URL format: ${error instanceof Error ? error.message : "Unknown error"}`
+    };
+  }
+}
+function quickSSRFCheck(urlString) {
+  try {
+    const url = new URL(urlString);
+    if (!ALLOWED_PROTOCOLS.includes(url.protocol)) {
+      return { isValid: false, error: `Invalid protocol: ${url.protocol}` };
+    }
+    if (url.username || url.password) {
+      return { isValid: false, error: "URLs with credentials not allowed" };
+    }
+    const hostname = url.hostname.toLowerCase();
+    if (isBlockedHostname(hostname) || isIPAddress(hostname) && isBlockedIP(hostname)) {
+      return { isValid: false, error: "Access to internal addresses not allowed" };
+    }
+    return { isValid: true, sanitizedUrl: url.toString() };
+  } catch {
+    return { isValid: false, error: "Invalid URL format" };
+  }
+}
+
 // src/tools/distribution.ts
 init_supabase();
 init_quality();
@@ -5799,16 +5989,42 @@ function asEnvelope2(data) {
     data
   };
 }
+function isAlreadyR2Signed(url) {
+  try {
+    const u = new URL(url);
+    return u.searchParams.has("X-Amz-Signature");
+  } catch {
+    return false;
+  }
+}
+async function rehostExternalUrl(mediaUrl, projectId) {
+  if (isAlreadyR2Signed(mediaUrl)) {
+    return { signedUrl: mediaUrl, r2Key: "" };
+  }
+  const ssrf = quickSSRFCheck(mediaUrl);
+  if (!ssrf.isValid) {
+    return { error: ssrf.error ?? "URL rejected by SSRF check" };
+  }
+  const { data, error } = await callEdgeFunction(
+    "upload-to-r2",
+    { url: ssrf.sanitizedUrl ?? mediaUrl, projectId },
+    { timeoutMs: 6e4 }
+  );
+  if (error || !data?.key || !data?.url) {
+    return { error: error ?? "upload-to-r2 returned no key" };
+  }
+  return { signedUrl: data.url, r2Key: data.key };
+}
 function registerDistributionTools(server2) {
   server2.tool(
     "schedule_post",
-    'Publish or schedule a post to connected social platforms. Check list_connected_accounts first to verify active OAuth for each target platform. For Instagram carousels: use media_type=CAROUSEL_ALBUM with 2-10 media_urls. For YouTube: title is required. schedule_at uses ISO 8601 (e.g. "2026-03-20T14:00:00Z") \u2014 omit to post immediately.',
+    'Publish or schedule a post to connected social platforms. ALWAYS call `list_connected_accounts` FIRST \u2014 if the target platform is not connected, call `start_platform_connection` to get a one-time browser deep link the user opens to complete the platform OAuth (this is a one-time setup on socialneuron.com, not another OAuth in Claude). After they approve, call `wait_for_connection` and only then call schedule_post. For Instagram carousels: use media_type=CAROUSEL_ALBUM with 2-10 media_urls. For YouTube: title is required. schedule_at uses ISO 8601 (e.g. "2026-03-20T14:00:00Z") \u2014 omit to post immediately.',
     {
       media_url: z3.string().optional().describe(
-        "URL of the media file to post. Public URL or R2 signed URL. Not needed if media_urls, r2_key, or job_id is provided."
+        "URL of the media file to post. Any public HTTPS URL works \u2014 including ephemeral generator URLs (Replicate, OpenAI, DALL-E). The server persists non-R2 URLs into R2 before posting so scheduled posts and byte-upload platforms (X, LinkedIn, YouTube, Bluesky) do not 404 when the source URL expires. Set auto_rehost=false to skip. Not needed if media_urls, r2_key, or job_id is provided."
       ),
       media_urls: z3.array(z3.string()).optional().describe(
-        "Array of 2-10 image URLs for carousel posts. Each must be publicly accessible or R2 signed URL. Use with media_type=CAROUSEL_ALBUM."
+        "Array of 2-10 image URLs for carousel posts. Same rehosting rules as media_url \u2014 ephemeral URLs are persisted automatically. Use with media_type=CAROUSEL_ALBUM."
       ),
       r2_key: z3.string().optional().describe(
         "R2 object key from upload_media. Signed on demand at post time \u2014 survives scheduling delays. Alternative to media_url."
@@ -5897,7 +6113,10 @@ function registerDistributionTools(server2) {
       ),
       project_id: z3.string().optional().describe("Social Neuron project ID to associate this post with."),
       response_format: z3.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text."),
-      attribution: z3.boolean().optional().describe('If true, appends "Created with Social Neuron" to the caption. Default: false.')
+      attribution: z3.boolean().optional().describe('If true, appends "Created with Social Neuron" to the caption. Default: false.'),
+      auto_rehost: z3.boolean().optional().describe(
+        "Whether to persist non-R2 media_url/media_urls into R2 before posting. Default: true. Set to false only if you know the source URL will outlive the scheduling window and every target platform supports URL ingest."
+      )
     },
     async ({
       media_url,
@@ -5911,6 +6130,7 @@ function registerDistributionTools(server2) {
       project_id,
       response_format,
       attribution,
+      auto_rehost,
       r2_key,
       r2_keys,
       job_id,
@@ -6022,12 +6242,54 @@ function registerDistributionTools(server2) {
           }
           resolvedMediaUrls = resolved;
         }
+        const shouldRehost = auto_rehost !== false;
+        if (shouldRehost && resolvedMediaUrl && !isAlreadyR2Signed(resolvedMediaUrl)) {
+          const rehost = await rehostExternalUrl(resolvedMediaUrl, project_id);
+          if ("error" in rehost) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: `Failed to persist media URL into R2: ${rehost.error}. Try upload_media first and pass r2_key instead, or set auto_rehost=false if you're sure the URL is publicly durable and every target platform accepts URL ingest.`
+                }
+              ],
+              isError: true
+            };
+          }
+          resolvedMediaUrl = rehost.signedUrl;
+        }
+        if (shouldRehost && resolvedMediaUrls && resolvedMediaUrls.length > 0) {
+          const needsRehost = resolvedMediaUrls.map((u) => !isAlreadyR2Signed(u));
+          if (needsRehost.some(Boolean)) {
+            const rehosted = await Promise.all(
+              resolvedMediaUrls.map(
+                (u, i) => needsRehost[i] ? rehostExternalUrl(u, project_id) : Promise.resolve({ signedUrl: u, r2Key: "" })
+              )
+            );
+            const failIdx = rehosted.findIndex((r) => "error" in r);
+            if (failIdx !== -1) {
+              const failed = rehosted[failIdx];
+              return {
+                content: [
+                  {
+                    type: "text",
+                    text: `Failed to persist media_urls[${failIdx}] into R2: ${failed.error}. Try upload_media first and pass r2_keys instead, or set auto_rehost=false.`
+                  }
+                ],
+                isError: true
+              };
+            }
+            resolvedMediaUrls = rehosted.map(
+              (r) => r.signedUrl
+            );
+          }
+        }
       } catch (resolveErr) {
         return {
           content: [
             {
               type: "text",
-              text: `Failed to resolve media: ${sanitizeError2(resolveErr)}`
+              text: `Failed to resolve media: ${sanitizeError(resolveErr)}`
             }
           ],
           isError: true
@@ -6392,7 +6654,7 @@ Created with Social Neuron`;
         return { content: [{ type: "text", text: lines.join("\n") }], isError: false };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "find_next_slots",
           status: "error",
@@ -6912,7 +7174,7 @@ Created with Social Neuron`;
         };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "schedule_content_plan",
           status: "error",
@@ -6935,6 +7197,19 @@ import { readFile } from "node:fs/promises";
 import { basename, extname } from "node:path";
 init_supabase();
 var MAX_BASE64_SIZE = 10 * 1024 * 1024;
+var ALLOWED_UPLOAD_TYPES = /* @__PURE__ */ new Set([
+  "image/png",
+  "image/jpeg",
+  "image/gif",
+  "image/webp",
+  "image/svg+xml",
+  "video/mp4",
+  "video/quicktime",
+  "video/x-msvideo",
+  "video/webm"
+]);
+var BASE64_CHARS = /^[A-Za-z0-9+/]+={0,2}$/;
+var DATA_URI_PREFIX = /^data:([^;,]+);base64,/;
 function maskR2Key(key) {
   const segments = key.split("/");
   return segments.length >= 3 ? `\u2026/${segments.slice(-2).join("/")}` : key;
@@ -6955,21 +7230,35 @@ function inferContentType(filePath) {
   };
   return map[ext] || "application/octet-stream";
 }
+function approxBase64Size(raw) {
+  const len = raw.length;
+  if (len === 0) return 0;
+  let padding = 0;
+  if (raw.endsWith("==")) padding = 2;
+  else if (raw.endsWith("=")) padding = 1;
+  return Math.floor(len * 3 / 4) - padding;
+}
 function registerMediaTools(server2) {
   server2.tool(
     "upload_media",
-    "Upload a local file or external URL to persistent R2 storage. Returns a durable r2_key that can be passed to schedule_post. Use for images, videos, or any media that needs to be posted to social platforms. Accepts local file paths (in MCP stdio mode) or public URLs. Max 10MB for base64 upload \u2014 larger files return an error with guidance.",
+    "Upload media to persistent R2 storage. Returns a durable r2_key that can be passed to schedule_post. Three input modes: (1) local file path (stdio mode only), (2) public URL fetched by the server, (3) inline base64 via file_data (remote agents, \u226410MB decoded). AGENT ROUTING GUIDE: If the media was produced by another tool here (generate_image, generate_video, create_carousel, etc.), use the returned job_id or r2_key directly with schedule_post \u2014 do NOT download and re-upload. For user-authored files larger than ~1MB, prefer request_upload_session (returns a tokenized Dashboard URL the user uploads through in their browser) so bytes never flow through the agent context. Reserve file_data for small assets (thumbnails, logos, short clips).",
     {
-      source: z4.string().describe(
-        'Local file path (e.g. "/Users/me/image.png") or public URL (e.g. "https://example.com/photo.jpg"). Local files are read and uploaded as base64. URLs are fetched by the server.'
+      source: z4.string().optional().describe(
+        'Local file path (e.g. "/Users/me/image.png") or public URL (e.g. "https://example.com/photo.jpg"). Leave empty when passing file_data instead.'
+      ),
+      file_data: z4.string().optional().describe(
+        'Base64-encoded file bytes, with or without a "data:<mime>;base64," prefix. Use this from remote agents (Claude Web/Desktop) that cannot provide a filesystem path. Max 10MB decoded.'
+      ),
+      file_name: z4.string().optional().describe(
+        'Optional filename for the upload (e.g. "hero.png"). Path components are stripped \u2014 only the basename is used.'
       ),
       content_type: z4.string().optional().describe(
-        'MIME type (e.g. "image/png", "video/mp4"). Auto-detected from file extension if omitted.'
+        'MIME type (e.g. "image/png", "video/mp4"). Auto-detected from file extension for paths/URLs, or from the data: prefix on file_data. Required when passing raw base64 with no prefix.'
       ),
       project_id: z4.string().optional().describe("Project ID for R2 path organization."),
       response_format: z4.enum(["text", "json"]).optional().describe("Response format. Default: text.")
     },
-    async ({ source, content_type, project_id, response_format }) => {
+    async ({ source, file_data, file_name, content_type, project_id, response_format }) => {
       const format = response_format ?? "text";
       const startedAt = Date.now();
       const userId = await getDefaultUserId();
@@ -6991,46 +7280,187 @@ function registerMediaTools(server2) {
           isError: true
         };
       }
-      const isUrl = source.startsWith("http://") || source.startsWith("https://");
-      const isLocalFile = !isUrl;
+      if (!source && !file_data) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "upload_media requires either `source` (path or URL) or `file_data` (base64)."
+            }
+          ],
+          isError: true
+        };
+      }
+      if (file_data) {
+        let raw = file_data;
+        let detectedType;
+        const prefixMatch = raw.match(DATA_URI_PREFIX);
+        if (prefixMatch) {
+          detectedType = prefixMatch[1].trim().toLowerCase();
+          raw = raw.slice(prefixMatch[0].length);
+        }
+        const ct = (content_type ?? detectedType ?? "").trim().toLowerCase();
+        if (!ct) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "content_type is required when file_data has no data: prefix."
+              }
+            ],
+            isError: true
+          };
+        }
+        if (!ALLOWED_UPLOAD_TYPES.has(ct)) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `content_type "${ct}" is not supported. Allowed: ${[...ALLOWED_UPLOAD_TYPES].sort().join(", ")}.`
+              }
+            ],
+            isError: true
+          };
+        }
+        const stripped = raw.replace(/\s+/g, "");
+        if (!BASE64_CHARS.test(stripped)) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "file_data is not valid base64 \u2014 only A-Z, a-z, 0-9, +, /, = are allowed."
+              }
+            ],
+            isError: true
+          };
+        }
+        const approxSize = approxBase64Size(stripped);
+        if (approxSize > MAX_BASE64_SIZE) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `file_data exceeds the 10MB base64 cap (got ~${(approxSize / 1024 / 1024).toFixed(1)}MB). Alternatives, in order of preference: (1) if this media came from another tool here (generate_image/video, create_carousel), pass its job_id or r2_key directly to schedule_post \u2014 do not re-upload. (2) for user-authored files, call request_upload_session to get a tokenized Dashboard URL where the user uploads directly to R2 in their browser. (3) for stdio/local mode, pass a filesystem path via \`source\` so the server can stream and use presigned PUT.`
+              }
+            ],
+            isError: true
+          };
+        }
+        const safeName = basename(file_name ?? "upload");
+        const uploadBody2 = {
+          fileData: `data:${ct};base64,${stripped}`,
+          contentType: ct,
+          fileName: safeName,
+          projectId: project_id
+        };
+        const { data: data2, error: error2 } = await callEdgeFunction("upload-to-r2", uploadBody2, { timeoutMs: 6e4 });
+        if (error2) {
+          await logMcpToolInvocation({
+            toolName: "upload_media",
+            status: "error",
+            durationMs: Date.now() - startedAt,
+            details: { error: error2, source: "base64", contentType: ct, size: approxSize }
+          });
+          return {
+            content: [{ type: "text", text: `Upload failed: ${error2}` }],
+            isError: true
+          };
+        }
+        if (!data2?.key) {
+          return {
+            content: [{ type: "text", text: "Upload returned no R2 key." }],
+            isError: true
+          };
+        }
+        await logMcpToolInvocation({
+          toolName: "upload_media",
+          status: "success",
+          durationMs: Date.now() - startedAt,
+          details: {
+            source: "base64",
+            r2Key: data2.key,
+            size: data2.size,
+            contentType: data2.contentType
+          }
+        });
+        if (format === "json") {
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(
+                  {
+                    r2_key: data2.key,
+                    signed_url: data2.url,
+                    size: data2.size,
+                    content_type: data2.contentType
+                  },
+                  null,
+                  2
+                )
+              }
+            ],
+            isError: false
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: [
+                "Media uploaded successfully.",
+                `Media key: ${maskR2Key(data2.key)}`,
+                `Signed URL: ${data2.url}`,
+                `Size: ${(data2.size / 1024).toFixed(0)}KB`,
+                `Type: ${data2.contentType}`,
+                "",
+                "Use job_id or response_format=json with schedule_post to post to any platform."
+              ].join("\n")
+            }
+          ],
+          isError: false
+        };
+      }
+      const src = source;
+      const isUrl = src.startsWith("http://") || src.startsWith("https://");
       let uploadBody;
       if (isUrl) {
-        const ct = content_type || inferContentType(source);
+        const ct = content_type || inferContentType(src);
         uploadBody = {
-          url: source,
+          url: src,
           contentType: ct,
-          fileName: basename(new URL(source).pathname) || "upload",
+          fileName: basename(file_name ?? new URL(src).pathname) || "upload",
           projectId: project_id
         };
       } else {
         let fileBuffer;
         try {
-          fileBuffer = await readFile(source);
-        } catch (err) {
+          fileBuffer = await readFile(src);
+        } catch {
           await logMcpToolInvocation({
             toolName: "upload_media",
             status: "error",
             durationMs: Date.now() - startedAt,
-            details: { error: `File not found: ${source}` }
+            details: { error: "File not found", source: "local" }
           });
           return {
             content: [
               {
                 type: "text",
-                text: `File not found or not readable: ${source}`
+                text: `File not found or not readable: ${src}. Remote agents (Claude Web/Desktop) cannot see the MCP server's filesystem \u2014 pass the bytes via the \`file_data\` parameter (base64, up to 10MB) instead.`
               }
             ],
             isError: true
           };
         }
-        const ct = content_type || inferContentType(source);
+        const ct = content_type || inferContentType(src);
         if (fileBuffer.length > MAX_BASE64_SIZE) {
           const { data: putData, error: putError } = await callEdgeFunction(
             "get-signed-url",
             {
               operation: "put",
               contentType: ct,
-              filename: basename(source),
+              filename: basename(file_name ?? src),
               projectId: project_id
             },
             { timeoutMs: 1e4 }
@@ -7132,7 +7562,7 @@ function registerMediaTools(server2) {
         uploadBody = {
           fileData: base64,
           contentType: ct,
-          fileName: basename(source),
+          fileName: basename(file_name ?? src),
           projectId: project_id
         };
       }
@@ -7449,230 +7879,81 @@ function registerAnalyticsTools(server2) {
         `Analytics refresh triggered successfully.`,
         `  Posts processed: ${result.postsProcessed}`,
         `  Jobs queued: ${queued}`
-      ];
-      if (errored > 0) {
-        lines.push(`  Errors: ${errored}`);
-      }
-      await logMcpToolInvocation({
-        toolName: "refresh_platform_analytics",
-        status: "success",
-        durationMs: Date.now() - startedAt,
-        details: {
-          postsProcessed: result.postsProcessed,
-          queued,
-          errored
-        }
-      });
-      if (format === "json") {
-        return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify(
-                asEnvelope3({
-                  success: true,
-                  postsProcessed: result.postsProcessed,
-                  queued,
-                  errored
-                }),
-                null,
-                2
-              )
-            }
-          ]
-        };
-      }
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-  );
-}
-function formatAnalytics(summary, days, format) {
-  if (format === "json") {
-    return {
-      content: [
-        { type: "text", text: JSON.stringify(asEnvelope3({ ...summary, days }), null, 2) }
-      ]
-    };
-  }
-  const lines = [
-    `Analytics Summary (last ${days} days${summary.platform ? `, ${summary.platform}` : ""}):`,
-    "",
-    `  Total Views: ${summary.totalViews.toLocaleString()}`,
-    `  Total Engagement: ${summary.totalEngagement.toLocaleString()}`,
-    `  Posts Analyzed: ${summary.postCount}`,
-    ""
-  ];
-  if (summary.posts.length > 0) {
-    lines.push("Top Posts:");
-    const sorted = [...summary.posts].sort((a, b) => b.views - a.views);
-    for (const post of sorted.slice(0, 10)) {
-      const title = post.title || "(untitled)";
-      let line = `  [${post.platform}] ${title} - ${post.views.toLocaleString()} views, ${post.engagement} engagement`;
-      if (post.content_type || post.model_used) {
-        const meta = [post.content_type, post.model_used].filter(Boolean).join(", ");
-        line += ` (${meta})`;
-      }
-      lines.push(line);
-    }
-  }
-  return {
-    content: [{ type: "text", text: lines.join("\n") }]
-  };
-}
-
-// src/tools/brand.ts
-init_edge_function();
-init_supabase();
-import { z as z6 } from "zod";
-
-// src/lib/ssrf.ts
-var BLOCKED_IP_PATTERNS = [
-  // IPv4 localhost/loopback
-  /^127\./,
-  /^0\./,
-  // IPv4 private ranges (RFC 1918)
-  /^10\./,
-  /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
-  /^192\.168\./,
-  // IPv4 link-local
-  /^169\.254\./,
-  // Cloud metadata endpoint (AWS, GCP, Azure)
-  /^169\.254\.169\.254$/,
-  // IPv4 broadcast
-  /^255\./,
-  // Shared address space (RFC 6598)
-  /^100\.(6[4-9]|[7-9][0-9]|1[0-1][0-9]|12[0-7])\./
-];
-var BLOCKED_IPV6_PATTERNS = [
-  /^::1$/i,
-  // loopback
-  /^::$/i,
-  // unspecified
-  /^fe[89ab][0-9a-f]:/i,
-  // link-local fe80::/10
-  /^fc[0-9a-f]:/i,
-  // unique local fc00::/7
-  /^fd[0-9a-f]:/i,
-  // unique local fc00::/7
-  /^::ffff:127\./i,
-  // IPv4-mapped localhost
-  /^::ffff:(0|10|127|169\.254|172\.(1[6-9]|2[0-9]|3[0-1])|192\.168)\./i
-  // IPv4-mapped private
-];
-var BLOCKED_HOSTNAMES = [
-  "localhost",
-  "localhost.localdomain",
-  "local",
-  "127.0.0.1",
-  "0.0.0.0",
-  "[::1]",
-  "[::ffff:127.0.0.1]",
-  // Cloud metadata endpoints
-  "metadata.google.internal",
-  "metadata.goog",
-  "instance-data",
-  "instance-data.ec2.internal"
-];
-var ALLOWED_PROTOCOLS = ["http:", "https:"];
-var BLOCKED_PORTS = [22, 23, 25, 110, 143, 445, 3306, 5432, 6379, 27017, 11211];
-function isBlockedIP(ip) {
-  const normalized = ip.replace(/^\[/, "").replace(/\]$/, "");
-  if (normalized.includes(":")) {
-    return BLOCKED_IPV6_PATTERNS.some((pattern) => pattern.test(normalized));
-  }
-  return BLOCKED_IP_PATTERNS.some((pattern) => pattern.test(normalized));
-}
-function isBlockedHostname(hostname) {
-  return BLOCKED_HOSTNAMES.includes(hostname.toLowerCase());
-}
-function isIPAddress(hostname) {
-  const ipv4Pattern = /^(\d{1,3}\.){3}\d{1,3}$/;
-  const ipv6Pattern = /^\[?[a-fA-F0-9:]+\]?$/;
-  return ipv4Pattern.test(hostname) || ipv6Pattern.test(hostname);
-}
-async function validateUrlForSSRF(urlString) {
-  try {
-    const url = new URL(urlString);
-    if (!ALLOWED_PROTOCOLS.includes(url.protocol)) {
-      return {
-        isValid: false,
-        error: `Invalid protocol: ${url.protocol}. Only HTTP and HTTPS are allowed.`
-      };
-    }
-    if (url.username || url.password) {
-      return {
-        isValid: false,
-        error: "URLs with embedded credentials are not allowed."
-      };
-    }
-    const hostname = url.hostname.toLowerCase();
-    if (isBlockedHostname(hostname)) {
-      return {
-        isValid: false,
-        error: "Access to internal/localhost addresses is not allowed."
-      };
-    }
-    if (isIPAddress(hostname) && isBlockedIP(hostname)) {
-      return {
-        isValid: false,
-        error: "Access to private/internal IP addresses is not allowed."
-      };
-    }
-    const port = url.port ? parseInt(url.port, 10) : url.protocol === "https:" ? 443 : 80;
-    if (BLOCKED_PORTS.includes(port)) {
-      return {
-        isValid: false,
-        error: `Access to port ${port} is not allowed.`
-      };
-    }
-    let resolvedIP;
-    if (!isIPAddress(hostname)) {
-      try {
-        const dns = await import("node:dns");
-        const resolver = new dns.promises.Resolver();
-        const resolvedIPs = [];
-        try {
-          const aRecords = await resolver.resolve4(hostname);
-          resolvedIPs.push(...aRecords);
-        } catch {
-        }
-        try {
-          const aaaaRecords = await resolver.resolve6(hostname);
-          resolvedIPs.push(...aaaaRecords);
-        } catch {
-        }
-        if (resolvedIPs.length === 0) {
-          return {
-            isValid: false,
-            error: "DNS resolution failed: hostname did not resolve to any address."
-          };
-        }
-        for (const ip of resolvedIPs) {
-          if (isBlockedIP(ip)) {
-            return {
-              isValid: false,
-              error: "Hostname resolves to a private/internal IP address."
-            };
-          }
+      ];
+      if (errored > 0) {
+        lines.push(`  Errors: ${errored}`);
+      }
+      await logMcpToolInvocation({
+        toolName: "refresh_platform_analytics",
+        status: "success",
+        durationMs: Date.now() - startedAt,
+        details: {
+          postsProcessed: result.postsProcessed,
+          queued,
+          errored
         }
-        resolvedIP = resolvedIPs[0];
-      } catch {
+      });
+      if (format === "json") {
         return {
-          isValid: false,
-          error: "DNS resolution failed. Cannot verify hostname safety."
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                asEnvelope3({
+                  success: true,
+                  postsProcessed: result.postsProcessed,
+                  queued,
+                  errored
+                }),
+                null,
+                2
+              )
+            }
+          ]
         };
       }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
     }
-    return { isValid: true, sanitizedUrl: url.toString(), resolvedIP };
-  } catch (error) {
+  );
+}
+function formatAnalytics(summary, days, format) {
+  if (format === "json") {
     return {
-      isValid: false,
-      error: `Invalid URL format: ${error instanceof Error ? error.message : "Unknown error"}`
+      content: [
+        { type: "text", text: JSON.stringify(asEnvelope3({ ...summary, days }), null, 2) }
+      ]
     };
   }
+  const lines = [
+    `Analytics Summary (last ${days} days${summary.platform ? `, ${summary.platform}` : ""}):`,
+    "",
+    `  Total Views: ${summary.totalViews.toLocaleString()}`,
+    `  Total Engagement: ${summary.totalEngagement.toLocaleString()}`,
+    `  Posts Analyzed: ${summary.postCount}`,
+    ""
+  ];
+  if (summary.posts.length > 0) {
+    lines.push("Top Posts:");
+    const sorted = [...summary.posts].sort((a, b) => b.views - a.views);
+    for (const post of sorted.slice(0, 10)) {
+      const title = post.title || "(untitled)";
+      let line = `  [${post.platform}] ${title} - ${post.views.toLocaleString()} views, ${post.engagement} engagement`;
+      if (post.content_type || post.model_used) {
+        const meta = [post.content_type, post.model_used].filter(Boolean).join(", ");
+        line += ` (${meta})`;
+      }
+      lines.push(line);
+    }
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }]
+  };
 }
 
 // src/tools/brand.ts
+init_edge_function();
+init_supabase();
+import { z as z6 } from "zod";
 init_version();
 function asEnvelope4(data) {
   return {
@@ -7822,7 +8103,7 @@ function registerBrandTools(server2) {
   );
   server2.tool(
     "save_brand_profile",
-    "Persist a brand profile as the active profile for a project.",
+    "Save (or replace) the active brand profile for a project \u2014 voice, target audience, content pillars, claims, etc. Use after extract_brand has produced a draft AND the user has reviewed it, or when the user explicitly edits the profile. brand_context is the full profile payload from extract_brand or get_brand_profile. project_id defaults to the active project context. Overwrites the previous active profile (one per project) \u2014 pass the complete profile, no merge semantics. Use change_summary to leave an audit trail.",
     {
       project_id: z6.string().uuid().optional().describe("Project ID. Defaults to active project context."),
       brand_context: z6.record(z6.string(), z6.unknown()).describe("Brand context payload to save to brand_profiles.brand_context."),
@@ -8196,7 +8477,7 @@ function registerScreenshotTools(server2) {
         };
       } catch (err) {
         await closeBrowser();
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         await logMcpToolInvocation({
           toolName: "capture_app_page",
           status: "error",
@@ -8352,7 +8633,7 @@ function registerScreenshotTools(server2) {
         };
       } catch (err) {
         await closeBrowser();
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         await logMcpToolInvocation({
           toolName: "capture_screenshot",
           status: "error",
@@ -8646,7 +8927,7 @@ function registerRemotionTools(server2) {
           ]
         };
       } catch (err) {
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         await logMcpToolInvocation({
           toolName: "render_demo_video",
           status: "error",
@@ -8774,7 +9055,7 @@ function registerRemotionTools(server2) {
           ]
         };
       } catch (err) {
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         await logMcpToolInvocation({
           toolName: "render_template_video",
           status: "error",
@@ -9407,7 +9688,7 @@ function registerCommentsTools(server2) {
   );
   server2.tool(
     "post_comment",
-    "Post a new top-level comment on a YouTube video.",
+    "Post a new top-level comment on a YouTube video, authored as the connected channel. Use for proactive engagement on your own videos. For replies to existing comments use reply_to_comment instead \u2014 this tool only creates top-level comments. video_id comes from list_recent_posts (platform_post_id field) or any YouTube URL (the v= parameter, 11 chars). Subject to YouTube anti-spam rate limits; calls return rate_limited if exceeded.",
     {
       video_id: z11.string().describe("The YouTube video ID to comment on."),
       text: z11.string().min(1).describe("The comment text."),
@@ -9478,7 +9759,7 @@ function registerCommentsTools(server2) {
   );
   server2.tool(
     "moderate_comment",
-    "Moderate a YouTube comment by setting its status to published or rejected.",
+    'Moderate a YouTube comment on your channel \u2014 set status to "published" (approve) or "rejected" (hide from public view but kept in moderation queue). Use after list_comments surfaces a comment that needs action. For permanent removal use delete_comment instead. comment_id comes from list_comments results.',
     {
       comment_id: z11.string().describe("The comment ID to moderate."),
       moderation_status: z11.enum(["published", "rejected"]).describe('"published" to approve, "rejected" to hide.'),
@@ -10711,7 +10992,7 @@ function registerExtractionTools(server2) {
         };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "extract_url_content",
           status: "error",
@@ -11271,7 +11552,7 @@ ${rawText.slice(0, 1e3)}`
             }
           } catch (persistErr) {
             const durationMs2 = Date.now() - startedAt;
-            const message = sanitizeError2(persistErr);
+            const message = sanitizeError(persistErr);
             logMcpToolInvocation({
               toolName: "plan_content_week",
               status: "error",
@@ -11303,7 +11584,7 @@ ${rawText.slice(0, 1e3)}`
         };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "plan_content_week",
           status: "error",
@@ -11395,7 +11676,7 @@ ${rawText.slice(0, 1e3)}`
         };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "save_content_plan",
           status: "error",
@@ -11411,7 +11692,7 @@ ${rawText.slice(0, 1e3)}`
   );
   server2.tool(
     "get_content_plan",
-    "Retrieve a persisted content plan by ID.",
+    "Load a persisted content plan by its UUID \u2014 returns the full plan including all posts, scheduling status, and approval state. Use to inspect a plan before update_content_plan or schedule_content_plan. plan_id comes from save_content_plan, plan_content_week (when persisted), or list_plan_approvals. For just the approval state, list_plan_approvals is cheaper.",
     {
       plan_id: z20.string().uuid().describe("Persisted content plan ID"),
       response_format: z20.enum(["text", "json"]).default("json")
@@ -11465,7 +11746,7 @@ ${rawText.slice(0, 1e3)}`
   );
   server2.tool(
     "update_content_plan",
-    "Update individual posts in a persisted content plan.",
+    "Edit individual posts in a persisted content plan \u2014 change caption, title, hashtags, hook, or angle. Use after get_content_plan when the user wants to revise drafts before scheduling. Each post_updates entry must include post_id from the loaded plan; only the fields you pass get updated, others stay as-is. Does NOT trigger publishing \u2014 call schedule_content_plan separately when ready.",
     {
       plan_id: z20.string().uuid(),
       post_updates: z20.array(
@@ -11608,7 +11889,7 @@ function asEnvelope17(data) {
 function registerPlanApprovalTools(server2) {
   server2.tool(
     "create_plan_approvals",
-    "Create pending approval rows for each post in a content plan.",
+    'Create pending approval rows for each post in a content plan \u2014 one row per post, status="pending". Use after submit_content_plan_for_approval to materialize the approval queue. Each entry in posts becomes a row that respond_plan_approval can later approve, reject, or edit. Idempotent on (plan_id, post_id) \u2014 calling twice with the same posts is a no-op for already-existing rows. Returns IDs of created items for use with list_plan_approvals.',
     {
       plan_id: z21.string().uuid().describe("Content plan ID"),
       posts: z21.array(
@@ -11688,7 +11969,7 @@ function registerPlanApprovalTools(server2) {
   );
   server2.tool(
     "list_plan_approvals",
-    "List MCP-native approval items for a specific content plan.",
+    "List approval items for a content plan, optionally filtered by status (pending / approved / rejected / edited). Use to check what needs review before scheduling, or to audit decisions after the fact. plan_id comes from get_content_plan or save_content_plan. For a single item's full state, get the plan via get_content_plan instead \u2014 that includes per-post approval data inline.",
     {
       plan_id: z21.string().uuid().describe("Content plan ID"),
       status: z21.enum(["pending", "approved", "rejected", "edited"]).optional(),
@@ -11748,7 +12029,7 @@ function registerPlanApprovalTools(server2) {
   );
   server2.tool(
     "respond_plan_approval",
-    "Approve, reject, or edit a pending plan approval item.",
+    'Approve, reject, or edit a single pending plan approval item. Use to act on items surfaced by list_plan_approvals. decision="edited" REQUIRES edited_post containing the modified post fields \u2014 passing "edited" without edited_post returns an error. Once decided, an item cannot be re-decided (immutable transition). reason is optional but recommended for "rejected" or "edited" to leave a paper trail. After all items are decided, schedule_content_plan publishes only the approved (and edited) ones.',
     {
       approval_id: z21.string().uuid().describe("Approval item ID"),
       decision: z21.enum(["approved", "rejected", "edited"]),
@@ -12007,7 +12288,7 @@ function registerPipelineTools(server2) {
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "check_pipeline_readiness",
           status: "error",
@@ -12168,7 +12449,7 @@ function registerPipelineTools(server2) {
           } catch (deductErr) {
             errors.push({
               stage: "planning",
-              message: `Credit deduction failed: ${sanitizeError2(deductErr)}`
+              message: `Credit deduction failed: ${sanitizeError(deductErr)}`
             });
           }
         }
@@ -12339,7 +12620,7 @@ function registerPipelineTools(server2) {
             } catch (schedErr) {
               errors.push({
                 stage: "schedule",
-                message: `Failed to schedule ${post.id}: ${sanitizeError2(schedErr)}`
+                message: `Failed to schedule ${post.id}: ${sanitizeError(schedErr)}`
               });
             }
           }
@@ -12428,7 +12709,7 @@ function registerPipelineTools(server2) {
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "run_content_pipeline",
           status: "error",
@@ -12652,7 +12933,7 @@ function registerPipelineTools(server2) {
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "auto_approve_plan",
           status: "error",
@@ -12832,7 +13113,7 @@ ${i + 1}. ${s.topic}`);
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "suggest_next_content",
           status: "error",
@@ -13173,7 +13454,7 @@ Best: ${best.id.slice(0, 8)}... (${best.platform}) \u2014 ${best.views.toLocaleS
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "generate_performance_digest",
           status: "error",
@@ -13270,7 +13551,7 @@ Best: ${best.id.slice(0, 8)}... (${best.platform}) \u2014 ${best.views.toLocaleS
         return { content: [{ type: "text", text: lines.join("\n") }] };
       } catch (err) {
         const durationMs = Date.now() - startedAt;
-        const message = sanitizeError2(err);
+        const message = sanitizeError(err);
         logMcpToolInvocation({
           toolName: "detect_anomalies",
           status: "error",
@@ -13577,11 +13858,11 @@ function hexToLab(hex) {
   const lb = srgbToLinear(b);
   const x = lr * 0.4124564 + lg * 0.3575761 + lb * 0.1804375;
   const y = lr * 0.2126729 + lg * 0.7151522 + lb * 0.072175;
-  const z29 = lr * 0.0193339 + lg * 0.119192 + lb * 0.9503041;
+  const z31 = lr * 0.0193339 + lg * 0.119192 + lb * 0.9503041;
   const f = (t) => t > 8856e-6 ? Math.cbrt(t) : 7.787 * t + 16 / 116;
   const fx = f(x / 0.95047);
   const fy = f(y / 1);
-  const fz = f(z29 / 1.08883);
+  const fz = f(z31 / 1.08883);
   return { L: 116 * fy - 16, a: 500 * (fx - fy), b: 200 * (fy - fz) };
 }
 function deltaE2000(lab1, lab2) {
@@ -14303,7 +14584,7 @@ function registerCarouselTools(server2) {
               slideNumber: slide.slideNumber,
               jobId: null,
               model: image_model,
-              error: sanitizeError2(err)
+              error: sanitizeError(err)
             };
           }
         })
@@ -14408,6 +14689,345 @@ function registerCarouselTools(server2) {
   );
 }
 
+// src/apps/content-calendar.ts
+init_edge_function();
+import {
+  registerAppTool,
+  registerAppResource,
+  RESOURCE_MIME_TYPE
+} from "@modelcontextprotocol/ext-apps/server";
+import { z as z28 } from "zod";
+import fs from "node:fs/promises";
+import path from "node:path";
+var CALENDAR_URI = "ui://content-calendar/mcp-app.html";
+function startOfCurrentWeekMonday() {
+  const now = /* @__PURE__ */ new Date();
+  const day = now.getDay();
+  const monday = new Date(now);
+  monday.setUTCDate(now.getUTCDate() - day + (day === 0 ? -6 : 1));
+  return monday.toISOString().split("T")[0];
+}
+function registerContentCalendarApp(server2) {
+  registerAppTool(
+    server2,
+    "open_content_calendar",
+    {
+      title: "Content Calendar",
+      description: "Open an interactive drag-drop calendar showing the user's scheduled posts for the current week. Users can reschedule via drag, filter by platform, drill into any post, or quick-create a new post. Backed by list_recent_posts, schedule_post, and find_next_slots \u2014 no new tools needed.",
+      inputSchema: {
+        start_date: z28.string().optional().describe("ISO date for the week start (YYYY-MM-DD); defaults to the current week's Monday.")
+      },
+      _meta: {
+        ui: {
+          resourceUri: CALENDAR_URI,
+          csp: {
+            "img-src": ["'self'", "https://*.r2.cloudflarestorage.com", "data:"],
+            "connect-src": ["'self'"]
+          }
+        }
+      }
+    },
+    async ({ start_date }, extra) => {
+      const userScopes = extra.authInfo?.scopes ?? [];
+      const fromDate = start_date ?? startOfCurrentWeekMonday();
+      const { data: result, error } = await callEdgeFunction(
+        "mcp-data",
+        {
+          action: "recent-posts",
+          days: 14,
+          limit: 50
+        },
+        { timeoutMs: 15e3 }
+      );
+      if (error || !result?.success) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to load posts: ${error || result?.error || "Unknown error"}`
+            }
+          ],
+          isError: true
+        };
+      }
+      const posts = (result.posts ?? []).filter((p) => {
+        const ts = p.scheduled_at ?? p.published_at ?? p.created_at;
+        if (!ts) return false;
+        return ts.split("T")[0] >= fromDate;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({ posts, scopes: userScopes })
+          }
+        ]
+      };
+    }
+  );
+  registerAppResource(
+    server2,
+    CALENDAR_URI,
+    CALENDAR_URI,
+    { mimeType: RESOURCE_MIME_TYPE },
+    async () => {
+      const htmlPath = path.join(process.cwd(), "apps/content-calendar/dist/mcp-app.html");
+      try {
+        const html = await fs.readFile(htmlPath, "utf-8");
+        return {
+          contents: [{ uri: CALENDAR_URI, mimeType: RESOURCE_MIME_TYPE, text: html }]
+        };
+      } catch (err) {
+        const errorHtml = `<!DOCTYPE html>
+<html><head><title>Content Calendar \u2014 unavailable</title></head>
+<body style="font-family:sans-serif;padding:24px;color:#444;">
+  <h2>Content Calendar app bundle missing</h2>
+  <p>The server registered <code>open_content_calendar</code> but
+  <code>apps/content-calendar/dist/mcp-app.html</code> is not built.
+  Run <code>npm run build:app</code> in the mcp-server directory and redeploy.</p>
+  <p style="color:#999;font-size:12px;">${err.message}</p>
+</body></html>`;
+        return {
+          contents: [{ uri: CALENDAR_URI, mimeType: RESOURCE_MIME_TYPE, text: errorHtml }]
+        };
+      }
+    }
+  );
+}
+
+// src/tools/connections.ts
+init_edge_function();
+import { z as z29 } from "zod";
+init_supabase();
+var PLATFORM_ENUM4 = [
+  "youtube",
+  "tiktok",
+  "instagram",
+  "twitter",
+  "linkedin",
+  "facebook",
+  "threads",
+  "bluesky",
+  "shopify",
+  "etsy"
+];
+function findActiveAccount(accounts, platform3) {
+  const target = platform3.toLowerCase();
+  return accounts.find((a) => a.platform.toLowerCase() === target && a.status === "active") ?? null;
+}
+function registerConnectionTools(server2) {
+  server2.tool(
+    "start_platform_connection",
+    "Begin connecting a social platform (Instagram, TikTok, YouTube, etc.). Returns a single-use deep link the user opens in a browser to complete the one-time OAuth handshake on socialneuron.com. This is NOT another OAuth in Claude \u2014 platform connections require a browser session because the social platforms (Meta, Google, TikTok) only accept callbacks on socialneuron.com. After the user clicks the link and approves on the platform, call `wait_for_connection` to detect completion. Link expires in 2 minutes; mint a new one if needed. Use `list_connected_accounts` first to check whether the platform is already connected before calling this.",
+    {
+      platform: z29.enum(PLATFORM_ENUM4).describe("Platform to connect. Lower-case: instagram, tiktok, youtube, etc."),
+      response_format: z29.enum(["text", "json"]).optional().describe("Response format. Default: text.")
+    },
+    async ({ platform: platform3, response_format }) => {
+      const format = response_format ?? "text";
+      const startedAt = Date.now();
+      const rl = checkRateLimit("read", `start_platform_connection:${platform3}`);
+      if (!rl.allowed) {
+        await logMcpToolInvocation({
+          toolName: "start_platform_connection",
+          status: "rate_limited",
+          durationMs: Date.now() - startedAt,
+          details: { retryAfter: rl.retryAfter, platform: platform3 }
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Rate limit exceeded. Retry in ~${rl.retryAfter}s.`
+            }
+          ],
+          isError: true
+        };
+      }
+      const { data, error } = await callEdgeFunction("mcp-data", { action: "mint-connection-nonce", platform: platform3 }, { timeoutMs: 1e4 });
+      if (error || !data?.success || !data.deep_link) {
+        const errMsg = error ?? data?.error ?? "Unknown error";
+        await logMcpToolInvocation({
+          toolName: "start_platform_connection",
+          status: "error",
+          durationMs: Date.now() - startedAt,
+          details: { error: errMsg, platform: platform3 }
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Failed to start ${platform3} connection: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+      await logMcpToolInvocation({
+        toolName: "start_platform_connection",
+        status: "success",
+        durationMs: Date.now() - startedAt,
+        details: { platform: data.platform, expires_at: data.expires_at }
+      });
+      if (format === "json") {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  platform: data.platform,
+                  deep_link: data.deep_link,
+                  expires_at: data.expires_at,
+                  next_step: "Open deep_link in a browser, approve on the platform, then call wait_for_connection."
+                },
+                null,
+                2
+              )
+            }
+          ],
+          isError: false
+        };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: [
+              `${data.platform} connection ready.`,
+              "",
+              'Ask the user to open this link in a browser and click "Connect" on the platform:',
+              `  ${data.deep_link}`,
+              "",
+              `Link expires at: ${data.expires_at} (~2 minutes).`,
+              "",
+              "After they approve, call `wait_for_connection` with the same platform to confirm.",
+              "This is a one-time browser setup \u2014 not another OAuth flow inside Claude."
+            ].join("\n")
+          }
+        ],
+        isError: false
+      };
+    }
+  );
+  server2.tool(
+    "wait_for_connection",
+    "Poll until a platform connection becomes active. Use after `start_platform_connection` while the user completes the browser OAuth flow. Returns when the account row appears with status=active, or when the timeout elapses. Default timeout 120s, max 600s.",
+    {
+      platform: z29.enum(PLATFORM_ENUM4).describe("Platform to wait for."),
+      timeout_s: z29.number().min(5).max(600).optional().describe("How long to wait, in seconds. Default 120."),
+      poll_interval_s: z29.number().min(2).max(30).optional().describe("Poll interval in seconds. Default 5."),
+      response_format: z29.enum(["text", "json"]).optional().describe("Response format. Default: text.")
+    },
+    async ({ platform: platform3, timeout_s, poll_interval_s, response_format }) => {
+      const format = response_format ?? "text";
+      const startedAt = Date.now();
+      const timeoutMs = (timeout_s ?? 120) * 1e3;
+      const intervalMs = (poll_interval_s ?? 5) * 1e3;
+      const deadline = startedAt + timeoutMs;
+      const rl = checkRateLimit("read", `wait_for_connection:${platform3}`);
+      if (!rl.allowed) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Rate limit exceeded. Retry in ~${rl.retryAfter}s.`
+            }
+          ],
+          isError: true
+        };
+      }
+      let attempts = 0;
+      while (Date.now() < deadline) {
+        attempts++;
+        const { data, error } = await callEdgeFunction("mcp-data", { action: "connected-accounts" }, { timeoutMs: 1e4 });
+        if (!error && data?.success) {
+          const found = findActiveAccount(data.accounts ?? [], platform3);
+          if (found) {
+            await logMcpToolInvocation({
+              toolName: "wait_for_connection",
+              status: "success",
+              durationMs: Date.now() - startedAt,
+              details: { platform: platform3, attempts, found: true }
+            });
+            if (format === "json") {
+              return {
+                content: [
+                  {
+                    type: "text",
+                    text: JSON.stringify(
+                      {
+                        connected: true,
+                        platform: found.platform,
+                        account_id: found.id,
+                        username: found.username,
+                        connected_at: found.created_at,
+                        attempts
+                      },
+                      null,
+                      2
+                    )
+                  }
+                ],
+                isError: false
+              };
+            }
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: [
+                    `${found.platform} is connected.`,
+                    `Account: ${found.username || "(unnamed)"} (id=${found.id})`,
+                    `Detected after ${attempts} poll(s) in ${((Date.now() - startedAt) / 1e3).toFixed(1)}s.`,
+                    "Ready to call `schedule_post`."
+                  ].join("\n")
+                }
+              ],
+              isError: false
+            };
+          }
+        }
+        const remaining = deadline - Date.now();
+        if (remaining <= 0) break;
+        await new Promise((resolve3) => setTimeout(resolve3, Math.min(intervalMs, remaining)));
+      }
+      await logMcpToolInvocation({
+        toolName: "wait_for_connection",
+        status: "error",
+        durationMs: Date.now() - startedAt,
+        details: { platform: platform3, attempts, found: false, reason: "timeout" }
+      });
+      const message = `${platform3} did not connect within ${timeout_s ?? 120}s (${attempts} polls). The user may not have completed the browser OAuth yet, or the link expired. Mint a new link with \`start_platform_connection\` and try again, or have the user go directly to socialneuron.com/settings/connections.`;
+      if (format === "json") {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  connected: false,
+                  platform: platform3,
+                  attempts,
+                  timed_out: true,
+                  message
+                },
+                null,
+                2
+              )
+            }
+          ],
+          isError: true
+        };
+      }
+      return {
+        content: [{ type: "text", text: message }],
+        isError: true
+      };
+    }
+  );
+}
+
 // src/lib/register-tools.ts
 function applyScopeEnforcement(server2, scopeResolver) {
   const originalTool = server2.tool.bind(server2);
@@ -14437,7 +15057,7 @@ function applyScopeEnforcement(server2, scopeResolver) {
             content: [
               {
                 type: "text",
-                text: `Permission denied: '${name}' requires scope '${requiredScope}'. Generate a new key with the required scope at https://socialneuron.com/settings/developer`
+                text: `Permission denied: '${name}' requires scope '${requiredScope}'. Your scopes: [${userScopes.join(", ")}]. API-key users: regenerate your key with this scope at https://socialneuron.com/settings/developer. OAuth users (Claude Custom Connector): this scope is not enabled for your plan tier.`
               }
             ],
             isError: true
@@ -14513,21 +15133,25 @@ function registerAllTools(server2, options) {
   registerDigestTools(server2);
   registerBrandRuntimeTools(server2);
   registerCarouselTools(server2);
+  registerConnectionTools(server2);
+  if (!options?.skipApps) {
+    registerContentCalendarApp(server2);
+  }
   applyAnnotations(server2);
 }
 
 // src/prompts.ts
-import { z as z28 } from "zod";
+import { z as z30 } from "zod";
 function registerPrompts(server2) {
   server2.prompt(
     "create_weekly_content_plan",
     "Generate a full week of social media content (7 days, multiple platforms). Returns a structured plan with topics, formats, and posting times.",
     {
-      niche: z28.string().describe('Your content niche or industry (e.g., "fitness coaching", "SaaS marketing")'),
-      platforms: z28.string().optional().describe(
+      niche: z30.string().describe('Your content niche or industry (e.g., "fitness coaching", "SaaS marketing")'),
+      platforms: z30.string().optional().describe(
         'Comma-separated platforms to target (default: "YouTube, Instagram, TikTok, LinkedIn")'
       ),
-      tone: z28.string().optional().describe('Brand tone of voice (e.g., "professional", "casual", "bold and edgy")')
+      tone: z30.string().optional().describe('Brand tone of voice (e.g., "professional", "casual", "bold and edgy")')
     },
     ({ niche, platforms, tone }) => {
       const targetPlatforms = platforms || "YouTube, Instagram, TikTok, LinkedIn";
@@ -14569,8 +15193,8 @@ After building the plan, use \`save_content_plan\` to save it.`
     "analyze_top_content",
     "Analyze your best-performing posts to identify patterns and replicate success. Returns insights on hooks, formats, timing, and topics that resonate.",
     {
-      timeframe: z28.string().optional().describe('Analysis period (default: "30 days"). E.g., "7 days", "90 days"'),
-      platform: z28.string().optional().describe('Filter to a specific platform (e.g., "youtube", "instagram")')
+      timeframe: z30.string().optional().describe('Analysis period (default: "30 days"). E.g., "7 days", "90 days"'),
+      platform: z30.string().optional().describe('Filter to a specific platform (e.g., "youtube", "instagram")')
     },
     ({ timeframe, platform: platform3 }) => {
       const period = timeframe || "30 days";
@@ -14607,10 +15231,10 @@ Format as a clear, actionable performance report.`
     "repurpose_content",
     "Take one piece of content and transform it into 8-10 pieces across multiple platforms and formats.",
     {
-      source: z28.string().describe(
+      source: z30.string().describe(
         "The source content to repurpose \u2014 a URL, transcript, or the content text itself"
       ),
-      target_platforms: z28.string().optional().describe(
+      target_platforms: z30.string().optional().describe(
         'Comma-separated target platforms (default: "Twitter, LinkedIn, Instagram, TikTok, YouTube")'
       )
     },
@@ -14652,9 +15276,9 @@ For each piece, include the platform, format, character count, and suggested pos
     "setup_brand_voice",
     "Define or refine your brand voice profile so all generated content stays on-brand. Walks through tone, audience, values, and style.",
     {
-      brand_name: z28.string().describe("Your brand or business name"),
-      industry: z28.string().optional().describe('Your industry or niche (e.g., "B2B SaaS", "fitness coaching")'),
-      website: z28.string().optional().describe("Your website URL for context")
+      brand_name: z30.string().describe("Your brand or business name"),
+      industry: z30.string().optional().describe('Your industry or niche (e.g., "B2B SaaS", "fitness coaching")'),
+      website: z30.string().optional().describe("Your website URL for context")
     },
     ({ brand_name, industry, website }) => {
       const industryContext = industry ? ` in the ${industry} space` : "";
@@ -15168,7 +15792,7 @@ var server = new McpServer({
   version: MCP_VERSION
 });
 applyScopeEnforcement(server, getAuthenticatedScopes);
-registerAllTools(server);
+registerAllTools(server, { skipApps: true });
 registerPrompts(server);
 registerResources(server);
 async function shutdown() {