@contenthero/mcp 0.3.8 → 0.4.0

package/dist/server.js

@@ -37,7 +37,7 @@ import { z } from 'zod';
 import { GenerationTimeoutError, pendingOutputId, } from '@contenthero/sdk';
 import { getClient as defaultGetClient } from './client.js';
 import { resolveModelEnums, BOARD_TYPES, BOARD_TYPE_GUIDANCE, IMAGE_MODEL_GUIDANCE, VIDEO_MODEL_GUIDANCE, AUDIO_MODEL_GUIDANCE, EDIT_AUDIO_MODEL_GUIDANCE, UPSCALE_MODEL_GUIDANCE, LIP_SYNC_MODEL_GUIDANCE, } from './models.js';
-import { audioResult, avatarListResult, avatarResult, balanceResult, brandKitListResult, brandKitResult, brandKnowledgeListResult, brandKnowledgeDetailResult, brandKnowledgeSearchResult, brandKnowledgeItemResult, completedResult, connectedAccountListResult, connectedAccountResult, costResult, accountDetailResult, inspirationContentResult, mediaListResult, mediaSearchResult, folderListResult, folderContentsResult, mediaBatchResult, mediaUploadResult, uploadedMediaResult, tagListResult, tagResult, tagDeletedResult, modelListResult, modelResult, platformListResult, platformResult, elementListResult, elementResult, elementDeletedResult, errorResult, generationBatchResult, outlierListResult, enhanceClipsResult, pendingResult, pipelineStageListResult, postListResult, postResult, postSummaryResult, publishResult, statusActionResult, editorOpsResult, text, projectDetailResult, liveContextResult, projectListResult, projectCreatedResult, projectDeletedResult, layerTypesResult, timelineTypesResult, editorTranscriptResult, exportJobResult, exportFormatsResult, trackedAccountListResult, transcriptResult, voiceListResult, voiceResult, } from './format.js';
+import { audioResult, avatarListResult, avatarResult, balanceResult, brandKitListResult, brandKitResult, brandKnowledgeListResult, brandKnowledgeDetailResult, brandKnowledgeSearchResult, brandKnowledgeItemResult, completedResult, connectedAccountListResult, connectedAccountResult, costResult, accountDetailResult, inspirationContentResult, mediaListResult, mediaSearchResult, folderListResult, folderContentsResult, mediaBatchResult, mediaUploadResult, uploadedMediaResult, tagListResult, tagResult, tagDeletedResult, modelListResult, modelResult, platformListResult, platformResult, elementListResult, elementResult, elementDeletedResult, errorResult, generationBatchResult, outlierListResult, enhanceClipsResult, pendingResult, stageListResult, spaceDeletedResult, spaceListResult, spaceResult, cardListResult, cardResult, postSummaryResult, publishResult, statusActionResult, editorOpsResult, text, projectDetailResult, liveContextResult, projectListResult, projectCreatedResult, projectDeletedResult, layerTypesResult, timelineTypesResult, editorTranscriptResult, exportJobResult, exportFormatsResult, trackedAccountListResult, transcriptResult, voiceListResult, voiceResult, } from './format.js';
 /** Platforms a post or destination may target. */
 const POST_PLATFORMS = [
     'youtube',
@@ -207,6 +207,62 @@ function buildReferences(parts) {
  */
 export function registerTools(server, opts) {
     const { getClient, models } = opts;
+    /**
+     * ⚠️ THESE SHAPES ARE DECLARED, NOT LEFT AS `z.unknown()`. An array of unknown serialises to
+     * `{"type":"array","items":{}}`, which tells a client NOTHING about what may go inside it. The server
+     * accepted every shape when called directly, and Claude Desktop rejected all of them before they left,
+     * because a validator cannot check a value against an empty schema and a model cannot pattern an argument
+     * on one either. Measured 2026-08-23: 12 fields across 4 tools were advertised that way.
+     *
+     * Every entry below stays permissive at the EDGES (optional fields, free-form payload objects) because the
+     * server does the real validation. The point is to describe the shape, not to duplicate the rules.
+     */
+    const logoEntrySchema = z.object({
+        url: z.string().optional().describe('A url the kit already has.'),
+        outputId: z.string().optional().describe('A generation to copy in: "<id>", or "<id>-2" for variation 2.'),
+        name: z.string().optional(),
+        is_primary: z.boolean().optional().describe("Make this the kit's cover. Exactly one logo ends up primary."),
+        layout: z.enum(['horizontal', 'stacked', 'icon', 'wordmark']).optional(),
+        colorMode: z.enum(['full_color', 'light', 'dark', 'grayscale']).optional(),
+    });
+    const assetEntrySchema = z.object({
+        url: z.string().optional().describe('A url the kit already has.'),
+        outputId: z.string().optional().describe('A generation to copy in.'),
+        name: z.string().optional(),
+    });
+    const sectionEntrySchema = z.object({
+        tab: z.string().describe('The tab this section belongs to, e.g. "voice", "overview". Part of the key.'),
+        sectionName: z.string().describe('The section title. Part of the key.'),
+        sortOrder: z.number().int().optional(),
+        fields: z.array(z.record(z.string(), z.unknown())).optional().describe('Field objects: { key, label, type, value }.'),
+    });
+    /** An existing tracked-account id, OR a profile to add by handle/url. */
+    const accountEntrySchema = z.union([
+        z.string().describe('A tracked-account id, or a full profile url.'),
+        z.object({
+            platform: z
+                .enum(['youtube', 'instagram', 'facebook', 'tiktok', 'x', 'threads', 'linkedin'])
+                .optional()
+                .describe('Only needed for a bare handle; a full profile url carries its own platform.'),
+            handleOrUrl: z.string().describe('A profile url, or a handle when platform is given.'),
+        }),
+    ]);
+    const postDestinationSchema = z.object({
+        platform: z.enum(POST_PLATFORMS).describe('The platform. This is the KEY: one destination per platform.'),
+        format: z.string().optional(),
+        connectedAccountId: z.string().nullable().optional(),
+        scheduledAt: z.string().nullable().optional().describe("Per-destination override of the post's schedule."),
+        platformSpecificData: z.record(z.string(), z.unknown()).optional().describe('The publish payload for this platform.'),
+        status: z.string().optional(),
+    });
+    const postAssetSchema = z.object({
+        id: z.string().optional().describe('Keep an existing asset, at this position in the order.'),
+        assetUrl: z.string().optional().describe('A public url for a NEW asset.'),
+        outputId: z.string().optional().describe('A generation for a NEW asset.'),
+        assetType: z.string().optional().describe('Required with assetUrl; inferred from outputId.'),
+        displayName: z.string().optional(),
+        metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+    });
     // -- generate_image -------------------------------------------------------
     server.registerTool('generate_image', {
         title: 'Generate Image',
@@ -770,18 +826,18 @@ export function registerTools(server, opts) {
             visualStyle: z.string().optional(),
             designPrinciples: z.array(z.string()).optional(),
             contentStrategy: z.record(z.string(), z.unknown()).optional().describe('Content strategy object (free-form).'),
-            logos: z.array(z.unknown()).optional().describe("The kit's logos, each { url | outputId, name?, is_primary?, layout?, colorMode? }. Use outputId to bring in a generation."),
-            assets: z.array(z.unknown()).optional().describe("The kit's brand assets, each { url | outputId, name? }."),
+            logos: z.array(logoEntrySchema).optional().describe("The kit's logos, each { url | outputId, name?, is_primary?, layout?, colorMode? }. Use outputId to bring in a generation."),
+            assets: z.array(assetEntrySchema).optional().describe("The kit's brand assets, each { url | outputId, name? }."),
             sections: z
-                .array(z.unknown())
+                .array(sectionEntrySchema)
                 .optional()
                 .describe("The kit's curated sections, each { tab, sectionName, sortOrder?, fields? }. Array position is the default order."),
             brandAccounts: z
-                .array(z.unknown())
+                .array(accountEntrySchema)
                 .optional()
                 .describe("The account owner's OWN profiles. A tracked-account id, or { platform?, handleOrUrl } to ADD one and start ingesting it."),
             inspirationAccounts: z
-                .array(z.unknown())
+                .array(accountEntrySchema)
                 .optional()
                 .describe('Competitor/creator profiles they watch. Same entry shape as brandAccounts.'),
         },
@@ -825,19 +881,19 @@ export function registerTools(server, opts) {
                 .boolean()
                 .optional()
                 .describe('Re-run website extraction for this kit. Returns immediately; poll extractionStatus.'),
-            logos: z.array(z.unknown()).optional().describe('The kit\'s logos, each { url | outputId, name?, is_primary?, layout?: horizontal|stacked|icon|wordmark, colorMode?: full_color|light|dark|grayscale }. REPLACES the list; [] clears it. Exactly one ends up primary (the kit\'s cover); name none and the first wins.'),
-            assets: z.array(z.unknown()).optional().describe('The kit\'s brand assets, each { url | outputId, name? }. REPLACES the list; [] clears it.'),
+            logos: z.array(logoEntrySchema).optional().describe('The kit\'s logos, each { url | outputId, name?, is_primary?, layout?: horizontal|stacked|icon|wordmark, colorMode?: full_color|light|dark|grayscale }. REPLACES the list; [] clears it. Exactly one ends up primary (the kit\'s cover); name none and the first wins.'),
+            assets: z.array(assetEntrySchema).optional().describe('The kit\'s brand assets, each { url | outputId, name? }. REPLACES the list; [] clears it.'),
             sections: z
-                .array(z.unknown())
+                .array(sectionEntrySchema)
                 .optional()
                 .describe("The kit's curated sections, each { tab, sectionName, sortOrder?, fields? }. REPLACES the set, keyed by (tab, sectionName); a section left out is ARCHIVED, never deleted. Array position is the default order."),
             isDefault: z.literal(true).optional().describe('Make this the default kit, un-defaulting every other.'),
             brandAccounts: z
-                .array(z.unknown())
+                .array(accountEntrySchema)
                 .optional()
                 .describe("The account owner's OWN profiles. Each entry is a tracked-account id, or { platform?, handleOrUrl } to ADD one and start ingesting it. REPLACES the list; [] clears it."),
             inspirationAccounts: z
-                .array(z.unknown())
+                .array(accountEntrySchema)
                 .optional()
                 .describe('Competitor/creator profiles they watch. Same entry shape as brandAccounts. REPLACES the list; [] clears it.'),
             name: z.string().optional(),
@@ -1086,7 +1142,7 @@ export function registerTools(server, opts) {
     server.registerTool('list_folders', {
         title: 'List Folders',
         annotations: READ,
-        description: "List the account's library folders (their own manual and smart folders, as a flat list with parent links for nesting) together with the built-in derived folders (recents, favorites, edits, canvas, posts). Use this to see how the library is organized before browsing or filing items.",
+        description: "List the account's library folders (their own manual and smart folders, as a flat list with parent links for nesting) together with the built-in derived folders (recents, favorites, edits, canvas, cards). Use this to see how the library is organized before browsing or filing items.",
         inputSchema: {},
     }, async (_args, extra) => {
         try {
@@ -1101,7 +1157,7 @@ export function registerTools(server, opts) {
         annotations: READ,
         description: "Return the contents of one folder. The folder id is either one of the account's own folder ids or a built-in derived-folder key. A manual folder returns exactly the items filed in it; a smart folder computes its members live from its saved query; a derived folder returns its built-in set. Items are media (with kind and a description) and, in manual folders, entities such as projects or posts.",
         inputSchema: {
-            folder_id: z.string().describe('A folder id, or a derived-folder key (recents, favorites, edits, canvas, posts).'),
+            folder_id: z.string().describe('A folder id, or a derived-folder key (recents, favorites, edits, canvas, cards).'),
         },
     }, async (args, extra) => {
         try {
@@ -1207,12 +1263,12 @@ export function registerTools(server, opts) {
     server.registerTool('get_media', {
         title: 'Get Media',
         annotations: READ,
-        description: 'SEE specific media. Pass a batch of items (up to 10) to view them at once: each item is either a { url } (e.g. a URL threaded from get_context, a layer/asset URL from get_project / get_post, or an upload URL from list_media source=uploads) or an { mediaId, variation? } (a studio output id, full or first-8; omit variation to get the primary one). Returns light metadata per item plus an IMAGE block for each image so you can actually see it. For a VIDEO, set frames (and optionally fromSec/toSec) on the item to get low-res KEYFRAMES across that source-time window, so you can watch the raw footage (judge B-roll relevance, take quality) without editing it; audio still returns metadata + the url. An mediaId without a variation returns ONLY the primary variation and lists the others; request a specific variation to see it. Use this to inspect the actual pixels, not just URLs.',
+        description: 'SEE specific media. Pass a batch of items (up to 10) to view them at once: each item is either a { url } (e.g. a URL threaded from get_context, a layer/asset URL from get_project / get_card, or an upload URL from list_media source=uploads) or an { mediaId, variation? } (a studio output id, full or first-8; omit variation to get the primary one). Returns light metadata per item plus an IMAGE block for each image so you can actually see it. For a VIDEO, set frames (and optionally fromSec/toSec) on the item to get low-res KEYFRAMES across that source-time window, so you can watch the raw footage (judge B-roll relevance, take quality) without editing it; audio still returns metadata + the url. An mediaId without a variation returns ONLY the primary variation and lists the others; request a specific variation to see it. Use this to inspect the actual pixels, not just URLs.',
         inputSchema: {
             items: z
                 .array(z.union([
                 z.object({
-                    url: z.string().describe('A media URL on our storage (from get_context / get_project / get_post).'),
+                    url: z.string().describe('A media URL on our storage (from get_context / get_project / get_card).'),
                     fromSec: z.number().min(0).optional().describe('Video keyframes: start of the source-time window (seconds). Omit for the whole clip.'),
                     toSec: z.number().min(0).optional().describe('Video keyframes: end of the source-time window (seconds).'),
                     frames: z.number().int().min(1).optional().describe('Video keyframes: how many to return across the window. Set this (or fromSec/toSec) to watch the raw footage.'),
@@ -1525,11 +1581,11 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- list_posts -----------------------------------------------------------
-    server.registerTool('list_posts', {
+    // -- list_cards -----------------------------------------------------------
+    server.registerTool('list_cards', {
         title: 'List Posts',
         annotations: READ,
-        description: "List the account's content-pipeline posts (newest-updated first). Filter by status, platform, pipeline_stage (id/slug/name), folder, favorite, or a title search. Call get_post for one post's full detail (destinations + assets).",
+        description: "List the account's content-pipeline posts (newest-updated first). Filter by status, platform, pipeline_stage (id/slug/name), folder, favorite, or a title search. Call get_card for one post's full detail (destinations + assets).",
         inputSchema: {
             status: z.enum(['draft', 'active', 'completed', 'archived']).optional().describe('Filter by lifecycle status.'),
             platform: z.enum(POST_PLATFORMS).optional().describe('Filter by the post platform.'),
@@ -1541,7 +1597,7 @@ export function registerTools(server, opts) {
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return postListResult(await client.listPosts({
+            return cardListResult(await client.listCards({
                 status: args.status,
                 platform: args.platform,
                 pipelineStage: args.pipelineStage,
@@ -1554,46 +1610,147 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- get_post -------------------------------------------------------------
-    server.registerTool('get_post', {
+    // -- get_card -------------------------------------------------------------
+    server.registerTool('get_card', {
         title: 'Get Post',
         annotations: READ,
         description: "Get one post in full: its fields (title, description, script, notes, status, stage, schedule), plus its publish destinations and attached assets.",
         inputSchema: {
-            postId: z.string().describe('The post id from list_posts.'),
+            postId: z.string().describe('The post id from list_cards.'),
+        },
+    }, async (args, extra) => {
+        try {
+            const client = await getClient(extra);
+            return cardResult(await client.getCard(args.postId));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_spaces ----------------------------------------------------------
+    server.registerTool('list_spaces', {
+        title: 'List Spaces',
+        annotations: READ,
+        description: "List the account's SPACES. A space is the planner's top-level container: Space > Stage > Card > Post. Each space has its own stages, so two spaces can both hold a stage called 'Published'. Call this FIRST to discover which board to work in, then pass a space id to list_stages, list_cards or create_card. Archived spaces are excluded unless includeArchived is set.",
+        inputSchema: {
+            includeArchived: z
+                .boolean()
+                .optional()
+                .describe('Include archived spaces. Default false, matching the grid in the app.'),
+        },
+    }, async (args, extra) => {
+        try {
+            const client = await getClient(extra);
+            return spaceListResult(await client.listSpaces({ includeArchived: args.includeArchived }));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_space ------------------------------------------------------------
+    server.registerTool('get_space', {
+        title: 'Get Space',
+        annotations: READ,
+        description: 'Return one space with its live card count. Use list_spaces to discover ids. The count excludes archived cards, and is the same number list_spaces reports for that space.',
+        inputSchema: { spaceId: z.string().describe('The space id.') },
+    }, async (args, extra) => {
+        try {
+            const client = await getClient(extra);
+            return spaceResult(await client.getSpace(args.spaceId));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- create_space ---------------------------------------------------------
+    server.registerTool('create_space', {
+        title: 'Create Space',
+        annotations: WRITE,
+        description: "Create a space: a new planner board with its own stages. duplicateFrom copies another space's STAGES, never its cards, so the new board arrives with the columns and none of the work. Requires the pipeline:write scope.",
+        inputSchema: {
+            name: z.string().describe('The space name.'),
+            coverUrl: z.string().optional().describe('A cover image URL for the space tile.'),
+            duplicateFrom: z
+                .string()
+                .optional()
+                .describe("Copy this space's stages into the new one. Cards are never copied."),
+        },
+    }, async (args, extra) => {
+        try {
+            const client = await getClient(extra);
+            return spaceResult(await client.createSpace({
+                name: args.name,
+                coverUrl: args.coverUrl,
+                duplicateFrom: args.duplicateFrom,
+            }));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- update_space ---------------------------------------------------------
+    server.registerTool('update_space', {
+        title: 'Update Space',
+        annotations: WRITE,
+        description: "Rename a space or change its cover. This is a PATCH: a field you omit is left alone, so renaming does not disturb the cover. Pass coverUrl as an empty string to REMOVE the cover. To favorite or archive a space, use the `favorite` and `archive` tools with assetType 'space' instead. Requires the pipeline:write scope.",
+        inputSchema: {
+            spaceId: z.string().describe('The space id to update.'),
+            name: z.string().optional().describe('A new name.'),
+            coverUrl: z
+                .string()
+                .optional()
+                .describe('A new cover image URL. Pass an empty string to remove the cover entirely.'),
         },
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return postResult(await client.getPost(args.postId));
+            // An empty string is how a tool caller says "remove it": JSON Schema has no way to
+            // distinguish an omitted string from an explicit null in a plain string field.
+            const coverUrl = args.coverUrl === undefined ? undefined : args.coverUrl === '' ? null : args.coverUrl;
+            return spaceResult(await client.updateSpace(args.spaceId, { name: args.name, coverUrl }));
         }
         catch (err) {
             return errorResult(err);
         }
     });
-    // -- list_pipeline_stages -------------------------------------------------
-    server.registerTool('list_pipeline_stages', {
+    // -- delete_space ---------------------------------------------------------
+    server.registerTool('delete_space', {
+        title: 'Delete Space',
+        annotations: WRITE,
+        description: 'Delete a space. The server REFUSES a space that still holds cards and names the count, because the delete cascades to every card in it along with their covers, captions, destinations and schedules. Archive the space instead if you want it out of the way. Requires the pipeline:write scope.',
+        inputSchema: { spaceId: z.string().describe('The space id to delete.') },
+    }, async (args, extra) => {
+        try {
+            const client = await getClient(extra);
+            await client.deleteSpace(args.spaceId);
+            return spaceDeletedResult(args.spaceId);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_stages -------------------------------------------------
+    server.registerTool('list_stages', {
         title: 'List Pipeline Stages',
         annotations: READ,
-        description: "List the account's pipeline stages, in order. Stages are user-customizable (renamed, reordered, added, removed), so call this to discover the real stages before placing a post; pass a stage's id (most stable), slug, or name to create_post / update_post.",
+        description: "List the account's pipeline stages, in order. Stages are user-customizable (renamed, reordered, added, removed), so call this to discover the real stages before placing a post; pass a stage's id (most stable), slug, or name to create_card / update_card.",
     }, async (extra) => {
         try {
             const client = await getClient(extra);
-            return pipelineStageListResult(await client.listPipelineStages());
+            return stageListResult(await client.listStages());
         }
         catch (err) {
             return errorResult(err);
         }
     });
-    // -- create_post ----------------------------------------------------------
-    server.registerTool('create_post', {
+    // -- create_card ----------------------------------------------------------
+    server.registerTool('create_card', {
         title: 'Create Post',
         annotations: WRITE,
-        description: "Create a content-pipeline post. The post is the container; attach platforms with add_post_destination and media with add_post_asset, then schedule_post or publish_post. `stage` accepts a stage id/slug/name (defaults to the first stage). Requires a key with the pipeline:write scope.",
+        description: "Create a content-pipeline post. The post is the container; attach platforms with add_post_destination and media with add_post_asset, then schedule_post or publish_card. `stage` accepts a stage id/slug/name (defaults to the first stage). Requires a key with the pipeline:write scope.",
         inputSchema: {
             title: z.string().describe('Post title (required).'),
             platform: z.enum(POST_PLATFORMS).describe('Primary platform for the post.'),
-            description: z.string().optional().describe('Optional description / caption draft.'),
             stage: z.string().optional().describe('Pipeline stage id, slug, or name. Defaults to the first stage.'),
             coverUrl: z.string().optional().describe('Public URL for the post cover (the card thumbnail).'),
             coverOutputId: z
@@ -1608,10 +1765,9 @@ export function registerTools(server, opts) {
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return postSummaryResult(await client.createPost({
+            return postSummaryResult(await client.createCard({
                 title: args.title,
                 platform: args.platform,
-                description: args.description,
                 stage: args.stage,
                 coverUrl: args.coverUrl,
                 coverOutputId: args.coverOutputId,
@@ -1622,15 +1778,14 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- update_post ----------------------------------------------------------
-    server.registerTool('update_post', {
+    // -- update_card ----------------------------------------------------------
+    server.registerTool('update_card', {
         title: 'Update Post',
         annotations: WRITE,
-        description: "Update a post: its fields (title, description, script, notes, status, platform, cover, pipeline stage), its DESTINATIONS (which platforms it publishes to), its ASSETS (the media on it, in order), and its SCHEDULE. destinations and assets are DECLARATIVE: pass the WHOLE set, because anything you leave out is removed. Destinations key on platform. Assets key on id, and THE ARRAY ORDER IS THE carousel ORDER, so reordering is just sending the same ids in a different order; keep an existing asset by id, add a new one by assetUrl or outputId. scheduledAt sets the time on the post AND every destination (pass null to clear); give a destination its own scheduledAt to override it for that platform. To publish NOW, use publish_post. Requires the pipeline:write scope.",
+        description: "Update a post: its fields (title, description, script, notes, status, platform, cover, pipeline stage), its DESTINATIONS (which platforms it publishes to), its ASSETS (the media on it, in order), and its SCHEDULE. destinations and assets are DECLARATIVE: pass the WHOLE set, because anything you leave out is removed. Destinations key on platform. Assets key on id, and THE ARRAY ORDER IS THE carousel ORDER, so reordering is just sending the same ids in a different order; keep an existing asset by id, add a new one by assetUrl or outputId. scheduledAt sets the time on the post AND every destination (pass null to clear); give a destination its own scheduledAt to override it for that platform. To publish NOW, use publish_card. Requires the pipeline:write scope.",
         inputSchema: {
             postId: z.string().describe('The post id.'),
             title: z.string().optional(),
-            description: z.string().optional(),
             platform: z.enum(POST_PLATFORMS).optional(),
             status: z.enum(['draft', 'active', 'completed', 'archived']).optional(),
             stage: z.string().optional().describe('Move the post to this stage (id, slug, or name).'),
@@ -1651,11 +1806,11 @@ export function registerTools(server, opts) {
                 .optional()
                 .describe('ISO time to publish. Sets the post AND every destination. null clears the schedule.'),
             destinations: z
-                .array(z.unknown())
+                .array(postDestinationSchema)
                 .optional()
                 .describe("The post's destinations, each { platform, format?, connectedAccountId?, platformSpecificData?, scheduledAt?, status? }. REPLACES the set, keyed by platform; [] detaches all."),
             assets: z
-                .array(z.unknown())
+                .array(postAssetSchema)
                 .optional()
                 .describe("The post's assets IN ORDER, each { id } to keep an existing one or { assetUrl | outputId, assetType?, displayName? } to add. REPLACES the list; [] clears it."),
         },
@@ -1665,7 +1820,7 @@ export function registerTools(server, opts) {
             const { postId, destinations, assets, ...input } = args;
             // The two declarative arrays are `unknown[]` in the schema (their entries are free-form objects the
             // server validates), so they are cast at this one boundary rather than duplicating the shape in zod.
-            return postSummaryResult(await client.updatePost(postId, {
+            return postSummaryResult(await client.updateCard(postId, {
                 ...input,
                 ...(destinations !== undefined ? { destinations: destinations } : {}),
                 ...(assets !== undefined ? { assets: assets } : {}),
@@ -1679,7 +1834,7 @@ export function registerTools(server, opts) {
     server.registerTool('list_tags', {
         title: 'List Tags',
         annotations: READ,
-        description: "List the account's tags (the organizational tag library). Set a post's tags with the `tags` field on create_post / update_post. A tag is just a lowercase name.",
+        description: "List the account's tags (the organizational tag library). Set a post's tags with the `tags` field on create_card / update_card. A tag is just a lowercase name.",
         inputSchema: {},
     }, async (extra) => {
         try {
@@ -1694,7 +1849,7 @@ export function registerTools(server, opts) {
     server.registerTool('create_tag', {
         title: 'Create Tag',
         annotations: WRITE,
-        description: "Create a tag in the account's tag library (the name is lowercased). Tags organize posts; apply them with the `tags` field on create_post / update_post. Requires the pipeline:write scope.",
+        description: "Create a tag in the account's tag library (the name is lowercased). Tags organize posts; apply them with the `tags` field on create_card / update_card. Requires the pipeline:write scope.",
         inputSchema: {
             name: z.string().describe('The tag name (lowercased on save).'),
         },
@@ -1711,7 +1866,7 @@ export function registerTools(server, opts) {
     server.registerTool('update_tag', {
         title: 'Update Tag',
         annotations: WRITE,
-        description: 'Rename a tag (preserves its assignments on all posts). To detach a tag from one post, set that post\'s `tags` without it via update_post. Requires the pipeline:write scope.',
+        description: 'Rename a tag (preserves its assignments on all posts). To detach a tag from one post, set that post\'s `tags` without it via update_card. Requires the pipeline:write scope.',
         inputSchema: {
             tagId: z.string().describe('The tag id (from list_tags).'),
             name: z.string().describe('The new tag name (lowercased on save).'),
@@ -1729,7 +1884,7 @@ export function registerTools(server, opts) {
     server.registerTool('delete_tag', {
         title: 'Delete Tag',
         annotations: WRITE,
-        description: "Delete a tag from the account's library. This DESTROYS the tag and removes it from every post it was on. To just detach a tag from one post, set that post's `tags` without it via update_post instead. Requires the pipeline:write scope.",
+        description: "Delete a tag from the account's library. This DESTROYS the tag and removes it from every post it was on. To just detach a tag from one post, set that post's `tags` without it via update_card instead. Requires the pipeline:write scope.",
         inputSchema: {
             tagId: z.string().describe('The tag id (from list_tags).'),
         },
@@ -1742,8 +1897,8 @@ export function registerTools(server, opts) {
             return errorResult(err);
         }
     });
-    // -- publish_post ---------------------------------------------------------
-    server.registerTool('publish_post', {
+    // -- publish_card ---------------------------------------------------------
+    server.registerTool('publish_card', {
         title: 'Publish Post',
         annotations: PUBLISH,
         description: "Publish a post NOW to its destinations (a single platform when `platform` is given, otherwise all). Each destination must have a connected account. Requires a key with the publish:write scope; holding that scope is the account owner's consent to autonomous publishing. Returns per-destination results.",
@@ -1754,7 +1909,7 @@ export function registerTools(server, opts) {
     }, async (args, extra) => {
         try {
             const client = await getClient(extra);
-            return publishResult(await client.publishPost(args.postId, { platform: args.platform }));
+            return publishResult(await client.publishCard(args.postId, { platform: args.platform }));
         }
         catch (err) {
             return errorResult(err);
@@ -1876,7 +2031,7 @@ export function registerTools(server, opts) {
     server.registerTool('list_connected_accounts', {
         title: 'List Connected Accounts',
         annotations: READ,
-        description: "List the social accounts the owner has connected (the publish targets), default first. Use an account's id as connectedAccountId on add_post_destination, then publish_post. Read-only: connecting an account is done in the ContentHero app.",
+        description: "List the social accounts the owner has connected (the publish targets), default first. Use an account's id as connectedAccountId on add_post_destination, then publish_card. Read-only: connecting an account is done in the ContentHero app.",
     }, async (extra) => {
         try {
             const client = await getClient(extra);
@@ -1924,10 +2079,10 @@ export function registerTools(server, opts) {
     server.registerTool('favorite', {
         title: 'Favorite',
         annotations: WRITE,
-        description: "Favorite or UNfavorite an asset: pass favorited:false to clear it (default true). For a top-level asset, pass assetType + id (post, voice, brand_kit, project, inspiration_content, gallery, transition). To favorite a single studio media variation (one image/video/audio slot from list_media / get_media), pass the output id + variationIndex (1-based) and omit assetType. Requires the favorites:write scope. Idempotent in both directions.",
+        description: "Favorite or UNfavorite an asset: pass favorited:false to clear it (default true). For a top-level asset, pass assetType + id (card, voice, brand_kit, project, inspiration_content, gallery, transition, space). To favorite a single studio media variation (one image/video/audio slot from list_media / get_media), pass the output id + variationIndex (1-based) and omit assetType. Requires the favorites:write scope. Idempotent in both directions.",
         inputSchema: {
             assetType: z
-                .enum(['post', 'voice', 'brand_kit', 'project', 'inspiration_content', 'gallery', 'transition'])
+                .enum(['card', 'voice', 'brand_kit', 'project', 'inspiration_content', 'gallery', 'transition', 'space'])
                 .optional()
                 .describe('The kind of asset. Required unless targeting a media variation via variationIndex.'),
             id: z.string().describe('The asset id (or studio output id when using variationIndex).'),
@@ -1955,10 +2110,10 @@ export function registerTools(server, opts) {
     server.registerTool('archive', {
         title: 'Archive',
         annotations: WRITE,
-        description: "Archive or UNarchive an asset: pass archived:false to restore it (default true). ContentHero never hard-deletes, so this is always reversible. For a top-level asset, pass assetType + id (post, brand_kit, brand_kit_section, project). To archive a single studio media variation, pass the output id + variationIndex (1-based) and omit assetType. Archiving a post sets its status to 'archived'; restoring returns it to 'draft'. Requires the favorites:write scope. Idempotent in both directions.",
+        description: "Archive or UNarchive an asset: pass archived:false to restore it (default true). ContentHero never hard-deletes, so this is always reversible. For a top-level asset, pass assetType + id (card, brand_kit, brand_kit_section, project, space). To archive a single studio media variation, pass the output id + variationIndex (1-based) and omit assetType. Archiving a card sets its status to 'archived'; restoring returns it to 'draft'. Requires the favorites:write scope. Idempotent in both directions.",
         inputSchema: {
             assetType: z
-                .enum(['post', 'brand_kit', 'brand_kit_section', 'project'])
+                .enum(['card', 'brand_kit', 'brand_kit_section', 'project', 'space'])
                 .optional()
                 .describe('The kind of asset. Required unless targeting a media variation via variationIndex.'),
             id: z.string().describe('The asset id (or studio output id when using variationIndex).'),