@hubfluencer/mcp 0.1.0 → 0.3.0

package/README.md

@@ -12,6 +12,11 @@ auth is an opaque bearer token passed through from an env var.
 No install step — run it on demand with `npx` (commands below). For local development,
 build from source instead: see [Develop](#develop).
 
+> **Run these in a normal terminal** (Terminal, iTerm, your IDE's terminal) — **not inside a
+> running Claude Code / agent session.** A nested `claude` forwards its arguments to the model
+> as a prompt instead of executing the `mcp add` subcommand, so the server is never registered
+> (you'll later see `/mcp` → *Failed to reconnect: -32000*). See [Troubleshooting](#troubleshooting).
+
 ### 1. Connect (recommended — no copy-paste)
 
 Run the device-link login. It prints a URL + short code; you approve it in the signed-in
@@ -19,7 +24,7 @@ Hubfluencer app, and a scoped access token is saved locally to `~/.hubfluencer/c
 (mode 0600) — the MCP server reads it from there automatically.
 
 ```bash
-npx -y -p @hubfluencer/mcp hubfluencer-login "Claude Code"
+npx -y @hubfluencer/mcp login "Claude Code"
 #  1. Open:        https://hubfluencer.com/connect?code=ABCD-EFGH
 #  2. Confirm code: ABCDEFGH
 #  3. Click Approve.  →  ✓ Connected.
@@ -31,6 +36,12 @@ Then register the server (no token env needed — it uses the stored credential)
 claude mcp add hubfluencer -- npx -y @hubfluencer/mcp
 ```
 
+Verify it connected:
+
+```bash
+claude mcp list   # → hubfluencer: ... ✓ Connected
+```
+
 ### Alternative: paste an access token
 
 Create a token in the app (**Settings → Access tokens**, scoped `video:generate`+`video:read` —
@@ -96,6 +107,15 @@ If it returns `terminal:false`, the render is still going — call `wait_for_com
 > TikTok/Instagram requires a human-linked social account and is out of scope —
 > return the MP4 + a suggested caption instead.
 
+## Troubleshooting
+
+| Symptom | Cause & fix |
+|---|---|
+| `/mcp` → **Failed to reconnect: -32000** | The server process never started — almost always because `claude mcp add` was run **inside a Claude session** (a nested `claude` runs the line as a prompt, not the subcommand), so nothing was registered. Re-run the `claude mcp add` above in a **normal terminal**, then `claude mcp list` to confirm. |
+| `npm error could not determine executable to run` | You're on a cached **0.1.x** (which shipped two bins). 0.2.0+ ships a single bin and resolves cleanly. Force a fresh fetch: `npx --ignore-existing -y @hubfluencer/mcp`. |
+| `npm error 404 … @hubfluencer/mcp` immediately after a release | npm registry/CDN propagation lag (a couple of minutes after publish). Wait and retry — it self-heals. |
+| Tools fail with **"Not connected to Hubfluencer"** | No token resolved. Run `npx -y @hubfluencer/mcp login`, or pass `--env HUBFLUENCER_API_TOKEN=…`. |
+
 ## Develop
 
 ```bash
@@ -105,6 +125,10 @@ bun run dev        # runs the stdio server (talk to it via an MCP client)
 bun run build      # emits dist/
 ```
 
+The package exposes a single bin, `hubfluencer-mcp`: with no args it starts the stdio MCP
+server; `hubfluencer-mcp login [name]` runs the device-link login. This is why
+`npx -y @hubfluencer/mcp` and `npx -y @hubfluencer/mcp login` both work without `-p`.
+
 ## License
 
 [MIT](./LICENSE) © Monocursive

package/dist/index.js

@@ -11964,7 +11964,7 @@ var require_dist = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-import { writeFile } from "node:fs/promises";
+import { writeFile as writeFile2 } from "node:fs/promises";
 
 // ../../node_modules/@modelcontextprotocol/sdk/node_modules/zod/v3/helpers/util.js
 var util;
@@ -29569,11 +29569,88 @@ function clientFromEnv() {
   const token = process.env.HUBFLUENCER_API_TOKEN || stored.token;
   const baseUrl = process.env.HUBFLUENCER_BASE_URL || stored.base_url || "https://hubfluencer.com";
   if (!token) {
-    throw new Error("Not connected to Hubfluencer. Run `hubfluencer-login` to connect, or set " + "HUBFLUENCER_API_TOKEN (create one in the app: Settings → Access tokens).");
+    throw new Error("Not connected to Hubfluencer. Run `npx -y @hubfluencer/mcp login` to connect, or set " + "HUBFLUENCER_API_TOKEN (create one in the app: Settings → Access tokens).");
   }
   return new HubfluencerClient(baseUrl, token);
 }
 
+// src/login.ts
+import { chmod, mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+var MAX_POLLS = 120;
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+async function runLogin(clientName = "Claude Code") {
+  const BASE = (process.env.HUBFLUENCER_BASE_URL || "https://hubfluencer.com").replace(/\/+$/, "").replace(/\/api$/, "");
+  assertSafeBaseUrl(BASE);
+  const startRes = await fetch(`${BASE}/api/agent-link/start`, {
+    method: "POST",
+    headers: { "content-type": "application/json", accept: "application/json" },
+    body: JSON.stringify({
+      client_name: clientName,
+      scopes: ["video:generate", "video:read"]
+    })
+  });
+  if (!startRes.ok) {
+    console.error(`Could not start login (HTTP ${startRes.status}). Check HUBFLUENCER_BASE_URL.`);
+    process.exit(1);
+  }
+  const start = await startRes.json();
+  const url = start.verification_uri_complete || start.verification_uri;
+  console.error(`
+Connect this agent to Hubfluencer:
+`);
+  console.error(`  1. Open:   ${url}`);
+  console.error(`  2. Confirm code:  ${start.user_code}`);
+  console.error(`  3. Click Approve (you'll need to be signed in).
+`);
+  console.error("Waiting for approval…");
+  let intervalMs = Math.max(2, start.interval ?? 5) * 1000;
+  const MAX_INTERVAL_MS = 30000;
+  for (let i = 0;i < MAX_POLLS; i++) {
+    await sleep(intervalMs);
+    const pollRes = await fetch(`${BASE}/api/agent-link/poll`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        accept: "application/json"
+      },
+      body: JSON.stringify({ device_code: start.device_code })
+    });
+    const body = await pollRes.json().catch(() => ({}));
+    if (pollRes.ok && body.status === "approved" && body.token) {
+      await storeToken(body.token, BASE);
+      console.error(`
+✓ Connected. Access token saved to ${CREDENTIALS_PATH}.`);
+      console.error(`  Revoke anytime in the app: Settings → Access tokens.
+`);
+      return;
+    }
+    if (body.status === "slow_down") {
+      intervalMs = Math.min(intervalMs + 5000, MAX_INTERVAL_MS);
+      continue;
+    }
+    if (body.status === "pending")
+      continue;
+    console.error(`
+✗ ${body.error || body.status || `HTTP ${pollRes.status}`}. Run login again.`);
+    process.exit(1);
+  }
+  console.error(`
+✗ Timed out waiting for approval. Run login again.`);
+  process.exit(1);
+}
+async function storeToken(token, base) {
+  const dir = dirname(CREDENTIALS_PATH);
+  await mkdir(dir, { recursive: true, mode: 448 });
+  await writeFile(CREDENTIALS_PATH, JSON.stringify({ token, base_url: base }, null, 2), {
+    mode: 384
+  });
+  try {
+    await chmod(CREDENTIALS_PATH, 384);
+    await chmod(dir, 448);
+  } catch {}
+}
+
 // src/uploads.ts
 import { open, readFile, stat } from "node:fs/promises";
 import { basename, extname, isAbsolute as isAbsolute2, resolve as resolve2, sep as sep2 } from "node:path";
@@ -29745,6 +29822,14 @@ async function uploadImageFile(client, presignPath, filePath, maxBytes = MAX_IMA
   await putToPresignedUrl(presigned_url, buf, file.mime);
   return { s3_key };
 }
+async function uploadShortPoster(client, slug, filePath) {
+  const file = await resolveReadPath(filePath, IMAGE_EXT_MIME, MAX_IMAGE_BYTES);
+  const presign = await client.post(`/shorts/${slug}/poster/presign`, { content_type: file.mime });
+  const { upload_url, s3_key } = presign;
+  const buf = await readFile(file.path);
+  await putToPresignedUrl(upload_url, buf, file.mime);
+  return { s3_key };
+}
 
 // src/index.ts
 async function fetchStatus(client, kind, slug) {
@@ -29786,7 +29871,7 @@ async function downloadTo(videoUrl, savePath) {
     await reader.cancel().catch(() => {});
   }
   const buf = Buffer.concat(chunks, total);
-  await writeFile(target, buf);
+  await writeFile2(target, buf);
   return { saved_to: target, bytes: buf.length };
 }
 function ok(payload, links = []) {
@@ -29883,7 +29968,7 @@ function tool(fn) {
     }
   };
 }
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 var kindSchema = exports_external.enum(["short", "editor"]).describe("Project kind");
 var RO = { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 var WRITE = {
@@ -29891,7 +29976,7 @@ var WRITE = {
   destructiveHint: false,
   openWorldHint: true
 };
-var server = new McpServer({ name: "hubfluencer", version: "0.1.0" });
+var server = new McpServer({ name: "hubfluencer", version: "0.3.0" });
 var registerTool = server.registerTool.bind(server);
 async function pollToTerminal(client, kind, slug, extra, budgetMs, intervalMs) {
   const deadline = Date.now() + budgetMs;
@@ -29899,7 +29984,7 @@ async function pollToTerminal(client, kind, slug, extra, budgetMs, intervalMs) {
   let n = 0;
   while (!status.terminal && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `stage: ${status.stage}`);
-    await sleep(intervalMs);
+    await sleep2(intervalMs);
     status = await fetchStatus(client, kind, slug);
   }
   return status;
@@ -29921,7 +30006,7 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
   let { status, error: error2 } = await read();
   while (status !== "completed" && status !== "failed" && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `segment ${sid}: ${status}`);
-    await sleep(intervalMs);
+    await sleep2(intervalMs);
     ({ status, error: error2 } = await read());
   }
   return {
@@ -29932,13 +30017,17 @@ async function pollSegmentToTerminal(client, slug, segmentId, extra, budgetMs, i
 }
 registerTool("make_video", {
   title: "Make a video from a prompt (one shot)",
-  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish.",
+  description: "The simplest path: give a prompt, get a finished MP4. Creates the project (free), PRICES it against " + "your live credit balance, then — only if it's affordable and within max_credits — starts generation, " + "polls to completion (emitting progress), and (if save_path is given) downloads the result. " + "Spends credits (15 for a short; a multi-scene editor ad ~28). Pass dry_run:true to preview the cost " + "WITHOUT charging (returns {estimated_credits, available_credits, slug}); pass max_credits to cap the " + "spend. kind defaults to 'auto' — a multi-scene editor ad for ad/promo/story briefs, a single-clip short " + "for simple/short ones; the chosen kind is reported back as kind_inferred. If it returns terminal=false " + "the render is still running — call wait_for_completion with the returned slug to finish. " + "BE PROACTIVE WITH BRANDING: pass headline (the on-screen TITLE) and subheadline (secondary title) plus " + "music_vibe/theme so a one-shot short isn't bare — these apply to SHORTS (music_vibe/headline/subheadline " + "are ignored for editor; theme applies to both). For richer branding — a product image, brand logo, or " + "closing card — drive the granular path instead: create_short + set_short_product/set_short_poster, or " + "create_editor_draft + set_product/set_logo/set_closing_image, then start_autopilot/generate_short.",
   inputSchema: {
     prompt: exports_external.string().describe("What the ad/video should be about (min 10 chars)"),
     kind: exports_external.string().optional().describe("'short' (fast, 1 clip), 'editor' (multi-scene), or 'auto' (default — inferred)"),
     language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
     aspect: exports_external.string().optional().describe("Aspect ratio for editor: 9:16 (default), 16:9, or 1:1"),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id for editor ads (see list_voices); shorts have no voiceover"),
+    headline: exports_external.string().optional().describe("SHORTS only: the on-screen TITLE overlay (≤160). Set this so the short isn't bare."),
+    subheadline: exports_external.string().optional().describe("SHORTS only: the secondary title / supporting line (≤200)"),
+    music_vibe: exports_external.string().optional().describe("SHORTS only: music mood — Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz"),
+    theme: exports_external.string().optional().describe("Visual theme (both kinds): none (literal — no imposed style), realistic (default), cinematic, " + "anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, " + "minimalist, cyberpunk"),
     save_path: exports_external.string().optional().describe("Optional .mp4 path to download to (confined to HUBFLUENCER_OUTPUT_DIR or cwd)"),
     max_wait_seconds: exports_external.number().optional().describe("Block budget seconds (default 240, capped 10–280)"),
     dry_run: exports_external.boolean().optional().describe("Preview only: create a free draft, price it, and STOP before spending credits. " + "Returns {estimated_credits, available_credits, slug}. Resume with generate_short / start_autopilot."),
@@ -29957,15 +30046,23 @@ registerTool("make_video", {
     resolveSavePath(args.save_path);
   let slug;
   if (kind === "short") {
-    const created = await client.post("/shorts", { product_prompt: args.prompt, language: args.language }, idemKey("make-short", args.prompt, args.language ?? ""));
+    const created = await client.post("/shorts", {
+      product_prompt: args.prompt,
+      language: args.language,
+      headline: args.headline,
+      subheadline: args.subheadline,
+      music_vibe: args.music_vibe,
+      theme: args.theme
+    }, idemKey("make-short", args.prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? "", args.music_vibe ?? "", args.theme ?? ""));
     slug = created.data.slug;
   } else {
     const created = await client.post("/editor", {
       language: args.language ?? "en",
       product_prompt: args.prompt,
       export_aspect_ratio: args.aspect,
-      voice_id: args.voice_id
-    }, idemKey("make-editor", args.prompt, args.language ?? "en", args.aspect ?? "", args.voice_id ?? ""));
+      voice_id: args.voice_id,
+      theme: args.theme
+    }, idemKey("make-editor", args.prompt, args.language ?? "en", args.aspect ?? "", args.voice_id ?? "", args.theme ?? ""));
     slug = created.data.slug;
   }
   const costPath = kind === "short" ? `/shorts/${slug}/cost` : `/editor/${slug}/autopilot/cost`;
@@ -30024,7 +30121,17 @@ registerTool("get_credits", {
   description: "Returns the authenticated account's credit balance. A short costs 15 credits.",
   inputSchema: {},
   annotations: { title: "Get credits", ...RO }
-}, tool(async (_args, client) => ok(await client.get("/studio/credits"))));
+}, tool(async (_args, client) => {
+  const res = await client.get("/studio/credits");
+  const d = asRecord(asRecord(res).data);
+  return ok({
+    credits: d.credits,
+    spendable_credits: d.spendable_credits,
+    reserved_credits: d.reserved_credits,
+    remaining_reserved_credits: d.remaining_reserved_credits,
+    message: d.message
+  });
+}));
 registerTool("list_voices", {
   title: "List voices",
   description: "Lists available narration voices (id + name). Pass a voice id as voice_id to create_editor_ad / " + "make_video to pick the narration voice for an editor ad. Shorts have no voiceover.",
@@ -30064,19 +30171,48 @@ registerTool("list_projects", {
 }));
 registerTool("create_short", {
   title: "Create a short (draft)",
-  description: "Creates a short draft from a product prompt (min 10 chars). Returns the slug. Costs 0 credits. " + "Follow with generate_short to render. Prefer make_video for the one-shot path.",
+  description: "Creates a short draft from a product prompt (min 10 chars). A short is a 12s vertical (two 6s AI " + "segments + an on-screen title overlay + music; 14s when an end-card poster is set). Returns the slug, " + "costs 0 credits. Follow with generate_short to render. " + "BE PROACTIVE: don't ship a bare clip — set a headline (the on-screen TITLE) and subheadline (secondary " + "title), and pick a music_vibe and theme that fit the brand. To brand it further, attach a product image " + "(set_short_product) or an end-card poster (set_short_poster) before generate_short. (Shorts have no logo " + "overlay — that's an editor-only feature; use create_editor_ad for logo branding.)",
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("What the short should be about"),
     language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
-    theme: exports_external.string().optional(),
-    headline: exports_external.string().optional(),
-    subheadline: exports_external.string().optional(),
-    music_vibe: exports_external.string().optional()
+    headline: exports_external.string().max(160).optional().describe("The on-screen TITLE composited over the short (poster text overlay). ≤160 chars. Set this."),
+    subheadline: exports_external.string().max(200).optional().describe("The SECONDARY title / supporting line under the headline. ≤200 chars."),
+    theme: exports_external.string().optional().describe("Visual theme (default realistic). One of: none (no imposed style — follows the prompt literally), " + "realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, " + "gaming, retro_80s, minimalist, cyberpunk."),
+    music_vibe: exports_external.string().optional().describe("Background-music mood. Recognized: Upbeat (default), Cinematic, Minimal, Luxury, Playful, Jazz."),
+    music_instruments: exports_external.array(exports_external.string()).optional().describe('Optional instrument hints, e.g. ["piano", "strings"]'),
+    text_position: exports_external.enum(["top", "center", "bottom"]).optional().describe("Where the title overlay sits (default bottom)"),
+    text_animation: exports_external.enum(["reveal", "typewriter", "fade_in", "pop", "bounce"]).optional().describe("Title overlay animation (default fade_in)"),
+    font_family: exports_external.string().optional().describe("Overlay font (default ShortFontSpaceGrotesk). One of: ShortFontSpaceGrotesk, ShortFontMontserrat, " + "ShortFontTheBold, ShortFontImpact, ShortFontLato, ShortFontProximaNova, ShortFontAnton, " + "ShortFontBebasNeue, ShortFontOswald, ShortFontArchivoBlack, ShortFontPoppins, ShortFontInter, " + "ShortFontTikTokSans, ShortFontBangers.")
   },
   annotations: { title: "Create short", ...WRITE, idempotentHint: true }
 }, tool(async (args, client) => {
-  const res = await client.post("/shorts", args, idemKey("create-short", String(args.product_prompt ?? "")));
-  return ok({ slug: res.data.slug, kind: "short", next: "generate_short" });
+  const body = {
+    product_prompt: args.product_prompt
+  };
+  if (args.language !== undefined)
+    body.language = args.language;
+  if (args.headline !== undefined)
+    body.headline = args.headline;
+  if (args.subheadline !== undefined)
+    body.subheadline = args.subheadline;
+  if (args.theme !== undefined)
+    body.theme = args.theme;
+  if (args.music_vibe !== undefined)
+    body.music_vibe = args.music_vibe;
+  if (args.music_instruments !== undefined)
+    body.music_instruments = args.music_instruments;
+  if (args.text_position !== undefined)
+    body.short_text_position = args.text_position;
+  if (args.text_animation !== undefined)
+    body.short_text_animation = args.text_animation;
+  if (args.font_family !== undefined)
+    body.short_font_family = args.font_family;
+  const res = await client.post("/shorts", body, idemKey("create-short", args.product_prompt, args.language ?? "", args.headline ?? "", args.subheadline ?? ""));
+  return ok({
+    slug: res.data.slug,
+    kind: "short",
+    next: "set_short_product / set_short_poster (optional branding), then generate_short"
+  });
 }));
 registerTool("generate_short", {
   title: "Generate (render) a short",
@@ -30090,11 +30226,11 @@ registerTool("generate_short", {
 }));
 registerTool("create_editor_ad", {
   title: "Create a multi-scene editor ad (autopilot)",
-  description: "Creates an editor project from a product prompt and starts autopilot (server-orchestrated " + "scenario → segments → narration → voice → music → render). Each AI-generated scene is a fixed 8 seconds. " + "Returns the slug. Costs credits. Then poll with get_status / wait_for_completion (kind=editor). Prefer " + "make_video for the one-shot path.",
+  description: "Creates an editor project from a product prompt and starts autopilot (server-orchestrated " + "scenario → segments → narration → voice → music → render). Each AI-generated scene is a fixed 8 seconds. " + "Returns the slug. Costs credits. Then poll with get_status / wait_for_completion (kind=editor). Prefer " + "make_video for the one-shot path. " + "BRANDING: to attach the user's own product image, brand logo, or closing card, create the draft with " + "create_editor_draft first, call set_product / set_logo / set_closing_image (all 0 credits), then " + "start_autopilot — autopilot weaves them in. (Editor ads carry their copy in-scene/narration, not as a " + "title overlay; for an on-screen title/subtitle use a short with headline/subheadline instead.)",
   inputSchema: {
     product_prompt: exports_external.string().min(10).describe("Brief for the ad (min 10 chars)"),
     language: exports_external.string().optional().describe('Language code, e.g. "en" (default)'),
-    theme: exports_external.string().optional().describe('Visual theme (default "realistic")'),
+    theme: exports_external.string().optional().describe('Visual theme (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),
     voice_id: exports_external.string().optional().describe("Preferred narration voice id (see list_voices); omit for the default voice"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")')
   },
@@ -30149,7 +30285,7 @@ registerTool("create_editor_draft", {
   inputSchema: {
     product_prompt: exports_external.string().min(10).max(5000).optional().describe("Brief for the ad — 10–5000 chars, or omit entirely"),
     language: exports_external.string().min(2).max(10).optional().describe('Language code, e.g. "en" (default)'),
-    theme: exports_external.string().optional().describe('Visual theme (default "realistic")'),
+    theme: exports_external.string().optional().describe('Visual theme (default "realistic"). One of: none (no imposed style — segments follow your prompts literally), realistic, cinematic, anime, sci_fi, fantasy, noir, superhero, horror, mockumentary, sports, gaming, retro_80s, minimalist, cyberpunk.'),
     voice_id: exports_external.string().regex(/^[A-Za-z0-9_-]+$/).max(64).optional().describe("Preferred narration voice id (see list_voices); ≤64 chars, [A-Za-z0-9_-] only"),
     export_aspect_ratio: exports_external.enum(["9:16", "16:9", "1:1"]).optional().describe('Aspect ratio (default "9:16")'),
     project_intent: exports_external.enum(["social_ad", "creative_story"]).optional().describe("Project intent (optional)")
@@ -30532,7 +30668,7 @@ async function pollUploadToReady(client, slug, uploadId, extra, budgetMs, interv
   let { status, error: error2 } = await read();
   while (status !== "ready" && status !== "failed" && Date.now() + intervalMs <= deadline) {
     await reportProgress(extra, ++n, `upload ${uid}: ${status}`);
-    await sleep(intervalMs);
+    await sleep2(intervalMs);
     ({ status, error: error2 } = await read());
   }
   return {
@@ -30721,6 +30857,37 @@ registerTool("set_logo", {
   }
   return ok(result);
 }));
+registerTool("set_short_product", {
+  title: "Attach a product image to a short (0 credits)",
+  description: "Uploads a local product image and attaches it to a SHORT so the product is woven into the footage. " + "Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤20 MB), local path confined to HUBFLUENCER_INPUT_DIR (or cwd). 0 credits. Optional description " + "(≤500 chars) guides how it's featured. Attach BEFORE generate_short so the product is part of the scenes. " + "(This is the shorts equivalent of set_product for editor projects.)",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug (from create_short)"),
+    file_path: exports_external.string().describe("Local product image path (.jpg/.jpeg/.png)"),
+    description: exports_external.string().max(500).optional().describe("Product description (≤500 chars)")
+  },
+  annotations: {
+    title: "Set short product",
+    ...WRITE,
+    idempotentHint: false
+  }
+}, tool(async (args, client) => {
+  const { s3_key } = await uploadImageFile(client, `/shorts/${args.slug}/product/presign`, args.file_path);
+  const res = await client.post(`/shorts/${args.slug}/product/confirm`, { s3_key, product_description: args.description });
+  return ok(asRecord(res).data ?? res);
+}));
+registerTool("set_short_poster", {
+  title: "Set a short's end-card poster image (0 credits)",
+  description: "Uploads a local image as the SHORT's end-card poster — a closing still shown at the end (extends the " + "render from 12s to 14s). Accepted: " + IMAGE_EXTS.map((e) => `.${e}`).join(", ") + " (≤20 MB), confined to HUBFLUENCER_INPUT_DIR/cwd. 0 credits. There is one poster per short; calling " + "again replaces it. (Shorts have no logo overlay — for a brand logo use an editor project + set_logo.)",
+  inputSchema: {
+    slug: exports_external.string().describe("Short slug (from create_short)"),
+    file_path: exports_external.string().describe("Local poster image (.jpg/.jpeg/.png)")
+  },
+  annotations: { title: "Set short poster", ...WRITE, idempotentHint: false }
+}, tool(async (args, client) => {
+  const { s3_key } = await uploadShortPoster(client, args.slug, args.file_path);
+  const res = await client.post(`/shorts/${args.slug}/poster/confirm`, { s3_key });
+  return ok(asRecord(res).data ?? res);
+}));
 registerTool("get_status", {
   title: "Get generation status",
   description: "Returns a normalized status {stage, terminal, ready, video_url, error} for a short or editor " + "project. ready:true means the post-ready MP4 is at video_url.",
@@ -30780,6 +30947,10 @@ registerTool("download_result", {
   }, link);
 }));
 async function main() {
+  if (process.argv[2] === "login") {
+    await runLogin(process.argv[3]);
+    return;
+  }
   const transport = new StdioServerTransport;
   await server.connect(transport);
   console.error("hubfluencer-mcp running on stdio");

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@hubfluencer/mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   "license": "MIT",
   "author": "Monocursive <contact@monocursive.com>",
   "private": false,
   "type": "module",
   "bin": {
-    "hubfluencer-mcp": "./dist/index.js",
-    "hubfluencer-login": "./dist/login.js"
+    "hubfluencer-mcp": "./dist/index.js"
   },
   "main": "./dist/index.js",
   "files": [
@@ -20,7 +19,7 @@
   ],
   "scripts": {
     "dev": "bun run src/index.ts",
-    "build": "rm -rf dist && bun build src/index.ts src/login.ts --target node --outdir dist",
+    "build": "rm -rf dist && bun build src/index.ts --target node --outdir dist",
     "prepublishOnly": "bun run build",
     "start": "node dist/index.js",
     "test": "bun test",

package/src/client.ts

@@ -185,8 +185,8 @@ export class HubfluencerClient {
 
 /**
  * Builds a client from the environment, falling back to the device-link
- * credential file (written by `hubfluencer-login`). Throws a clear, actionable
- * error if no token is available.
+ * credential file (written by `hubfluencer-mcp login`). Throws a clear,
+ * actionable error if no token is available.
  */
 export function clientFromEnv(): HubfluencerClient {
 	const stored = readStoredCredentials();
@@ -198,7 +198,7 @@ export function clientFromEnv(): HubfluencerClient {
 
 	if (!token) {
 		throw new Error(
-			"Not connected to Hubfluencer. Run `hubfluencer-login` to connect, or set " +
+			"Not connected to Hubfluencer. Run `npx -y @hubfluencer/mcp login` to connect, or set " +
 				"HUBFLUENCER_API_TOKEN (create one in the app: Settings → Access tokens).",
 		);
 	}