@facelessad/mcp 1.0.0 → 1.1.0

package/README.md

@@ -32,6 +32,11 @@ same block under `openclaw mcp` config and verify with
 | Tool | What it does |
 |------|--------------|
 | `facelessad_list_tools` | Registry: tools, styles, structures, hooks, durations |
+
+Ask for a look of your own and the assistant sends `style: "custom"` plus
+`custom_style` — `facelessad_list_tools` marks which tools accept it
+(`supports.customStyle`). Product Showcase also takes `custom_graphics_style`
+for the text layer drawn over the product video.
 | `facelessad_create_video` | Create an ad; returns an id immediately |
 | `facelessad_get_video` | Status + download URL when done |
 | `facelessad_list_videos` | Your videos, newest first |
@@ -41,3 +46,12 @@ same block under `openclaw mcp` config and verify with
 
 Videos build in the background (3–10 min); the assistant polls
 `facelessad_get_video`. You are only charged for steps that succeed.
+
+## 1.0.1
+
+Seven tool-specific fields were reachable through the HTTP API but missing
+from this package's schema, and the MCP SDK strips unknown keys — so an
+assistant could not use them at all: `product_image_urls` (extra product
+angles) and, for Video Banner, `texts`, `text_mode`, `background_image_url`,
+`badge_image_url`, `badge` and `photo_query`. The schema now mirrors the
+hosted connector at `/mcp` field for field.

package/index.js

@@ -53,7 +53,7 @@ function result(data) {
   };
 }
 
-const server = new McpServer({ name: 'facelessad', version: '1.0.0' });
+const server = new McpServer({ name: 'facelessad', version: '1.1.0' });
 
 server.tool(
   'facelessad_list_tools',
@@ -69,6 +69,13 @@ server.tool(
   async () => result(await api('GET', '/api/v1/balance'))
 );
 
+server.tool(
+  'facelessad_list_brand_kits',
+  'The brands on this account: id, name, whether it is the default, how many of the 32 brand questions are answered, and whether it carries a colour and a logo. Call this before naming brand_kit_id — ids are per account and cannot be guessed.',
+  {},
+  async () => result(await api('GET', '/api/v1/brand-kits'))
+);
+
 server.tool(
   'facelessad_voices',
   'The curated voice-over pool (id, name, gender, accent, language). Only these ids are accepted as a specific voice.',
@@ -95,8 +102,16 @@ const createShape = {
   duration: z.number().int().optional().describe('Seconds; per-tool bounds from the registry (default 30)'),
   aspect_ratio: z.string().optional().describe('"9:16" | "1:1" | "4:5" | "16:9" (default per tool)'),
   language: z.string().optional().describe('Default "English (US)"'),
-  style: z.string().optional().describe('Style id for the tool (registry). Omit to let the server pick'),
-  style_hint: z.string().optional().describe('Free-form style wish when no exact style id fits'),
+  style: z.string().optional().describe('Style id for the tool (registry). Omit to let the server pick. Use "custom" together with custom_style to describe a look of your own — facelessad_list_tools marks which tools accept it (supports.customStyle)'),
+  // 1.1.0 (§673): custom_style on ainoa kentta joka oikeasti vaihtaa videon
+  // ilmeen. style_hint ei tehnyt sita: se lisasi vain rivin materiaaleihin,
+  // ja skriptin visualDirection-saanto kieltaa nimenomaan taidetyylin
+  // kuvaamisen. Palvelin kohtelee style_hintia nyt custom_stylena silloin kun
+  // style on antamatta, joten vanha kutsu alkaa vihdoin tehda mita se lupasi.
+  custom_style: z.string().max(2000).optional().describe('Free-text description of the look you want, max 2000 chars. Requires style:"custom". What to describe depends on the tool: animated-ad / character / music-video / inspiration / motivational / slideshow -> the illustration or cinematic image style; motion-graphics / saas-ui-ad / text-animation / video-banner -> typography, palette and motion for graphics built in code; product-showcase -> how the product is filmed (put the text-graphics look in custom_graphics_style)'),
+  custom_graphics_style: z.string().max(2000).optional().describe('product-showcase only: how the text graphics rendered in code OVER the product video should look (typography, colors, contrast against the video). Optional — left out, it is derived from custom_style.'),
+  custom_style_refine: z.boolean().optional().describe('Default true: your description is expanded into a full style specification before the video is built. Set false to use your text verbatim — do that when reusing the customStyle returned by a previous video so a campaign keeps one look.'),
+  style_hint: z.string().optional().describe('Legacy alias: when no style is given, this is treated exactly like custom_style. Prefer custom_style.'),
   ad_structure: z.string().optional().describe('Ad structure id for the tool (registry)'),
   hook_formula: z.string().optional().describe('Hook formula id (registry)'),
   video_mode: z.enum(['continuous', 'cuts']).optional(),
@@ -112,9 +127,24 @@ const createShape = {
   sfx: z.boolean().optional(),
   captions: z.boolean().optional(),
   use_brand_kit: z.boolean().optional().describe('Default true'),
+  brand_kit_id: z.number().int().optional().describe('§640: which brand to use. Omit for the account default. Ids come from facelessad_list_brand_kits.'),
   use_winners: z.boolean().optional().describe('Default true'),
   name: z.string().optional().describe('Display name in My Files'),
   product_image_url: z.string().optional().describe('REQUIRED for product-showcase: public https URL of the product photo'),
+  // 1.0.1 (§639): nämä API on hyväksynyt alusta asti, mutta ne puuttuivat
+  // tästä skeemasta — ja koska SDK riisuu tuntemattomat avaimet, avustin ei
+  // voinut käyttää niitä lainkaan. Peilaa McpController::toolList():ia 1:1.
+  product_image_urls: z.array(z.string()).optional().describe('product-showcase only: up to 8 extra angle photos of the same product (https URLs). Helps the product keep its shape and label across clips.'),
+  texts: z.object({
+    headline: z.string().optional().describe('Max 80 characters'),
+    subline: z.string().optional().describe('Max 120 characters'),
+    cta_text: z.string().optional().describe('Max 30 characters'),
+  }).optional().describe('video-banner only: your own copy. Anything you leave out is written for you from the materials.'),
+  text_mode: z.enum(['simple', 'full']).optional().describe('video-banner only. "full" = your texts are used as-is and no AI writes copy (requires texts.headline). "simple" = all three are written for you (send no texts). Omit to have only the missing ones filled in.'),
+  background_image_url: z.string().optional().describe('video-banner only: https URL to use instead of the automatic photo pick'),
+  badge_image_url: z.string().optional().describe('video-banner only: https URL of a badge image. Wins over badge.'),
+  badge: z.enum(['none', 'random_face']).optional().describe('video-banner only: "random_face" picks the same AI face the app offers. Ignored when badge_image_url is set.'),
+  photo_query: z.string().optional().describe('video-banner only: steer the automatic background photo search, e.g. "nordic office"'),
 };
 
 server.tool(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@facelessad/mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "FacelessAd as MCP tools — let your AI assistant create faceless video ads (Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw).",
   "license": "MIT",
   "type": "module",