@socialneuron/mcp-server 1.8.0 → 1.8.1

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to `@socialneuron/mcp-server` will be documented in this file.
 
+## [1.8.1] - 2026-07-14
+
+### Fixed
+
+- **`create_storyboard` empty responses.** The tool now accepts the AI service's canonical `text` response field as well as the legacy `content` field, and reports a real tool error when neither contains a storyboard.
+- **Project isolation across the creative workflow.** `generate_image`, `create_storyboard`, `generate_voiceover`, and `render_hyperframes` now accept `project_id`. Analytics refresh, analytics reads, performance insights, and best-time recommendations are also project-scoped and default to the active project context.
+- **Autopilot run visibility.** `get_autopilot_status` now returns recent runs supplied by the backend instead of replacing them with an empty array.
+- **HyperFrames capability copy.** Removed the obsolete Phase-2/runtime-not-installed warning now that live HyperFrames renders complete successfully, and corrected image/storyboard/voiceover credit descriptions to match the client budget checks.
+
 ## [1.8.0] - 2026-07-14
 
 ### Changed

package/dist/http.js

@@ -1997,7 +1997,7 @@ function checkRateLimit(category, key) {
 init_supabase();
 
 // src/lib/version.ts
-var MCP_VERSION = "1.8.0";
+var MCP_VERSION = "1.8.1";
 
 // src/tools/ideation.ts
 function asEnvelope(data) {
@@ -2717,7 +2717,7 @@ function registerContentTools(server) {
   );
   server.tool(
     "generate_image",
-    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 2-10 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video).",
+    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 15-50 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video). Pass project_id so the asset is stored with the correct brand/project.",
     {
       prompt: z2.string().max(2e3).describe(
         "Text prompt describing the image to generate. Be specific about style, composition, colors, lighting, and subject matter."
@@ -2739,9 +2739,10 @@ function registerContentTools(server) {
       image_url: z2.string().optional().describe(
         "Reference image URL for image-to-image generation. Required for ideogram model. Optional for others."
       ),
+      project_id: z2.string().optional().describe("Project ID to associate the generated image with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ prompt, model, aspect_ratio, image_url, response_format }) => {
+    async ({ prompt, model, aspect_ratio, image_url, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const assetBudget = checkAssetBudget();
@@ -2777,7 +2778,8 @@ function registerContentTools(server) {
           prompt,
           model,
           aspectRatio: aspect_ratio ?? "1:1",
-          imageUrl: image_url
+          imageUrl: image_url,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 3e4 }
       );
@@ -2816,7 +2818,8 @@ function registerContentTools(server) {
                   jobId,
                   taskId: data.taskId,
                   asyncJobId: data.asyncJobId,
-                  model: data.model
+                  model: data.model,
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -2997,7 +3000,7 @@ function registerContentTools(server) {
   );
   server.tool(
     "create_storyboard",
-    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile for consistent visual branding across frames.",
+    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile and project_id for consistent, project-scoped production. Costs 10 credits.",
     {
       concept: z2.string().max(2e3).describe(
         'The video concept/idea. Include: hook, key messages, target audience, and desired outcome (e.g., "TikTok ad for VPN app targeting privacy-conscious millennials, hook with shocking stat about data leaks").'
@@ -3021,6 +3024,7 @@ function registerContentTools(server) {
       style: z2.string().optional().describe(
         'Visual style direction (e.g., "cinematic", "anime", "documentary", "motion graphics").'
       ),
+      project_id: z2.string().optional().describe("Project ID for brand-scoped generation and attribution."),
       response_format: z2.enum(["text", "json"]).optional().describe(
         "Response format. Defaults to json for structured storyboard data."
       )
@@ -3032,6 +3036,7 @@ function registerContentTools(server) {
       target_duration,
       num_scenes,
       style,
+      project_id,
       response_format
     }) => {
       const format = response_format ?? "json";
@@ -3114,7 +3119,8 @@ Return ONLY valid JSON in this exact format:
           prompt: storyboardPrompt,
           type: "storyboard",
           model: "gemini-2.5-flash",
-          responseFormat: "json"
+          responseFormat: "json",
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -3129,7 +3135,18 @@ Return ONLY valid JSON in this exact format:
           isError: true
         };
       }
-      const rawContent = data?.content ?? "";
+      const rawContent = data?.content?.trim() || data?.text?.trim() || "";
+      if (!rawContent) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Storyboard generation failed: the AI service returned an empty response."
+            }
+          ],
+          isError: true
+        };
+      }
       addCreditsUsed(estimatedCost);
       if (format === "json") {
         try {
@@ -3165,16 +3182,17 @@ Return ONLY valid JSON in this exact format:
   );
   server.tool(
     "generate_voiceover",
-    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Costs ~2 credits per generation.",
+    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Pass project_id to keep the asset with the correct brand/project. Costs 15 credits per generation.",
     {
       text: z2.string().max(5e3).describe("The script/text to convert to speech."),
       voice: z2.enum(["rachel", "domi"]).optional().describe(
         "Voice selection. rachel=warm female, domi=confident female. Defaults to rachel."
       ),
       speed: z2.number().min(0.5).max(2).optional().describe("Speech speed multiplier. 1.0 is normal. Defaults to 1.0."),
+      project_id: z2.string().optional().describe("Project ID to associate the generated voiceover with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Response format. Defaults to text.")
     },
-    async ({ text, voice, speed, response_format }) => {
+    async ({ text, voice, speed, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const estimatedCost = 15;
@@ -3209,7 +3227,8 @@ Return ONLY valid JSON in this exact format:
         {
           text,
           voiceId: ELEVENLABS_VOICE_IDS[voice ?? "rachel"],
-          speed: speed ?? 1
+          speed: speed ?? 1,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -3245,7 +3264,8 @@ Return ONLY valid JSON in this exact format:
                 asEnvelope2({
                   audioUrl: data.audioUrl,
                   durationSeconds: data.durationSeconds,
-                  voice: voice ?? "rachel"
+                  voice: voice ?? "rachel",
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -5713,7 +5733,7 @@ function asEnvelope4(data) {
 function registerAnalyticsTools(server) {
   server.tool(
     "fetch_analytics",
-    "Get post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
+    "Get project-scoped post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
     {
       platform: z5.enum([
         "youtube",
@@ -5731,19 +5751,22 @@ function registerAnalyticsTools(server) {
       content_id: z5.string().uuid().optional().describe(
         "Filter to a specific content_history ID to see performance of one piece of content."
       ),
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       limit: z5.number().min(1).max(100).optional().describe("Maximum number of posts to return. Defaults to 20."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform2, days, content_id, limit, response_format }) => {
+    async ({ platform: platform2, days, content_id, project_id, limit, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxPosts = limit ?? 20;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "analytics",
         platform: platform2,
         days: lookbackDays,
         limit: maxPosts,
-        contentId: content_id
+        contentId: content_id,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError) {
         return {
@@ -5813,14 +5836,19 @@ function registerAnalyticsTools(server) {
   );
   server.tool(
     "refresh_platform_analytics",
-    "Queue analytics refresh jobs for all posts from the last 7 days across connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
+    "Queue analytics refresh jobs for posts from the last 7 days in one project across its connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
     {
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ response_format }) => {
+    async ({ project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
-      const rateLimit = checkRateLimit("posting", `refresh_platform_analytics:${userId}`);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
+      const rateLimit = checkRateLimit(
+        "posting",
+        `refresh_platform_analytics:${userId}:${resolvedProjectId ?? "default"}`
+      );
       if (!rateLimit.allowed) {
         return {
           content: [
@@ -5832,7 +5860,10 @@ function registerAnalyticsTools(server) {
           isError: true
         };
       }
-      const { data, error } = await callEdgeFunction("fetch-analytics", { userId });
+      const { data, error } = await callEdgeFunction("fetch-analytics", {
+        userId,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
+      });
       if (error) {
         return {
           content: [{ type: "text", text: `Error refreshing analytics: ${error}` }],
@@ -5861,7 +5892,8 @@ function registerAnalyticsTools(server) {
           success: true,
           postsProcessed: result.postsProcessed,
           queued,
-          errored
+          errored,
+          projectId: resolvedProjectId ?? null
         });
         return {
           structuredContent,
@@ -6913,6 +6945,7 @@ function registerRemotionTools(server) {
 
 // src/tools/insights.ts
 import { z as z9 } from "zod";
+init_supabase();
 var MAX_INSIGHT_AGE_DAYS = 30;
 var PLATFORM_ENUM = [
   "youtube",
@@ -6937,22 +6970,25 @@ function asEnvelope6(data) {
 function registerInsightsTools(server) {
   server.tool(
     "get_performance_insights",
-    "Query performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
+    "Query project-scoped performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
     {
       insight_type: z9.enum(["top_hooks", "optimal_timing", "best_models", "competitor_patterns"]).optional().describe("Filter to a specific insight type."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to look back. Defaults to 30. Max 90."),
       limit: z9.number().min(1).max(50).optional().describe("Maximum number of insights to return. Defaults to 10."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ insight_type, days, limit, response_format }) => {
+    async ({ insight_type, days, limit, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxRows = limit ?? 10;
       const effectiveDays = Math.min(lookbackDays, MAX_INSIGHT_AGE_DAYS);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "performance-insights",
         days: effectiveDays,
-        limit: maxRows
+        limit: maxRows,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -7039,19 +7075,22 @@ function registerInsightsTools(server) {
   );
   server.tool(
     "get_best_posting_times",
-    "Analyze post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
+    "Analyze project-scoped post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
     {
       platform: z9.enum(PLATFORM_ENUM).optional().describe("Filter to a specific platform."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to analyze. Defaults to 30. Max 90."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform2, days, response_format }) => {
+    async ({ platform: platform2, days, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "best-posting-times",
         days: lookbackDays,
-        platform: platform2 ?? void 0
+        platform: platform2 ?? void 0,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -8144,7 +8183,7 @@ Schedule: ${JSON.stringify(updated.schedule_config)}`
       }
       const statusData = {
         activeConfigs: result?.activeConfigs ?? 0,
-        recentRuns: [],
+        recentRuns: result?.recentRuns ?? result?.recent_runs ?? [],
         pendingApprovals: result?.pendingApprovals ?? 0
       };
       if (format === "json") {
@@ -8166,8 +8205,20 @@ ${"=".repeat(40)}
       text += `Pending Approvals: ${statusData.pendingApprovals}
 
 `;
-      text += `No recent runs.
+      if (statusData.recentRuns.length === 0) {
+        text += `No recent runs.
 `;
+      } else {
+        text += `Recent Runs (${statusData.recentRuns.length}):
+`;
+        for (const run of statusData.recentRuns.slice(0, 10)) {
+          const id = String(run.id ?? run.run_id ?? "unknown");
+          const status = String(run.status ?? "unknown");
+          const credits = run.credits_used ?? run.creditsUsed;
+          text += `  ${id}: ${status}${credits == null ? "" : ` (${String(credits)} credits)`}
+`;
+        }
+      }
       return {
         content: [{ type: "text", text }]
       };
@@ -13297,7 +13348,7 @@ function registerHyperframesTools(server) {
   );
   server.tool(
     "render_hyperframes",
-    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Returns a job ID \u2014 poll with check_status. Note: F4 v1 ships the EF + scaffold; the worker container needs the hyperframes runtime installed (Phase 2) before this returns finished MP4s.",
+    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Pass project_id to keep the render with the correct brand/project. Returns a job ID \u2014 poll with check_status.",
     {
       composition_html: z30.string().max(5e5).optional().describe(
         "Inline HTML composition (full <html>...</html>). Max 500KB. Use composition_url for larger."
@@ -13309,7 +13360,8 @@ function registerHyperframesTools(server) {
       aspect_ratio: z30.enum(["9:16", "16:9", "1:1"]).optional().describe('Output aspect ratio. Default "9:16".'),
       duration_sec: z30.number().min(0.1).max(600).describe("Output duration in seconds. Required. Max 600 (10 min)."),
       fps: z30.union([z30.literal(24), z30.literal(30), z30.literal(60)]).optional().describe("Frames per second. Default 30."),
-      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master.")
+      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master."),
+      project_id: z30.string().optional().describe("Project ID to associate the Hyperframes render with.")
     },
     async ({
       composition_html,
@@ -13318,7 +13370,8 @@ function registerHyperframesTools(server) {
       aspect_ratio,
       duration_sec,
       fps,
-      quality
+      quality,
+      project_id
     }) => {
       const userId = await getDefaultUserId();
       const rateLimit = checkRateLimit("generation", `render_hyperframes:${userId}`);
@@ -13363,7 +13416,8 @@ function registerHyperframesTools(server) {
           aspectRatio: aspect_ratio || "9:16",
           durationSec: duration_sec,
           fps: fps || 30,
-          quality: quality || "standard"
+          quality: quality || "standard",
+          ...project_id && { projectId: project_id }
         });
         if (error || !data?.jobId) {
           throw new Error(error || data?.error || "Failed to create Hyperframes render job");
@@ -13379,7 +13433,7 @@ function registerHyperframesTools(server) {
                 `  Duration: ${duration_sec}s @ ${fps || 30}fps (${aspect_ratio || "9:16"})`,
                 `  Quality: ${quality || "standard"}`,
                 ``,
-                `Poll with check_status. Note: until F4 Phase 2 wires the runtime, the job will fail with a clear "HyperframesNotInstalled" message.`
+                `Poll with check_status.`
               ].join("\n")
             }
           ]

package/dist/index.js

@@ -19,7 +19,7 @@ var MCP_VERSION;
 var init_version = __esm({
   "src/lib/version.ts"() {
     "use strict";
-    MCP_VERSION = "1.8.0";
+    MCP_VERSION = "1.8.1";
   }
 });
 
@@ -2775,7 +2775,7 @@ function registerContentTools(server2) {
   );
   server2.tool(
     "generate_image",
-    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 2-10 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video).",
+    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 15-50 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video). Pass project_id so the asset is stored with the correct brand/project.",
     {
       prompt: z2.string().max(2e3).describe(
         "Text prompt describing the image to generate. Be specific about style, composition, colors, lighting, and subject matter."
@@ -2797,9 +2797,10 @@ function registerContentTools(server2) {
       image_url: z2.string().optional().describe(
         "Reference image URL for image-to-image generation. Required for ideogram model. Optional for others."
       ),
+      project_id: z2.string().optional().describe("Project ID to associate the generated image with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ prompt: prompt2, model, aspect_ratio, image_url, response_format }) => {
+    async ({ prompt: prompt2, model, aspect_ratio, image_url, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const assetBudget = checkAssetBudget();
@@ -2835,7 +2836,8 @@ function registerContentTools(server2) {
           prompt: prompt2,
           model,
           aspectRatio: aspect_ratio ?? "1:1",
-          imageUrl: image_url
+          imageUrl: image_url,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 3e4 }
       );
@@ -2874,7 +2876,8 @@ function registerContentTools(server2) {
                   jobId,
                   taskId: data.taskId,
                   asyncJobId: data.asyncJobId,
-                  model: data.model
+                  model: data.model,
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -3055,7 +3058,7 @@ function registerContentTools(server2) {
   );
   server2.tool(
     "create_storyboard",
-    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile for consistent visual branding across frames.",
+    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile and project_id for consistent, project-scoped production. Costs 10 credits.",
     {
       concept: z2.string().max(2e3).describe(
         'The video concept/idea. Include: hook, key messages, target audience, and desired outcome (e.g., "TikTok ad for VPN app targeting privacy-conscious millennials, hook with shocking stat about data leaks").'
@@ -3079,6 +3082,7 @@ function registerContentTools(server2) {
       style: z2.string().optional().describe(
         'Visual style direction (e.g., "cinematic", "anime", "documentary", "motion graphics").'
       ),
+      project_id: z2.string().optional().describe("Project ID for brand-scoped generation and attribution."),
       response_format: z2.enum(["text", "json"]).optional().describe(
         "Response format. Defaults to json for structured storyboard data."
       )
@@ -3090,6 +3094,7 @@ function registerContentTools(server2) {
       target_duration,
       num_scenes,
       style,
+      project_id,
       response_format
     }) => {
       const format = response_format ?? "json";
@@ -3172,7 +3177,8 @@ Return ONLY valid JSON in this exact format:
           prompt: storyboardPrompt,
           type: "storyboard",
           model: "gemini-2.5-flash",
-          responseFormat: "json"
+          responseFormat: "json",
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -3187,7 +3193,18 @@ Return ONLY valid JSON in this exact format:
           isError: true
         };
       }
-      const rawContent = data?.content ?? "";
+      const rawContent = data?.content?.trim() || data?.text?.trim() || "";
+      if (!rawContent) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Storyboard generation failed: the AI service returned an empty response."
+            }
+          ],
+          isError: true
+        };
+      }
       addCreditsUsed(estimatedCost);
       if (format === "json") {
         try {
@@ -3223,16 +3240,17 @@ Return ONLY valid JSON in this exact format:
   );
   server2.tool(
     "generate_voiceover",
-    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Costs ~2 credits per generation.",
+    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Pass project_id to keep the asset with the correct brand/project. Costs 15 credits per generation.",
     {
       text: z2.string().max(5e3).describe("The script/text to convert to speech."),
       voice: z2.enum(["rachel", "domi"]).optional().describe(
         "Voice selection. rachel=warm female, domi=confident female. Defaults to rachel."
       ),
       speed: z2.number().min(0.5).max(2).optional().describe("Speech speed multiplier. 1.0 is normal. Defaults to 1.0."),
+      project_id: z2.string().optional().describe("Project ID to associate the generated voiceover with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Response format. Defaults to text.")
     },
-    async ({ text, voice, speed, response_format }) => {
+    async ({ text, voice, speed, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const estimatedCost = 15;
@@ -3267,7 +3285,8 @@ Return ONLY valid JSON in this exact format:
         {
           text,
           voiceId: ELEVENLABS_VOICE_IDS[voice ?? "rachel"],
-          speed: speed ?? 1
+          speed: speed ?? 1,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -3303,7 +3322,8 @@ Return ONLY valid JSON in this exact format:
                 asEnvelope2({
                   audioUrl: data.audioUrl,
                   durationSeconds: data.durationSeconds,
-                  voice: voice ?? "rachel"
+                  voice: voice ?? "rachel",
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -5856,7 +5876,7 @@ function asEnvelope4(data) {
 function registerAnalyticsTools(server2) {
   server2.tool(
     "fetch_analytics",
-    "Get post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
+    "Get project-scoped post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
     {
       platform: z5.enum([
         "youtube",
@@ -5874,19 +5894,22 @@ function registerAnalyticsTools(server2) {
       content_id: z5.string().uuid().optional().describe(
         "Filter to a specific content_history ID to see performance of one piece of content."
       ),
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       limit: z5.number().min(1).max(100).optional().describe("Maximum number of posts to return. Defaults to 20."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform3, days, content_id, limit, response_format }) => {
+    async ({ platform: platform3, days, content_id, project_id, limit, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxPosts = limit ?? 20;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "analytics",
         platform: platform3,
         days: lookbackDays,
         limit: maxPosts,
-        contentId: content_id
+        contentId: content_id,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError) {
         return {
@@ -5956,14 +5979,19 @@ function registerAnalyticsTools(server2) {
   );
   server2.tool(
     "refresh_platform_analytics",
-    "Queue analytics refresh jobs for all posts from the last 7 days across connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
+    "Queue analytics refresh jobs for posts from the last 7 days in one project across its connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
     {
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ response_format }) => {
+    async ({ project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
-      const rateLimit = checkRateLimit("posting", `refresh_platform_analytics:${userId}`);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
+      const rateLimit = checkRateLimit(
+        "posting",
+        `refresh_platform_analytics:${userId}:${resolvedProjectId ?? "default"}`
+      );
       if (!rateLimit.allowed) {
         return {
           content: [
@@ -5975,7 +6003,10 @@ function registerAnalyticsTools(server2) {
           isError: true
         };
       }
-      const { data, error } = await callEdgeFunction("fetch-analytics", { userId });
+      const { data, error } = await callEdgeFunction("fetch-analytics", {
+        userId,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
+      });
       if (error) {
         return {
           content: [{ type: "text", text: `Error refreshing analytics: ${error}` }],
@@ -6004,7 +6035,8 @@ function registerAnalyticsTools(server2) {
           success: true,
           postsProcessed: result.postsProcessed,
           queued,
-          errored
+          errored,
+          projectId: resolvedProjectId ?? null
         });
         return {
           structuredContent,
@@ -7107,22 +7139,25 @@ function asEnvelope6(data) {
 function registerInsightsTools(server2) {
   server2.tool(
     "get_performance_insights",
-    "Query performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
+    "Query project-scoped performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
     {
       insight_type: z9.enum(["top_hooks", "optimal_timing", "best_models", "competitor_patterns"]).optional().describe("Filter to a specific insight type."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to look back. Defaults to 30. Max 90."),
       limit: z9.number().min(1).max(50).optional().describe("Maximum number of insights to return. Defaults to 10."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ insight_type, days, limit, response_format }) => {
+    async ({ insight_type, days, limit, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxRows = limit ?? 10;
       const effectiveDays = Math.min(lookbackDays, MAX_INSIGHT_AGE_DAYS);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "performance-insights",
         days: effectiveDays,
-        limit: maxRows
+        limit: maxRows,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -7209,19 +7244,22 @@ function registerInsightsTools(server2) {
   );
   server2.tool(
     "get_best_posting_times",
-    "Analyze post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
+    "Analyze project-scoped post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
     {
       platform: z9.enum(PLATFORM_ENUM).optional().describe("Filter to a specific platform."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to analyze. Defaults to 30. Max 90."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform3, days, response_format }) => {
+    async ({ platform: platform3, days, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "best-posting-times",
         days: lookbackDays,
-        platform: platform3 ?? void 0
+        platform: platform3 ?? void 0,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -7335,6 +7373,7 @@ var init_insights = __esm({
   "src/tools/insights.ts"() {
     "use strict";
     init_edge_function();
+    init_supabase();
     init_version();
     MAX_INSIGHT_AGE_DAYS = 30;
     PLATFORM_ENUM = [
@@ -8378,7 +8417,7 @@ Schedule: ${JSON.stringify(updated.schedule_config)}`
       }
       const statusData = {
         activeConfigs: result?.activeConfigs ?? 0,
-        recentRuns: [],
+        recentRuns: result?.recentRuns ?? result?.recent_runs ?? [],
         pendingApprovals: result?.pendingApprovals ?? 0
       };
       if (format === "json") {
@@ -8400,8 +8439,20 @@ ${"=".repeat(40)}
       text += `Pending Approvals: ${statusData.pendingApprovals}
 
 `;
-      text += `No recent runs.
+      if (statusData.recentRuns.length === 0) {
+        text += `No recent runs.
+`;
+      } else {
+        text += `Recent Runs (${statusData.recentRuns.length}):
+`;
+        for (const run of statusData.recentRuns.slice(0, 10)) {
+          const id = String(run.id ?? run.run_id ?? "unknown");
+          const status = String(run.status ?? "unknown");
+          const credits = run.credits_used ?? run.creditsUsed;
+          text += `  ${id}: ${status}${credits == null ? "" : ` (${String(credits)} credits)`}
 `;
+        }
+      }
       return {
         content: [{ type: "text", text }]
       };
@@ -13571,7 +13622,7 @@ function registerHyperframesTools(server2) {
   );
   server2.tool(
     "render_hyperframes",
-    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Returns a job ID \u2014 poll with check_status. Note: F4 v1 ships the EF + scaffold; the worker container needs the hyperframes runtime installed (Phase 2) before this returns finished MP4s.",
+    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Pass project_id to keep the render with the correct brand/project. Returns a job ID \u2014 poll with check_status.",
     {
       composition_html: z30.string().max(5e5).optional().describe(
         "Inline HTML composition (full <html>...</html>). Max 500KB. Use composition_url for larger."
@@ -13583,7 +13634,8 @@ function registerHyperframesTools(server2) {
       aspect_ratio: z30.enum(["9:16", "16:9", "1:1"]).optional().describe('Output aspect ratio. Default "9:16".'),
       duration_sec: z30.number().min(0.1).max(600).describe("Output duration in seconds. Required. Max 600 (10 min)."),
       fps: z30.union([z30.literal(24), z30.literal(30), z30.literal(60)]).optional().describe("Frames per second. Default 30."),
-      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master.")
+      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master."),
+      project_id: z30.string().optional().describe("Project ID to associate the Hyperframes render with.")
     },
     async ({
       composition_html,
@@ -13592,7 +13644,8 @@ function registerHyperframesTools(server2) {
       aspect_ratio,
       duration_sec,
       fps,
-      quality
+      quality,
+      project_id
     }) => {
       const userId = await getDefaultUserId();
       const rateLimit = checkRateLimit("generation", `render_hyperframes:${userId}`);
@@ -13637,7 +13690,8 @@ function registerHyperframesTools(server2) {
           aspectRatio: aspect_ratio || "9:16",
           durationSec: duration_sec,
           fps: fps || 30,
-          quality: quality || "standard"
+          quality: quality || "standard",
+          ...project_id && { projectId: project_id }
         });
         if (error || !data?.jobId) {
           throw new Error(error || data?.error || "Failed to create Hyperframes render job");
@@ -13653,7 +13707,7 @@ function registerHyperframesTools(server2) {
                 `  Duration: ${duration_sec}s @ ${fps || 30}fps (${aspect_ratio || "9:16"})`,
                 `  Quality: ${quality || "standard"}`,
                 ``,
-                `Poll with check_status. Note: until F4 Phase 2 wires the runtime, the job will fail with a clear "HyperframesNotInstalled" message.`
+                `Poll with check_status.`
               ].join("\n")
             }
           ]

package/dist/sn.js

@@ -19,7 +19,7 @@ var MCP_VERSION;
 var init_version = __esm({
   "src/lib/version.ts"() {
     "use strict";
-    MCP_VERSION = "1.8.0";
+    MCP_VERSION = "1.8.1";
   }
 });
 
@@ -4164,7 +4164,7 @@ function registerContentTools(server) {
   );
   server.tool(
     "generate_image",
-    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 2-10 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video).",
+    "Start an async AI image generation job \u2014 returns a job_id immediately. Poll with check_status every 5-15s until complete. Costs 15-50 credits depending on model. Use for social media posts, carousel slides, or as input to generate_video (image-to-video). Pass project_id so the asset is stored with the correct brand/project.",
     {
       prompt: z2.string().max(2e3).describe(
         "Text prompt describing the image to generate. Be specific about style, composition, colors, lighting, and subject matter."
@@ -4186,9 +4186,10 @@ function registerContentTools(server) {
       image_url: z2.string().optional().describe(
         "Reference image URL for image-to-image generation. Required for ideogram model. Optional for others."
       ),
+      project_id: z2.string().optional().describe("Project ID to associate the generated image with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ prompt: prompt2, model, aspect_ratio, image_url, response_format }) => {
+    async ({ prompt: prompt2, model, aspect_ratio, image_url, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const assetBudget = checkAssetBudget();
@@ -4224,7 +4225,8 @@ function registerContentTools(server) {
           prompt: prompt2,
           model,
           aspectRatio: aspect_ratio ?? "1:1",
-          imageUrl: image_url
+          imageUrl: image_url,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 3e4 }
       );
@@ -4263,7 +4265,8 @@ function registerContentTools(server) {
                   jobId,
                   taskId: data.taskId,
                   asyncJobId: data.asyncJobId,
-                  model: data.model
+                  model: data.model,
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -4444,7 +4447,7 @@ function registerContentTools(server) {
   );
   server.tool(
     "create_storyboard",
-    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile for consistent visual branding across frames.",
+    "Plan a multi-scene video storyboard with AI-generated prompts, durations, captions, and voiceover text per frame. Use before generate_video or generate_image to create cohesive multi-shot content. Include brand_context from get_brand_profile and project_id for consistent, project-scoped production. Costs 10 credits.",
     {
       concept: z2.string().max(2e3).describe(
         'The video concept/idea. Include: hook, key messages, target audience, and desired outcome (e.g., "TikTok ad for VPN app targeting privacy-conscious millennials, hook with shocking stat about data leaks").'
@@ -4468,6 +4471,7 @@ function registerContentTools(server) {
       style: z2.string().optional().describe(
         'Visual style direction (e.g., "cinematic", "anime", "documentary", "motion graphics").'
       ),
+      project_id: z2.string().optional().describe("Project ID for brand-scoped generation and attribution."),
       response_format: z2.enum(["text", "json"]).optional().describe(
         "Response format. Defaults to json for structured storyboard data."
       )
@@ -4479,6 +4483,7 @@ function registerContentTools(server) {
       target_duration,
       num_scenes,
       style,
+      project_id,
       response_format
     }) => {
       const format = response_format ?? "json";
@@ -4561,7 +4566,8 @@ Return ONLY valid JSON in this exact format:
           prompt: storyboardPrompt,
           type: "storyboard",
           model: "gemini-2.5-flash",
-          responseFormat: "json"
+          responseFormat: "json",
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -4576,7 +4582,18 @@ Return ONLY valid JSON in this exact format:
           isError: true
         };
       }
-      const rawContent = data?.content ?? "";
+      const rawContent = data?.content?.trim() || data?.text?.trim() || "";
+      if (!rawContent) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "Storyboard generation failed: the AI service returned an empty response."
+            }
+          ],
+          isError: true
+        };
+      }
       addCreditsUsed(estimatedCost);
       if (format === "json") {
         try {
@@ -4612,16 +4629,17 @@ Return ONLY valid JSON in this exact format:
   );
   server.tool(
     "generate_voiceover",
-    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Costs ~2 credits per generation.",
+    "Generate a voiceover audio file for video narration. Returns an R2-hosted audio URL. Use after create_storyboard to add narration to each scene, or standalone for podcast intros and ad reads. Pass project_id to keep the asset with the correct brand/project. Costs 15 credits per generation.",
     {
       text: z2.string().max(5e3).describe("The script/text to convert to speech."),
       voice: z2.enum(["rachel", "domi"]).optional().describe(
         "Voice selection. rachel=warm female, domi=confident female. Defaults to rachel."
       ),
       speed: z2.number().min(0.5).max(2).optional().describe("Speech speed multiplier. 1.0 is normal. Defaults to 1.0."),
+      project_id: z2.string().optional().describe("Project ID to associate the generated voiceover with."),
       response_format: z2.enum(["text", "json"]).optional().describe("Response format. Defaults to text.")
     },
-    async ({ text, voice, speed, response_format }) => {
+    async ({ text, voice, speed, project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
       const estimatedCost = 15;
@@ -4656,7 +4674,8 @@ Return ONLY valid JSON in this exact format:
         {
           text,
           voiceId: ELEVENLABS_VOICE_IDS[voice ?? "rachel"],
-          speed: speed ?? 1
+          speed: speed ?? 1,
+          ...project_id && { projectId: project_id }
         },
         { timeoutMs: 6e4 }
       );
@@ -4692,7 +4711,8 @@ Return ONLY valid JSON in this exact format:
                 asEnvelope2({
                   audioUrl: data.audioUrl,
                   durationSeconds: data.durationSeconds,
-                  voice: voice ?? "rachel"
+                  voice: voice ?? "rachel",
+                  projectId: project_id ?? null
                 }),
                 null,
                 2
@@ -7118,7 +7138,7 @@ function asEnvelope4(data) {
 function registerAnalyticsTools(server) {
   server.tool(
     "fetch_analytics",
-    "Get post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
+    "Get project-scoped post performance metrics \u2014 views, likes, comments, shares, and engagement rate. Filter by platform, time range (default 30 days), or specific content_id. Call refresh_platform_analytics first if data seems stale. Results sorted by most recent capture.",
     {
       platform: z5.enum([
         "youtube",
@@ -7136,19 +7156,22 @@ function registerAnalyticsTools(server) {
       content_id: z5.string().uuid().optional().describe(
         "Filter to a specific content_history ID to see performance of one piece of content."
       ),
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       limit: z5.number().min(1).max(100).optional().describe("Maximum number of posts to return. Defaults to 20."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform3, days, content_id, limit, response_format }) => {
+    async ({ platform: platform3, days, content_id, project_id, limit, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxPosts = limit ?? 20;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "analytics",
         platform: platform3,
         days: lookbackDays,
         limit: maxPosts,
-        contentId: content_id
+        contentId: content_id,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError) {
         return {
@@ -7218,14 +7241,19 @@ function registerAnalyticsTools(server) {
   );
   server.tool(
     "refresh_platform_analytics",
-    "Queue analytics refresh jobs for all posts from the last 7 days across connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
+    "Queue analytics refresh jobs for posts from the last 7 days in one project across its connected platforms. Call this before fetch_analytics if you need fresh data. Returns immediately \u2014 data updates asynchronously over the next 1-5 minutes.",
     {
+      project_id: z5.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z5.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ response_format }) => {
+    async ({ project_id, response_format }) => {
       const format = response_format ?? "text";
       const userId = await getDefaultUserId();
-      const rateLimit = checkRateLimit("posting", `refresh_platform_analytics:${userId}`);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
+      const rateLimit = checkRateLimit(
+        "posting",
+        `refresh_platform_analytics:${userId}:${resolvedProjectId ?? "default"}`
+      );
       if (!rateLimit.allowed) {
         return {
           content: [
@@ -7237,7 +7265,10 @@ function registerAnalyticsTools(server) {
           isError: true
         };
       }
-      const { data, error } = await callEdgeFunction("fetch-analytics", { userId });
+      const { data, error } = await callEdgeFunction("fetch-analytics", {
+        userId,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
+      });
       if (error) {
         return {
           content: [{ type: "text", text: `Error refreshing analytics: ${error}` }],
@@ -7266,7 +7297,8 @@ function registerAnalyticsTools(server) {
           success: true,
           postsProcessed: result.postsProcessed,
           queued,
-          errored
+          errored,
+          projectId: resolvedProjectId ?? null
         });
         return {
           structuredContent,
@@ -8369,22 +8401,25 @@ function asEnvelope6(data) {
 function registerInsightsTools(server) {
   server.tool(
     "get_performance_insights",
-    "Query performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
+    "Query project-scoped performance insights derived from post analytics. Returns metrics like engagement rate, view velocity, and click rate aggregated over time. Use this to understand what content is performing well.",
     {
       insight_type: z9.enum(["top_hooks", "optimal_timing", "best_models", "competitor_patterns"]).optional().describe("Filter to a specific insight type."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to look back. Defaults to 30. Max 90."),
       limit: z9.number().min(1).max(50).optional().describe("Maximum number of insights to return. Defaults to 10."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ insight_type, days, limit, response_format }) => {
+    async ({ insight_type, days, limit, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
       const maxRows = limit ?? 10;
       const effectiveDays = Math.min(lookbackDays, MAX_INSIGHT_AGE_DAYS);
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "performance-insights",
         days: effectiveDays,
-        limit: maxRows
+        limit: maxRows,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -8471,19 +8506,22 @@ function registerInsightsTools(server) {
   );
   server.tool(
     "get_best_posting_times",
-    "Analyze post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
+    "Analyze project-scoped post analytics data to find the best times to post for maximum engagement. Returns the top 5 time slots (day of week + hour) ranked by average engagement.",
     {
       platform: z9.enum(PLATFORM_ENUM).optional().describe("Filter to a specific platform."),
       days: z9.number().min(1).max(90).optional().describe("Number of days to analyze. Defaults to 30. Max 90."),
+      project_id: z9.string().optional().describe("Project ID. Defaults to the active project context."),
       response_format: z9.enum(["text", "json"]).optional().describe("Optional response format. Defaults to text.")
     },
-    async ({ platform: platform3, days, response_format }) => {
+    async ({ platform: platform3, days, project_id, response_format }) => {
       const format = response_format ?? "text";
       const lookbackDays = days ?? 30;
+      const resolvedProjectId = project_id ?? await getDefaultProjectId() ?? void 0;
       const { data: result, error: efError } = await callEdgeFunction("mcp-data", {
         action: "best-posting-times",
         days: lookbackDays,
-        platform: platform3 ?? void 0
+        platform: platform3 ?? void 0,
+        ...resolvedProjectId ? { projectId: resolvedProjectId, project_id: resolvedProjectId } : {}
       });
       if (efError || !result?.success) {
         return {
@@ -8597,6 +8635,7 @@ var init_insights = __esm({
   "src/tools/insights.ts"() {
     "use strict";
     init_edge_function();
+    init_supabase();
     init_version();
     MAX_INSIGHT_AGE_DAYS = 30;
     PLATFORM_ENUM = [
@@ -9640,7 +9679,7 @@ Schedule: ${JSON.stringify(updated.schedule_config)}`
       }
       const statusData = {
         activeConfigs: result?.activeConfigs ?? 0,
-        recentRuns: [],
+        recentRuns: result?.recentRuns ?? result?.recent_runs ?? [],
         pendingApprovals: result?.pendingApprovals ?? 0
       };
       if (format === "json") {
@@ -9662,8 +9701,20 @@ ${"=".repeat(40)}
       text += `Pending Approvals: ${statusData.pendingApprovals}
 
 `;
-      text += `No recent runs.
+      if (statusData.recentRuns.length === 0) {
+        text += `No recent runs.
+`;
+      } else {
+        text += `Recent Runs (${statusData.recentRuns.length}):
+`;
+        for (const run of statusData.recentRuns.slice(0, 10)) {
+          const id = String(run.id ?? run.run_id ?? "unknown");
+          const status = String(run.status ?? "unknown");
+          const credits = run.credits_used ?? run.creditsUsed;
+          text += `  ${id}: ${status}${credits == null ? "" : ` (${String(credits)} credits)`}
 `;
+        }
+      }
       return {
         content: [{ type: "text", text }]
       };
@@ -14833,7 +14884,7 @@ function registerHyperframesTools(server) {
   );
   server.tool(
     "render_hyperframes",
-    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Returns a job ID \u2014 poll with check_status. Note: F4 v1 ships the EF + scaffold; the worker container needs the hyperframes runtime installed (Phase 2) before this returns finished MP4s.",
+    "Render an HTML video composition (Hyperframes) to MP4. Author the composition as HTML with data-* timing attributes and GSAP timelines \u2014 frame-accurate, no React build step. Use list_hyperframes_blocks to see the pre-built block catalog. Pass project_id to keep the render with the correct brand/project. Returns a job ID \u2014 poll with check_status.",
     {
       composition_html: z30.string().max(5e5).optional().describe(
         "Inline HTML composition (full <html>...</html>). Max 500KB. Use composition_url for larger."
@@ -14845,7 +14896,8 @@ function registerHyperframesTools(server) {
       aspect_ratio: z30.enum(["9:16", "16:9", "1:1"]).optional().describe('Output aspect ratio. Default "9:16".'),
       duration_sec: z30.number().min(0.1).max(600).describe("Output duration in seconds. Required. Max 600 (10 min)."),
       fps: z30.union([z30.literal(24), z30.literal(30), z30.literal(60)]).optional().describe("Frames per second. Default 30."),
-      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master.")
+      quality: z30.enum(["draft", "standard", "high"]).optional().describe("draft: fast iteration; standard: production; high: final master."),
+      project_id: z30.string().optional().describe("Project ID to associate the Hyperframes render with.")
     },
     async ({
       composition_html,
@@ -14854,7 +14906,8 @@ function registerHyperframesTools(server) {
       aspect_ratio,
       duration_sec,
       fps,
-      quality
+      quality,
+      project_id
     }) => {
       const userId = await getDefaultUserId();
       const rateLimit = checkRateLimit("generation", `render_hyperframes:${userId}`);
@@ -14899,7 +14952,8 @@ function registerHyperframesTools(server) {
           aspectRatio: aspect_ratio || "9:16",
           durationSec: duration_sec,
           fps: fps || 30,
-          quality: quality || "standard"
+          quality: quality || "standard",
+          ...project_id && { projectId: project_id }
         });
         if (error || !data?.jobId) {
           throw new Error(error || data?.error || "Failed to create Hyperframes render job");
@@ -14915,7 +14969,7 @@ function registerHyperframesTools(server) {
                 `  Duration: ${duration_sec}s @ ${fps || 30}fps (${aspect_ratio || "9:16"})`,
                 `  Quality: ${quality || "standard"}`,
                 ``,
-                `Poll with check_status. Note: until F4 Phase 2 wires the runtime, the job will fail with a clear "HyperframesNotInstalled" message.`
+                `Poll with check_status.`
               ].join("\n")
             }
           ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@socialneuron/mcp-server",
   "mcpName": "com.socialneuron/mcp-server",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "Official MCP server, REST API & CLI for Social Neuron — create, schedule, and optimize social content with 35+ AI models across YouTube, TikTok, and more.",
   "type": "module",
   "main": "dist/index.js",
@@ -87,7 +87,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "1.7.4",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@supabase/supabase-js": "2.108.2",
+    "@supabase/supabase-js": "2.109.0",
     "express": "^5.1.0",
     "jose": "^6.2.1",
     "open": "10.0.0",

package/tools.lock.json

@@ -30,7 +30,7 @@
     "create_autopilot_config": "e87d1e4a35a27ea161274731020ea250b0a737a8c2aa717d545f3d5078e4a7e3",
     "create_carousel": "b7d3c22e960fe0c8343319d41f5c602f97990fb5796b29ee8b278161c0f08280",
     "create_plan_approvals": "75eb7eee9d01e280c9bfe1415bc2dba8c55538abf5fdc452ac91fa84d65d3146",
-    "create_storyboard": "de169bb9bfb42c52a80325fd41833c7edd84f0618739fd0ff4acc136d865b323",
+    "create_storyboard": "7660532549ddcd099b925ec0fc0152e7caf7c2975b9a1e57cf4e5ec77d069f2e",
     "delete_comment": "4ccba2a7dc337350a9867d9c95d56bcf6c70a2631ef86d0fb11b9dec4b424045",
     "detect_anomalies": "b7d25cccfe416b6a8d1b66dd3cbe39dc02d24ab7882ff7dca4a045fab3ce566f",
     "execute_recipe": "a0622fedcb6bc8cb55e3219bd27dad81908190bd0294908ef2392400133c6721",
@@ -39,21 +39,21 @@
     "extract_brand": "5c75c62f4c5b65ab1f23e8c7f897f23aaf54efc3df2a5487d62bd0018da28541",
     "extract_url_content": "f9590296a6209b9c445e0487fc12c7bf9f10eeba25dbe1fb8ccd578b405a03c3",
     "fetch": "22f077d7298f21c2eaae9e1f5c280d8f44da01a44a3bfd33f273f381132382e0",
-    "fetch_analytics": "511a363a6f46bb9145177aa90dc72c44988e81be92db2370d247c5d2421ed333",
+    "fetch_analytics": "90980b107c4cb78611d13ab79c8851a2017fc1880212c500739b7e735e5bc1d6",
     "fetch_trends": "9efd2a24c9f9d9a3a6fa707f2355c8ef0d12dbc25f416e9237c0b9b73d15007b",
     "fetch_youtube_analytics": "c1d6cf67a5d0ad1696b4320ee91de7ddf58af6cf4a3be537636be746a4822af7",
     "find_next_slots": "fccf3bc7a8ac54b7ee243c59272252dbfeb307ca8d2987b1527b3b904408c909",
     "find_winning_content": "f124ae937ea5c3bda8ff9eae82c0ad5b6b095c9a8b1b1812931e10a5b6b35766",
     "generate_carousel": "ef7ec2137cd8a36c4cf0435e0b96337173807f147e29b6f73b5c5f8874f36b1e",
     "generate_content": "c741fd25d78e09fecc72fb1ee0b48371c2c2568567ad0f7697b4a95aa9f2640f",
-    "generate_image": "e208e39cbe09fb64735d745f388d2487ba962dbc5e3e10ea86f05f3181667ee3",
+    "generate_image": "24e636035023069009c342c84648bbcc5c49814ce67b6cab245d34bc604b7832",
     "generate_performance_digest": "8bbb53edc46698927a10372444239ba9973c5c84e2d0a8160f74192495dae74b",
     "generate_video": "59132d0dde96d733b8b3635bbf9cf66eda7c8d8739caf6303f5d98fc36c519f8",
-    "generate_voiceover": "46dbb1a9462af8a7fb66812192997bea6bb0b816db94ce27fd1284241ec5eb24",
+    "generate_voiceover": "989d385e10f5024906ece521a4ac9338bf478621655ae6384dbcc84efa56c27d",
     "get_active_campaigns": "2e593f72a0a4e1a7744049556444c64eda760a40f5c08d603c32b3b34b1d760a",
     "get_autopilot_status": "c6e689867a32a491a7afbbae46326d223bba412f0c66113ddf4be831c73fd769",
     "get_bandit_state": "1e58ef7836e24d6c9d474bea52916c15397611200e779ded692cc34fe882352f",
-    "get_best_posting_times": "78932988a8a2238d81c7b2c065e95349fda3e226702998fb08262b74baff6a53",
+    "get_best_posting_times": "79c0eceb8da96265478bad0989cd543e70363f8708962a864e4a975b9a594564",
     "get_brand_profile": "a0ebd63ebd7032de497751d2b35c0ec78c847869d64e54f7019baa5e532fed0e",
     "get_brand_runtime": "5ac3149d38eac100aca5d769ddb0f5d900832fb29eef78c18dc97678902e3a41",
     "get_budget_status": "ca79cc516af7ca950b0435949bd801b1e7dd4403eeb4e6152f3bde011ed4b834",
@@ -64,7 +64,7 @@
     "get_loop_summary": "e37bbc18048c039876dd4f4ba640dbb5e1efaf968fb887cb5479683e2840c1cc",
     "get_mcp_usage": "3e75743113a8e232c831f915edec38143528e92c504219ac3921d524f738df10",
     "get_media_url": "2132e420dc3df1a3c6b8d421b3530be23a7282b8f03af53d26707b337de73370",
-    "get_performance_insights": "88c6d44adddda1d8263bffdf6f924482f58b201ec4595afab9c7285bccd0379e",
+    "get_performance_insights": "d7d253877d8703da664085b1d0019824583856184152afc42211126cf3893865",
     "get_pipeline_status": "16ece649a0516d777ea75654b336ff1cffcfec5eb903960dc8f6d3499d823a0e",
     "get_recipe_details": "3d74e13a6b2814a414e89a4c75e6657c84aab611dce937ab117fd52e4f2b2eae",
     "get_recipe_run_status": "70e18a604307fc01f4fc87744c9caaf3d63abcd3ed7ce04af407954ecac2cbdc",
@@ -89,9 +89,9 @@
     "record_observation": "1c0e32121918b9d5891a28bde48edd364b64a73b3092a51788590f4c79ffb6c0",
     "record_outcome": "c38a7e37f243f5d0d2c64c5401cd1108ca33f239fdb714bc685104527d3494f0",
     "record_voice_lesson": "30590e1498a570c3ffd9a070e125b1e28e2cc5d8f98f347a76b43507e6adcc1f",
-    "refresh_platform_analytics": "2cb4e3c060aa26c6616c09fd5c8831f324fb232a2cdb17c69413db26ee732503",
+    "refresh_platform_analytics": "495b9c132fdd094b66b00c582ec94c4ed8c24080704c13f502982761ec817d61",
     "render_demo_video": "d11f88e7e0dd6829a00e500276c8e31501a5e44e06f53ea38b667b6db2ce64ee",
-    "render_hyperframes": "b085b9de37a49e027c88b028a926b9bf6f3bc6fce291864dcdcab60dc9ec1140",
+    "render_hyperframes": "2fbc2eaeca2da4ee7c19cf5e5b9e54f294d367cacfcbde333472d93238474a4d",
     "render_template_video": "1a64edb7fd60370bbabfa6751402c7ae32f3174c8c66d7269737297815d8ad92",
     "reply_to_comment": "ddf1ebefdeb25c1c1e95f7e5060224b88f8b85c4aec77cade4cfecf2c00abbf7",
     "respond_plan_approval": "60ef3827a8e199b140a1008746947d6753e766505b2dc69291dccddb276216e2",