@facelessad/mcp 1.0.0 → 1.0.1

package/README.md

@@ -41,3 +41,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.0.1' });
 
 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.',
@@ -112,9 +119,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.0.1",
   "description": "FacelessAd as MCP tools — let your AI assistant create faceless video ads (Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw).",
   "license": "MIT",
   "type": "module",