@contenthero/mcp 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @contenthero/mcp
+
+Official [ContentHero](https://contenthero.ai) MCP server. Generate images, video, and audio from any MCP client (Claude Code, Claude Desktop, ...) using your ContentHero API key.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `generate_image` | Generate images from a prompt (or image-to-image). Waits for the result and returns the URLs. |
+| `generate_video` | Generate video from a prompt (or start/end frame, references). Waits up to ~75s, then returns an `outputId` to poll if the render is still running. |
+| `generate_audio` | ElevenLabs speech (TTS), music, or sound effects. Synchronous: returns the audio URL directly. |
+| `check_generation` | Poll an image/video `outputId` to its final URLs. |
+| `get_balance` | Current credit balance, tier, and auto-top-up state. |
+
+Three intent-shaped generate tools (not one `generate_media`): image and video share the async smart-wait lifecycle, audio shares almost nothing and runs synchronously, and per-tool `modelId` enums keep each schema clean.
+
+## Setup
+
+Requires Node 20+. You need a ContentHero API key (`ch_live_...`).
+
+### Claude Code
+
+```bash
+claude mcp add contenthero --env CONTENTHERO_API_KEY=ch_live_xxx -- npx -y @contenthero/mcp
+```
+
+### Claude Desktop / generic MCP config
+
+```json
+{
+  "mcpServers": {
+    "contenthero": {
+      "command": "npx",
+      "args": ["-y", "@contenthero/mcp"],
+      "env": { "CONTENTHERO_API_KEY": "ch_live_xxx" }
+    }
+  }
+}
+```
+
+### Environment
+
+| Variable | Required | Default |
+| --- | --- | --- |
+| `CONTENTHERO_API_KEY` | yes | - |
+| `CONTENTHERO_BASE_URL` | no | `https://app.contenthero.ai` |
+
+## Usage
+
+Once connected, just ask in natural language. The agent picks the tool and model:
+
+> "Generate a 16:9 image of a golden retriever astronaut with nano-banana-2."
+
+> "Make an 8 second video of a city at dusk with audio using veo-3.1-fast."
+
+> "Read this script aloud with ElevenLabs voice `<id>`."
+
+Images return in one turn (~15s). Video either returns inline or hands back an `outputId`; the agent then calls `check_generation` to fetch the final URLs. Insufficient credits, invalid parameters, and unknown models come back as readable tool errors.
+
+## How it works
+
+This server is a thin wrapper over [`@contenthero/sdk`](https://www.npmjs.com/package/@contenthero/sdk), which talks to the ContentHero `/api/v1` surface. Your API key resolves your account server-side; the server never sends a user id. Pricing is computed server-side.

package/dist/client.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Lazy ContentHero SDK client, configured from the environment.
+ *
+ * Reads CONTENTHERO_API_KEY (required) and CONTENTHERO_BASE_URL (optional) from
+ * the MCP server's env config. Resolution is deferred to first use so the
+ * server can start and advertise its tools even before a key is present; the
+ * missing-key error then surfaces as a tool-call result rather than a crash.
+ */
+import { ContentHero } from '@contenthero/sdk';
+export declare function getClient(): ContentHero;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C,wBAAgB,SAAS,IAAI,WAAW,CAUvC"}

package/dist/client.js

@@ -0,0 +1,21 @@
+/**
+ * Lazy ContentHero SDK client, configured from the environment.
+ *
+ * Reads CONTENTHERO_API_KEY (required) and CONTENTHERO_BASE_URL (optional) from
+ * the MCP server's env config. Resolution is deferred to first use so the
+ * server can start and advertise its tools even before a key is present; the
+ * missing-key error then surfaces as a tool-call result rather than a crash.
+ */
+import { ContentHero } from '@contenthero/sdk';
+let cached;
+export function getClient() {
+    if (cached)
+        return cached;
+    const apiKey = process.env.CONTENTHERO_API_KEY;
+    if (!apiKey) {
+        throw new Error('CONTENTHERO_API_KEY is not set. Add it to the env of your ContentHero MCP server config.');
+    }
+    cached = new ContentHero({ apiKey, baseUrl: process.env.CONTENTHERO_BASE_URL });
+    return cached;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,IAAI,MAA+B,CAAA;AAEnC,MAAM,UAAU,SAAS;IACvB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IACzB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAA;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAA;IACH,CAAC;IACD,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAC/E,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/format.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Helpers that turn SDK results and errors into MCP CallToolResult content.
+ * Tool errors are returned as `isError` results (not thrown) so the agent sees
+ * a readable message instead of a transport failure.
+ */
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { Avatar, AvatarSummary, Balance, BrandKit, BrandKitSummary, Generation, GenerateResult, MediaItem, MediaSummary, Transcription, Voice, VoiceSummary } from '@contenthero/sdk';
+/** A finished image/video generation: list the asset URLs. */
+export declare function completedResult(gen: Generation): CallToolResult;
+/** A slow job that did not finish within the smart-wait window. */
+export declare function pendingResult(outputId: string): CallToolResult;
+/** Synchronous audio result (already complete on submit). */
+export declare function audioResult(result: GenerateResult): CallToolResult;
+/** Result of polling a generation via check_generation. */
+export declare function generationStatusResult(gen: Generation): CallToolResult;
+/** A finished transcription: header line plus the transcript body. */
+export declare function transcriptResult(t: Transcription): CallToolResult;
+/** List of avatars, each with the fields an agent needs to drive lip-sync. */
+export declare function avatarListResult(avatars: AvatarSummary[]): CallToolResult;
+/** One avatar's full detail, including its looks. */
+export declare function avatarResult(a: Avatar): CallToolResult;
+/** List of saved voices. */
+export declare function voiceListResult(voices: VoiceSummary[]): CallToolResult;
+/** One voice's full detail. */
+export declare function voiceResult(v: Voice): CallToolResult;
+/** List of brand kits. */
+export declare function brandKitListResult(kits: BrandKitSummary[]): CallToolResult;
+/**
+ * One brand kit in full. The kit is deeply structured (visual identity, voice,
+ * curated sections, linked accounts, knowledge), so return a short header plus
+ * the whole object as JSON: faithful and complete, and an agent reads it cleanly.
+ */
+export declare function brandKitResult(kit: BrandKit): CallToolResult;
+/** List of studio outputs (media). */
+export declare function mediaListResult(items: MediaSummary[]): CallToolResult;
+/** One studio output's detail, with its variations. */
+export declare function mediaResult(m: MediaItem): CallToolResult;
+export declare function balanceResult(b: Balance): CallToolResult;
+/** Map any thrown error onto a readable isError result. */
+export declare function errorResult(err: unknown): CallToolResult;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,OAAO,EACP,QAAQ,EACR,eAAe,EACf,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,aAAa,EACb,KAAK,EACL,YAAY,EACb,MAAM,kBAAkB,CAAA;AAOzB,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAK/D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAI9D;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAIlE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,UAAU,GAAG,cAAc,CAMtE;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,cAAc,CAIjE;AAOD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,cAAc,CASzE;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,CAiBtD;AAED,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,cAAc,CAOtE;AAED,+BAA+B;AAC/B,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,cAAc,CAYpD;AAED,0BAA0B;AAC1B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,cAAc,CAO1E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,cAAc,CAG5D;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,cAAc,CAQrE;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,cAAc,CAqBxD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,cAAc,CAIxD;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAgBxD"}

package/dist/format.js

@@ -0,0 +1,156 @@
+/**
+ * Helpers that turn SDK results and errors into MCP CallToolResult content.
+ * Tool errors are returned as `isError` results (not thrown) so the agent sees
+ * a readable message instead of a transport failure.
+ */
+import { ContentHeroError, InsufficientCreditsError, RateLimitError } from '@contenthero/sdk';
+function text(body, isError = false) {
+    return { content: [{ type: 'text', text: body }], isError };
+}
+/** A finished image/video generation: list the asset URLs. */
+export function completedResult(gen) {
+    const urls = gen.outputUrls ?? [];
+    const noun = urls.length === 1 ? gen.contentType : `${gen.contentType}s`;
+    const header = `Done. ${urls.length} ${noun} from ${gen.modelId} (outputId ${gen.outputId}):`;
+    return text([header, ...urls.map((u, i) => `${i + 1}. ${u}`)].join('\n'));
+}
+/** A slow job that did not finish within the smart-wait window. */
+export function pendingResult(outputId) {
+    return text(`Still rendering (outputId ${outputId}). This is normal for video. Call check_generation with this outputId in ~30-60s to get the final URLs.`);
+}
+/** Synchronous audio result (already complete on submit). */
+export function audioResult(result) {
+    const urls = result.outputUrls ?? [];
+    const header = `Done. Audio generated (outputId ${result.outputId}):`;
+    return text([header, ...urls.map((u, i) => `${i + 1}. ${u}`)].join('\n'));
+}
+/** Result of polling a generation via check_generation. */
+export function generationStatusResult(gen) {
+    if (gen.status === 'completed')
+        return completedResult(gen);
+    if (gen.status === 'failed') {
+        return text(`Generation ${gen.outputId} failed: ${gen.error ?? 'unknown error'}`, true);
+    }
+    return text(`Generation ${gen.outputId} is still ${gen.status}. Check again in a moment.`);
+}
+/** A finished transcription: header line plus the transcript body. */
+export function transcriptResult(t) {
+    const lang = t.language ? ` (${t.language})` : '';
+    const header = `Transcript${lang}, ${t.wordCount} words (outputId ${t.outputId}):`;
+    return text([header, '', t.transcript].join('\n'));
+}
+/** Join the non-empty lines (drops null/empty entries). */
+function lines(parts) {
+    return parts.filter((p) => !!p).join('\n');
+}
+/** List of avatars, each with the fields an agent needs to drive lip-sync. */
+export function avatarListResult(avatars) {
+    if (!avatars.length) {
+        return text('No avatars found. Create one in the ContentHero app first.');
+    }
+    const rows = avatars.map((a) => `- ${a.name} (id ${a.id})${a.isDefault ? ' [default]' : ''} | image: ${a.imageUrl ?? 'none'} | voice: ${a.defaultVoiceId ?? 'none'}`);
+    return text([`${avatars.length} avatar(s):`, ...rows].join('\n'));
+}
+/** One avatar's full detail, including its looks. */
+export function avatarResult(a) {
+    const traits = [a.gender, a.age, a.ethnicity].filter(Boolean).join(', ');
+    return text(lines([
+        `${a.name} (id ${a.id})${a.isDefault ? ' [default]' : ''}`,
+        `image (base look, use as imageUrl for generate_lip_sync): ${a.imageUrl ?? 'none'}`,
+        `default voice (use as voiceId): ${a.defaultVoiceId ?? 'none'}`,
+        a.description ? `description: ${a.description}` : null,
+        traits ? `traits: ${traits}` : null,
+        a.niche.length ? `niche: ${a.niche.join(', ')}` : null,
+        a.looks.length ? `looks (${a.looks.length}):` : 'looks: none',
+        ...a.looks.map((l) => `  - ${l.name ?? l.lookType ?? 'look'} (id ${l.id})${l.isDefault ? ' [default]' : ''}: ${l.imageUrl ?? 'none'}`),
+    ]));
+}
+/** List of saved voices. */
+export function voiceListResult(voices) {
+    if (!voices.length)
+        return text('No saved voices found.');
+    const rows = voices.map((v) => `- ${v.name ?? '(unnamed)'} (voiceId ${v.voiceId})${v.isFavorited ? ' [favorite]' : ''}${v.previewUrl ? ` | preview: ${v.previewUrl}` : ''}`);
+    return text([`${voices.length} voice(s):`, ...rows].join('\n'));
+}
+/** One voice's full detail. */
+export function voiceResult(v) {
+    const traits = [v.gender, v.age, v.accent, v.language].filter(Boolean).join(', ');
+    return text(lines([
+        `${v.name ?? '(unnamed)'} (voiceId ${v.voiceId})${v.isFavorited ? ' [favorite]' : ''}`,
+        v.provider ? `provider: ${v.provider}` : null,
+        traits ? `traits: ${traits}` : null,
+        v.description ? `description: ${v.description}` : null,
+        v.useCase ? `use case: ${v.useCase}` : null,
+        v.previewUrl ? `preview: ${v.previewUrl}` : null,
+    ]));
+}
+/** List of brand kits. */
+export function brandKitListResult(kits) {
+    if (!kits.length)
+        return text('No brand kits found. Create one in the ContentHero app first.');
+    const rows = kits.map((k) => `- ${k.name}${k.businessName && k.businessName !== k.name ? ` (${k.businessName})` : ''} (id ${k.id})${k.isDefault ? ' [default]' : ''}${k.nicheDefinition ? ` | niche: ${k.nicheDefinition}` : ''}`);
+    return text([`${kits.length} brand kit(s):`, ...rows].join('\n'));
+}
+/**
+ * One brand kit in full. The kit is deeply structured (visual identity, voice,
+ * curated sections, linked accounts, knowledge), so return a short header plus
+ * the whole object as JSON: faithful and complete, and an agent reads it cleanly.
+ */
+export function brandKitResult(kit) {
+    const header = `Brand kit "${kit.name}"${kit.isDefault ? ' [default]' : ''} (id ${kit.id}):`;
+    return text([header, '', JSON.stringify(kit, null, 2)].join('\n'));
+}
+/** List of studio outputs (media). */
+export function mediaListResult(items) {
+    if (!items.length)
+        return text('No media found.');
+    const rows = items.map((m) => {
+        const vars = m.variationCount > 1 ? ` | ${m.variationCount} variations` : '';
+        const promptStr = m.prompt ? ` | ${m.prompt.slice(0, 80)}${m.prompt.length > 80 ? '...' : ''}` : '';
+        return `- [${m.type}] ${m.model ?? ''} (id ${m.id})${vars} | ${m.status}${promptStr}`;
+    });
+    return text([`${items.length} item(s) (newest first):`, ...rows].join('\n'));
+}
+/** One studio output's detail, with its variations. */
+export function mediaResult(m) {
+    const specs = [
+        m.aspectRatio ? `aspect ${m.aspectRatio}` : null,
+        m.resolution ? `res ${m.resolution}` : null,
+        m.duration ? `${m.duration}s` : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    return text(lines([
+        `${m.type} from ${m.model ?? 'unknown'} (id ${m.id})${m.selectedVariation ? `, variation ${m.selectedVariation}` : ''}`,
+        m.prompt ? `prompt: ${m.prompt}` : null,
+        m.script ? `script: ${m.script}` : null,
+        specs || null,
+        `status: ${m.status}${m.creditsUsed != null ? ` | ${m.creditsUsed} credits` : ''}`,
+        `variations (${m.variationCount}):`,
+        ...m.variations.map((v) => `  ${v.variation}. ${v.url ?? `(no url, ${v.status})`}${v.isFavorited ? ' [favorite]' : ''}`),
+    ]));
+}
+export function balanceResult(b) {
+    return text(`Balance: ${b.balance} credits (tier: ${b.tier}, auto top-up: ${b.autoTopupEnabled ? 'on' : 'off'}).`);
+}
+/** Map any thrown error onto a readable isError result. */
+export function errorResult(err) {
+    if (err instanceof InsufficientCreditsError) {
+        const parts = [];
+        if (err.required != null)
+            parts.push(`need ${err.required}`);
+        if (err.balance != null)
+            parts.push(`have ${err.balance}`);
+        const detail = parts.length ? ` (${parts.join(', ')})` : '';
+        return text(`Insufficient credits${detail}. Top up to continue.`, true);
+    }
+    if (err instanceof RateLimitError) {
+        const wait = err.retryAfter != null ? ` Retry in ${err.retryAfter}s.` : '';
+        return text(`Rate limit exceeded.${wait || ' Wait a moment before retrying.'}`, true);
+    }
+    if (err instanceof ContentHeroError || err instanceof Error) {
+        return text(err.message, true);
+    }
+    return text('Unknown error', true);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * ContentHero MCP server entry point (stdio transport).
+ *
+ * Run by an MCP client (Claude Code, Claude Desktop, etc.) as a child process.
+ * stdout is the protocol channel, so all logging goes to stderr.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * ContentHero MCP server entry point (stdio transport).
+ *
+ * Run by an MCP client (Claude Code, Claude Desktop, etc.) as a child process.
+ * stdout is the protocol channel, so all logging goes to stderr.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { buildServer } from './server.js';
+async function main() {
+    const server = await buildServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('ContentHero MCP server running on stdio');
+}
+main().catch((err) => {
+    console.error('ContentHero MCP server failed to start:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,WAAW,EAAE,CAAA;IAClC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAA;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAA;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/models.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Per-tool model lists, resolved dynamically from the discovery endpoint.
+ *
+ * `resolveModelEnums` fetches `GET /api/v1/models` (via the SDK) once at server
+ * startup and groups the enabled models into the three generate tools by their
+ * registry `kind`. So the model a tool offers always tracks the admin
+ * switchboard: enable a model in the app and it appears here on the next restart,
+ * with no package change. The hardcoded `*_FALLBACK` lists below are used only
+ * when discovery is unreachable (no key yet, or a network error), so the server
+ * still starts and advertises a sensible default surface.
+ *
+ * Grouping (v1 generate-tool scope):
+ *   - image: contentType=image, kind=generate (upscalers are kind=upscale)
+ *   - video: contentType=video, kind=generate (excludes upscale + lip-sync)
+ *   - audio: contentType=audio, kind=generate, outputType=audio (TTS/music/sfx;
+ *            excludes transcribe, which outputs text, and the voice utilities)
+ *   - upscale: kind=upscale (image or video), surfaced as the dedicated `upscale`
+ *            tool rather than mixed into the generate tools
+ *   - lipSync: kind=lip-sync (Wavespeed talking-head), surfaced as the dedicated
+ *            `generate_lip_sync` tool (a portrait + audio/script, not prompt-led)
+ */
+import type { ContentHero } from '@contenthero/sdk';
+/** Fallback image-generation models (used only if discovery is unreachable). */
+export declare const IMAGE_MODELS_FALLBACK: readonly ["nano-banana-2", "nano-banana", "nano-banana-pro", "seedream-5-lite", "gpt-image-2", "flux-2-pro", "flux-1-kontext"];
+/** Fallback video-generation models (used only if discovery is unreachable). */
+export declare const VIDEO_MODELS_FALLBACK: readonly ["veo-3.1-fast", "veo-3.1-quality", "seedance-2", "seedance-2-fast", "kling-3.0", "kling-2.6", "kling-3.0-motion-control", "kling-2.6-motion-control", "wan-2.6"];
+/** Fallback audio-generation models (used only if discovery is unreachable). */
+export declare const AUDIO_MODELS_FALLBACK: readonly ["elevenlabs-tts", "elevenlabs-music", "elevenlabs-sound-effects"];
+/** Fallback upscale models (used only if discovery is unreachable). */
+export declare const UPSCALE_MODELS_FALLBACK: readonly ["topaz-image-upscale", "topaz-video-upscale"];
+/** Fallback lip-sync models (used only if discovery is unreachable). */
+export declare const LIP_SYNC_MODELS_FALLBACK: readonly ["infinitalk", "infinitalk-fast", "kling-ai-avatar"];
+/** A non-empty model-id tuple, the shape `z.enum` requires. */
+export type ModelEnum = [string, ...string[]];
+export interface ResolvedModelEnums {
+    image: ModelEnum;
+    video: ModelEnum;
+    audio: ModelEnum;
+    upscale: ModelEnum;
+    lipSync: ModelEnum;
+    /** Maps each upscale modelId to its source media kind (image vs video). */
+    upscaleContentType: Record<string, 'image' | 'video'>;
+}
+/**
+ * Build the three per-tool model enums from the live discovery catalog, falling
+ * back to the static lists on any failure (missing key, network error, empty
+ * result). Never throws: the server must always start.
+ */
+export declare function resolveModelEnums(getClient: () => ContentHero): Promise<ResolvedModelEnums>;
+/** Short selection guidance baked into each generate tool's modelId description. */
+export declare const IMAGE_MODEL_GUIDANCE = "nano-banana-2 = strong general default (1K/2K/4K). gpt-image-2 = best text rendering. flux-2-pro / seedream-5-lite / nano-banana-pro = alternatives. Pass referenceImages for image-to-image / editing.";
+export declare const VIDEO_MODEL_GUIDANCE = "veo-3.1-fast / veo-3.1-quality = high quality clips with audio. seedance-2 / seedance-2-fast = multimodal references. kling-3.0 / kling-2.6 = strong motion. wan-2.6 = alternative. The motion-control variants require an input image plus an input video.";
+export declare const AUDIO_MODEL_GUIDANCE = "elevenlabs-tts = text to speech (needs text + voiceId). elevenlabs-music = music from a prompt. elevenlabs-sound-effects = a sound effect from a prompt.";
+export declare const UPSCALE_MODEL_GUIDANCE = "topaz-image-upscale = upscale an image (source must be an image URL). topaz-video-upscale = upscale a video (source must be a video URL; also pass durationSeconds).";
+export declare const LIP_SYNC_MODEL_GUIDANCE = "infinitalk = talking-head lip-sync (480p/720p). infinitalk-fast = faster, cheaper. kling-ai-avatar = Kling avatar (720p/1080p). All take a portrait image plus either an audio clip or a script + voiceId.";
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,gIAQxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,4KAUxB,CAAA;AAEV,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,6EAIxB,CAAA;AAEV,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,yDAA0D,CAAA;AAE9F,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,+DAAgE,CAAA;AAQrG,+DAA+D;AAC/D,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;AAE7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,2EAA2E;IAC3E,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;CACtD;AAMD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2CjG;AAED,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,4MAC0K,CAAA;AAE3M,eAAO,MAAM,oBAAoB,gQAC8N,CAAA;AAE/P,eAAO,MAAM,oBAAoB,6JAC2H,CAAA;AAE5J,eAAO,MAAM,sBAAsB,yKACqI,CAAA;AAExK,eAAO,MAAM,uBAAuB,+MAC0K,CAAA"}

package/dist/models.js

@@ -0,0 +1,114 @@
+/**
+ * Per-tool model lists, resolved dynamically from the discovery endpoint.
+ *
+ * `resolveModelEnums` fetches `GET /api/v1/models` (via the SDK) once at server
+ * startup and groups the enabled models into the three generate tools by their
+ * registry `kind`. So the model a tool offers always tracks the admin
+ * switchboard: enable a model in the app and it appears here on the next restart,
+ * with no package change. The hardcoded `*_FALLBACK` lists below are used only
+ * when discovery is unreachable (no key yet, or a network error), so the server
+ * still starts and advertises a sensible default surface.
+ *
+ * Grouping (v1 generate-tool scope):
+ *   - image: contentType=image, kind=generate (upscalers are kind=upscale)
+ *   - video: contentType=video, kind=generate (excludes upscale + lip-sync)
+ *   - audio: contentType=audio, kind=generate, outputType=audio (TTS/music/sfx;
+ *            excludes transcribe, which outputs text, and the voice utilities)
+ *   - upscale: kind=upscale (image or video), surfaced as the dedicated `upscale`
+ *            tool rather than mixed into the generate tools
+ *   - lipSync: kind=lip-sync (Wavespeed talking-head), surfaced as the dedicated
+ *            `generate_lip_sync` tool (a portrait + audio/script, not prompt-led)
+ */
+/** Fallback image-generation models (used only if discovery is unreachable). */
+export const IMAGE_MODELS_FALLBACK = [
+    'nano-banana-2',
+    'nano-banana',
+    'nano-banana-pro',
+    'seedream-5-lite',
+    'gpt-image-2',
+    'flux-2-pro',
+    'flux-1-kontext',
+];
+/** Fallback video-generation models (used only if discovery is unreachable). */
+export const VIDEO_MODELS_FALLBACK = [
+    'veo-3.1-fast',
+    'veo-3.1-quality',
+    'seedance-2',
+    'seedance-2-fast',
+    'kling-3.0',
+    'kling-2.6',
+    'kling-3.0-motion-control',
+    'kling-2.6-motion-control',
+    'wan-2.6',
+];
+/** Fallback audio-generation models (used only if discovery is unreachable). */
+export const AUDIO_MODELS_FALLBACK = [
+    'elevenlabs-tts',
+    'elevenlabs-music',
+    'elevenlabs-sound-effects',
+];
+/** Fallback upscale models (used only if discovery is unreachable). */
+export const UPSCALE_MODELS_FALLBACK = ['topaz-image-upscale', 'topaz-video-upscale'];
+/** Fallback lip-sync models (used only if discovery is unreachable). */
+export const LIP_SYNC_MODELS_FALLBACK = ['infinitalk', 'infinitalk-fast', 'kling-ai-avatar'];
+/** Source media kind per upscale model (used to route the source URL + duration). */
+const UPSCALE_CONTENT_TYPE_FALLBACK = {
+    'topaz-image-upscale': 'image',
+    'topaz-video-upscale': 'video',
+};
+function nonEmpty(ids, fallback) {
+    return (ids.length > 0 ? ids : [...fallback]);
+}
+/**
+ * Build the three per-tool model enums from the live discovery catalog, falling
+ * back to the static lists on any failure (missing key, network error, empty
+ * result). Never throws: the server must always start.
+ */
+export async function resolveModelEnums(getClient) {
+    try {
+        const models = await getClient().listModels();
+        const image = models
+            .filter((m) => m.contentType === 'image' && m.kind === 'generate')
+            .map((m) => m.modelId);
+        const video = models
+            .filter((m) => m.contentType === 'video' && m.kind === 'generate')
+            .map((m) => m.modelId);
+        const audio = models
+            .filter((m) => m.contentType === 'audio' &&
+            m.kind === 'generate' &&
+            m.capabilities?.outputType === 'audio')
+            .map((m) => m.modelId);
+        const upscaleModels = models.filter((m) => m.kind === 'upscale');
+        const upscale = upscaleModels.map((m) => m.modelId);
+        const upscaleContentType = {};
+        for (const m of upscaleModels) {
+            upscaleContentType[m.modelId] = m.contentType === 'video' ? 'video' : 'image';
+        }
+        const lipSync = models.filter((m) => m.kind === 'lip-sync').map((m) => m.modelId);
+        return {
+            image: nonEmpty(image, IMAGE_MODELS_FALLBACK),
+            video: nonEmpty(video, VIDEO_MODELS_FALLBACK),
+            audio: nonEmpty(audio, AUDIO_MODELS_FALLBACK),
+            upscale: nonEmpty(upscale, UPSCALE_MODELS_FALLBACK),
+            lipSync: nonEmpty(lipSync, LIP_SYNC_MODELS_FALLBACK),
+            upscaleContentType: upscale.length > 0 ? upscaleContentType : { ...UPSCALE_CONTENT_TYPE_FALLBACK },
+        };
+    }
+    catch {
+        return {
+            image: [...IMAGE_MODELS_FALLBACK],
+            video: [...VIDEO_MODELS_FALLBACK],
+            audio: [...AUDIO_MODELS_FALLBACK],
+            upscale: [...UPSCALE_MODELS_FALLBACK],
+            lipSync: [...LIP_SYNC_MODELS_FALLBACK],
+            upscaleContentType: { ...UPSCALE_CONTENT_TYPE_FALLBACK },
+        };
+    }
+}
+/** Short selection guidance baked into each generate tool's modelId description. */
+export const IMAGE_MODEL_GUIDANCE = 'nano-banana-2 = strong general default (1K/2K/4K). gpt-image-2 = best text rendering. flux-2-pro / seedream-5-lite / nano-banana-pro = alternatives. Pass referenceImages for image-to-image / editing.';
+export const VIDEO_MODEL_GUIDANCE = 'veo-3.1-fast / veo-3.1-quality = high quality clips with audio. seedance-2 / seedance-2-fast = multimodal references. kling-3.0 / kling-2.6 = strong motion. wan-2.6 = alternative. The motion-control variants require an input image plus an input video.';
+export const AUDIO_MODEL_GUIDANCE = 'elevenlabs-tts = text to speech (needs text + voiceId). elevenlabs-music = music from a prompt. elevenlabs-sound-effects = a sound effect from a prompt.';
+export const UPSCALE_MODEL_GUIDANCE = 'topaz-image-upscale = upscale an image (source must be an image URL). topaz-video-upscale = upscale a video (source must be a video URL; also pass durationSeconds).';
+export const LIP_SYNC_MODEL_GUIDANCE = 'infinitalk = talking-head lip-sync (480p/720p). infinitalk-fast = faster, cheaper. kling-ai-avatar = Kling avatar (720p/1080p). All take a portrait image plus either an audio clip or a script + voiceId.';
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The ContentHero MCP server: intent-shaped tools over the @contenthero/sdk kernel.
+ *
+ *   generate_image    - smart-wait, image models
+ *   generate_video    - smart-wait, video models
+ *   generate_audio    - synchronous (ElevenLabs), no polling
+ *   upscale           - smart-wait, image/video upscalers
+ *   generate_lip_sync - smart-wait, talking-head lip-sync (portrait + audio/script)
+ *   transcribe        - synchronous speech-to-text (audio URL -> transcript)
+ *   list_avatars / get_avatar - the account's avatars (base look + default voice)
+ *   list_voices  / get_voice  - the account's saved voices
+ *   list_brand_kits / get_brand_kit - the account's brand kits (full brand context)
+ *   list_media / get_media    - the account's studio outputs (+ per-variation ids)
+ *   check_generation  - poll an image/video outputId to its final URLs
+ *   get_balance       - credit balance + tier
+ *
+ * Intent-shaped generate tools rather than one generate_media: each operation
+ * (generate / upscale / lip-sync) gets a tool whose schema only carries its own
+ * fields, and per-tool modelId enums prevent cross-type model misuse. Image and
+ * video share the async smart-wait lifecycle; audio shares almost no parameters
+ * and runs synchronously.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ContentHero } from '@contenthero/sdk';
+export interface BuildServerOptions {
+    /** Override the SDK client (for tests). Defaults to the env-configured client. */
+    getClient?: () => ContentHero;
+}
+export declare function buildServer(options?: BuildServerOptions): Promise<McpServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAEnE,OAAO,EACL,WAAW,EAIZ,MAAM,kBAAkB,CAAA;AAsCzB,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,WAAW,CAAA;CAC9B;AAYD,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,SAAS,CAAC,CAietF"}

package/dist/server.js

@@ -0,0 +1,451 @@
+/**
+ * The ContentHero MCP server: intent-shaped tools over the @contenthero/sdk kernel.
+ *
+ *   generate_image    - smart-wait, image models
+ *   generate_video    - smart-wait, video models
+ *   generate_audio    - synchronous (ElevenLabs), no polling
+ *   upscale           - smart-wait, image/video upscalers
+ *   generate_lip_sync - smart-wait, talking-head lip-sync (portrait + audio/script)
+ *   transcribe        - synchronous speech-to-text (audio URL -> transcript)
+ *   list_avatars / get_avatar - the account's avatars (base look + default voice)
+ *   list_voices  / get_voice  - the account's saved voices
+ *   list_brand_kits / get_brand_kit - the account's brand kits (full brand context)
+ *   list_media / get_media    - the account's studio outputs (+ per-variation ids)
+ *   check_generation  - poll an image/video outputId to its final URLs
+ *   get_balance       - credit balance + tier
+ *
+ * Intent-shaped generate tools rather than one generate_media: each operation
+ * (generate / upscale / lip-sync) gets a tool whose schema only carries its own
+ * fields, and per-tool modelId enums prevent cross-type model misuse. Image and
+ * video share the async smart-wait lifecycle; audio shares almost no parameters
+ * and runs synchronously.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { GenerationTimeoutError, } from '@contenthero/sdk';
+import { getClient as defaultGetClient } from './client.js';
+import { resolveModelEnums, IMAGE_MODEL_GUIDANCE, VIDEO_MODEL_GUIDANCE, AUDIO_MODEL_GUIDANCE, UPSCALE_MODEL_GUIDANCE, LIP_SYNC_MODEL_GUIDANCE, } from './models.js';
+import { audioResult, avatarListResult, avatarResult, balanceResult, brandKitListResult, brandKitResult, completedResult, mediaListResult, mediaResult, errorResult, generationStatusResult, pendingResult, transcriptResult, voiceListResult, voiceResult, } from './format.js';
+/**
+ * How long the smart-wait tools (generate_image / generate_video / upscale /
+ * generate_lip_sync) wait inline before handing back the outputId to poll.
+ * Kept under the MCP SDK's default 60s client request timeout, so a slow render
+ * returns the clean "still rendering, call check_generation" handoff rather than
+ * tripping the client's timeout. Comfortably covers images (~15-30s); slower
+ * video/lip-sync jobs return the pollable pending result.
+ */
+const SMART_WAIT_MS = 50_000;
+/** Drop undefined values so the request payload stays minimal. */
+function compact(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+function buildReferences(parts) {
+    const refs = compact(parts);
+    return Object.keys(refs).length > 0 ? refs : undefined;
+}
+export async function buildServer(options = {}) {
+    const getClient = options.getClient ?? defaultGetClient;
+    // Resolve the per-tool model enums from the live discovery catalog (falls back
+    // to static lists if discovery is unreachable). Done once at startup, since
+    // tool schemas are advertised once; a restart picks up admin-switchboard changes.
+    const models = await resolveModelEnums(getClient);
+    const server = new McpServer({ name: 'contenthero', version: '0.1.0' });
+    // -- generate_image -------------------------------------------------------
+    server.registerTool('generate_image', {
+        title: 'Generate Image',
+        description: 'Generate one or more images from a text prompt (optionally image-to-image with reference images). Waits for the result and returns the image URLs.',
+        inputSchema: {
+            modelId: z.enum(models.image).describe(IMAGE_MODEL_GUIDANCE),
+            prompt: z
+                .string()
+                .optional()
+                .describe('Describe the image to generate. Required for most models; optional for a few that can run from references alone.'),
+            aspectRatio: z.string().optional().describe('e.g. 16:9, 1:1, 9:16. Validated per model.'),
+            resolution: z.string().optional().describe('e.g. 1K, 2K, 4K. Model-dependent.'),
+            quality: z.string().optional().describe('GPT Image models only: high or medium.'),
+            numImages: z.number().int().min(1).max(4).optional().describe('Number of variations (1-4).'),
+            seed: z.number().int().optional().describe('Seed for reproducibility.'),
+            referenceImages: z
+                .array(z.string())
+                .optional()
+                .describe('References for image-to-image / editing. Each may be a URL or a previous output id (e.g. "<id>" or "<id>-2") to chain from an earlier generation.'),
+        },
+    }, async (args) => {
+        try {
+            const request = compact({
+                contentType: 'image',
+                modelId: args.modelId,
+                prompt: args.prompt,
+                aspectRatio: args.aspectRatio,
+                resolution: args.resolution,
+                quality: args.quality,
+                numImages: args.numImages,
+                seed: args.seed,
+                references: buildReferences({ images: args.referenceImages }),
+            });
+            const gen = await getClient().generateAndWait(request, { timeoutMs: SMART_WAIT_MS });
+            return completedResult(gen);
+        }
+        catch (err) {
+            if (err instanceof GenerationTimeoutError)
+                return pendingResult(err.outputId);
+            return errorResult(err);
+        }
+    });
+    // -- generate_video -------------------------------------------------------
+    server.registerTool('generate_video', {
+        title: 'Generate Video',
+        description: 'Generate a video from a text prompt (optionally from a start/end frame or reference images/videos). Waits up to ~50s; if the render is still running it returns an outputId to poll with check_generation.',
+        inputSchema: {
+            modelId: z.enum(models.video).describe(VIDEO_MODEL_GUIDANCE),
+            prompt: z
+                .string()
+                .optional()
+                .describe('Describe the video to generate. Required for most models; optional for some (e.g. motion-control), where it is an auxiliary motion hint.'),
+            aspectRatio: z.string().optional().describe('e.g. 16:9, 9:16. Validated per model.'),
+            resolution: z.string().optional().describe('e.g. 720p, 1080p, 4K. Model-dependent.'),
+            duration: z
+                .number()
+                .optional()
+                .describe('Clip length in seconds. Model-dependent; some models lock it.'),
+            audioEnabled: z
+                .boolean()
+                .optional()
+                .describe('Generate audio (only for models that support it).'),
+            numGenerations: z.number().int().min(1).max(4).optional().describe('Number of variations (1-4).'),
+            negativePrompt: z.string().optional().describe('What to avoid (models that support it).'),
+            seed: z.number().int().optional().describe('Seed for reproducibility.'),
+            startFrame: z.string().optional().describe('First frame: an image URL or a previous output id (e.g. "<id>-2") to chain (e.g. animate an image you just generated).'),
+            endFrame: z.string().optional().describe('Last frame: an image URL or a previous output id.'),
+            referenceImages: z.array(z.string()).optional().describe('Reference images: each a URL or a previous output id to chain.'),
+            referenceVideos: z.array(z.string()).optional().describe('Reference videos: each a URL or a previous output id to chain.'),
+        },
+    }, async (args) => {
+        try {
+            const request = compact({
+                contentType: 'video',
+                modelId: args.modelId,
+                prompt: args.prompt,
+                aspectRatio: args.aspectRatio,
+                resolution: args.resolution,
+                duration: args.duration,
+                audioEnabled: args.audioEnabled,
+                numGenerations: args.numGenerations,
+                negativePrompt: args.negativePrompt,
+                seed: args.seed,
+                references: buildReferences({
+                    startFrame: args.startFrame,
+                    endFrame: args.endFrame,
+                    images: args.referenceImages,
+                    videos: args.referenceVideos,
+                }),
+            });
+            const gen = await getClient().generateAndWait(request, { timeoutMs: SMART_WAIT_MS });
+            return completedResult(gen);
+        }
+        catch (err) {
+            if (err instanceof GenerationTimeoutError)
+                return pendingResult(err.outputId);
+            return errorResult(err);
+        }
+    });
+    // -- generate_audio (synchronous) -----------------------------------------
+    server.registerTool('generate_audio', {
+        title: 'Generate Audio',
+        description: 'Generate audio with ElevenLabs: speech (TTS), music, or a sound effect. Returns the audio URL directly (synchronous, no polling).',
+        inputSchema: {
+            modelId: z.enum(models.audio).describe(AUDIO_MODEL_GUIDANCE),
+            prompt: z.string().optional().describe('For music / sfx: what to generate.'),
+            text: z.string().optional().describe('For TTS (elevenlabs-tts): the words to speak.'),
+            voiceId: z.string().optional().describe('For TTS: the ElevenLabs voice id.'),
+            voiceName: z.string().optional().describe('For TTS: human-readable voice name (display only).'),
+            durationSeconds: z.number().optional().describe('For music / sfx: length in seconds.'),
+            promptInfluence: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('For sfx: how literally to follow the prompt (0 to 1).'),
+        },
+    }, async (args) => {
+        try {
+            const request = compact({
+                contentType: 'audio',
+                modelId: args.modelId,
+                prompt: args.prompt,
+                text: args.text,
+                voiceId: args.voiceId,
+                voiceName: args.voiceName,
+                durationSeconds: args.durationSeconds,
+                promptInfluence: args.promptInfluence,
+            });
+            const result = await getClient().generate(request);
+            return audioResult(result);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- upscale --------------------------------------------------------------
+    server.registerTool('upscale', {
+        title: 'Upscale',
+        description: 'Upscale an existing image or video to a higher resolution. Provide the source media URL and a model-supported factor. Waits for the result; if the job is still running it returns an outputId to poll with check_generation.',
+        inputSchema: {
+            modelId: z.enum(models.upscale).describe(UPSCALE_MODEL_GUIDANCE),
+            sourceUrl: z.string().describe('The source image (image upscalers) or video (video upscalers): a URL or a previous output id (e.g. "<id>-1") to upscale an earlier generation.'),
+            factor: z.string().describe('Upscale factor, e.g. 2x, 4x. Model-dependent; validated per model.'),
+            durationSeconds: z
+                .number()
+                .optional()
+                .describe('Required for video upscalers: the source video length in seconds (used for pricing).'),
+        },
+    }, async (args) => {
+        try {
+            const isVideo = models.upscaleContentType[args.modelId] === 'video';
+            const request = compact({
+                contentType: isVideo ? 'video' : 'image',
+                modelId: args.modelId,
+                upscaleFactor: args.factor,
+                duration: isVideo ? args.durationSeconds : undefined,
+                references: isVideo ? { videos: [args.sourceUrl] } : { images: [args.sourceUrl] },
+            });
+            const gen = await getClient().generateAndWait(request, { timeoutMs: SMART_WAIT_MS });
+            return completedResult(gen);
+        }
+        catch (err) {
+            if (err instanceof GenerationTimeoutError)
+                return pendingResult(err.outputId);
+            return errorResult(err);
+        }
+    });
+    // -- generate_lip_sync ----------------------------------------------------
+    server.registerTool('generate_lip_sync', {
+        title: 'Generate Lip Sync',
+        description: 'Animate a portrait image so the subject speaks. Provide imageUrl (the face) plus a voice source: either audioUrl (an existing speech clip) or script + voiceId (we synthesize the speech). Optional motionPrompt nudges expression/motion. Waits up to ~50s; if still rendering it returns an outputId to poll with check_generation.',
+        inputSchema: {
+            modelId: z.enum(models.lipSync).describe(LIP_SYNC_MODEL_GUIDANCE),
+            imageUrl: z.string().describe('The portrait to animate (the speaking subject): an image URL or a previous output id (e.g. "<id>-1") to chain.'),
+            audioUrl: z
+                .string()
+                .optional()
+                .describe('An existing speech clip: an audio URL or a previous output id. Use this OR script + voiceId.'),
+            script: z
+                .string()
+                .optional()
+                .describe('Text for the subject to speak. Requires voiceId; synthesized to speech. Use this OR audioUrl.'),
+            voiceId: z.string().optional().describe('ElevenLabs voice id to speak the script (required with script).'),
+            voiceName: z.string().optional().describe('Human-readable voice name (display only).'),
+            motionPrompt: z
+                .string()
+                .optional()
+                .describe('Optional motion / expression hint for the animation.'),
+            resolution: z.string().optional().describe('e.g. 480p, 720p, 1080p. Model-dependent.'),
+            audioDurationSeconds: z
+                .number()
+                .optional()
+                .describe('Length of audioUrl in seconds (audio mode only; improves cost accuracy).'),
+        },
+    }, async (args) => {
+        try {
+            const request = compact({
+                contentType: 'video',
+                modelId: args.modelId,
+                prompt: args.motionPrompt,
+                text: args.script,
+                voiceId: args.voiceId,
+                voiceName: args.voiceName,
+                resolution: args.resolution,
+                durationSeconds: args.audioDurationSeconds,
+                references: buildReferences({
+                    images: [args.imageUrl],
+                    audio: args.audioUrl ? [args.audioUrl] : undefined,
+                }),
+            });
+            const gen = await getClient().generateAndWait(request, { timeoutMs: SMART_WAIT_MS });
+            return completedResult(gen);
+        }
+        catch (err) {
+            if (err instanceof GenerationTimeoutError)
+                return pendingResult(err.outputId);
+            return errorResult(err);
+        }
+    });
+    // -- transcribe -----------------------------------------------------------
+    server.registerTool('transcribe', {
+        title: 'Transcribe Audio',
+        description: 'Transcribe an audio URL to text (speech-to-text). Returns the transcript directly (synchronous, free, no polling).',
+        inputSchema: {
+            audioUrl: z.string().describe('Public URL of the audio file to transcribe.'),
+            languageCode: z
+                .string()
+                .optional()
+                .describe('ISO language hint, e.g. "en". Auto-detected when omitted.'),
+            diarize: z.boolean().optional().describe('Label each speaker (diarization).'),
+        },
+    }, async (args) => {
+        try {
+            const t = await getClient().transcribe({
+                audioUrl: args.audioUrl,
+                languageCode: args.languageCode,
+                diarize: args.diarize,
+            });
+            return transcriptResult(t);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_avatars ---------------------------------------------------------
+    server.registerTool('list_avatars', {
+        title: 'List Avatars',
+        description: "List the account's avatars. Each avatar has an imageUrl (its base look) and a defaultVoiceId, which feed generate_lip_sync. Call get_avatar for full detail and the avatar's looks.",
+    }, async () => {
+        try {
+            return avatarListResult(await getClient().listAvatars());
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_avatar -----------------------------------------------------------
+    server.registerTool('get_avatar', {
+        title: 'Get Avatar',
+        description: 'Get one avatar by id: its base image (use as generate_lip_sync imageUrl), default voice, traits, and its looks (outfit variations).',
+        inputSchema: {
+            avatarId: z.string().describe('The avatar id from list_avatars.'),
+        },
+    }, async (args) => {
+        try {
+            return avatarResult(await getClient().getAvatar(args.avatarId));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_voices ----------------------------------------------------------
+    server.registerTool('list_voices', {
+        title: 'List Voices',
+        description: "List the account's saved voices (favorites first). Each has a voiceId for generate_lip_sync / generate_audio (TTS). Call get_voice for full detail.",
+    }, async () => {
+        try {
+            return voiceListResult(await getClient().listVoices());
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_voice ------------------------------------------------------------
+    server.registerTool('get_voice', {
+        title: 'Get Voice',
+        description: 'Get one voice by its voiceId: provider, traits (accent/language/gender/age), description, and a preview URL.',
+        inputSchema: {
+            voiceId: z.string().describe('The voice id from list_voices.'),
+        },
+    }, async (args) => {
+        try {
+            return voiceResult(await getClient().getVoice(args.voiceId));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_brand_kits ------------------------------------------------------
+    server.registerTool('list_brand_kits', {
+        title: 'List Brand Kits',
+        description: "List the account's brand kits (default first). Call get_brand_kit for one kit's full brand context (voice, visual identity, audience, sections, accounts, knowledge) to write on-brand content.",
+    }, async () => {
+        try {
+            return brandKitListResult(await getClient().listBrandKits());
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_brand_kit --------------------------------------------------------
+    server.registerTool('get_brand_kit', {
+        title: 'Get Brand Kit',
+        description: 'Get one brand kit in full: business overview, positioning, audience, voice profile, visual identity (logos/colors/typography), curated sections, linked brand + inspiration accounts, and a knowledge-base summary. Use it to ground on-brand generation.',
+        inputSchema: {
+            brandKitId: z.string().describe('The brand kit id from list_brand_kits.'),
+        },
+    }, async (args) => {
+        try {
+            return brandKitResult(await getClient().getBrandKit(args.brandKitId));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- list_media -----------------------------------------------------------
+    server.registerTool('list_media', {
+        title: 'List Media',
+        description: "List the account's recent studio outputs (generated images, videos, audio, transcripts), newest first. Each item has an id and its variation URLs. Call get_media for one output's full detail and individual variations.",
+        inputSchema: {
+            contentType: z
+                .enum(['image', 'video', 'audio', 'transcript'])
+                .optional()
+                .describe('Filter to one media type.'),
+            status: z.string().optional().describe("Status filter; defaults to 'completed'."),
+            limit: z.number().int().min(1).max(100).optional().describe('How many to return (default 20).'),
+        },
+    }, async (args) => {
+        try {
+            return mediaListResult(await getClient().listMedia({
+                contentType: args.contentType,
+                status: args.status,
+                limit: args.limit,
+            }));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_media ------------------------------------------------------------
+    server.registerTool('get_media', {
+        title: 'Get Media',
+        description: 'Get one studio output by id: its variations (URLs), prompt/script, model, and specs. The id may be the full output id, its first 8 characters, or either with a "-N" suffix to address one variation (1-based, e.g. "...abcd-2"). A whole-output id returns all variations.',
+        inputSchema: {
+            id: z
+                .string()
+                .describe('The output id (full or first-8), optionally with a "-N" variation suffix.'),
+        },
+    }, async (args) => {
+        try {
+            return mediaResult(await getClient().getMedia(args.id));
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- check_generation -----------------------------------------------------
+    server.registerTool('check_generation', {
+        title: 'Check Generation',
+        description: 'Poll an image or video generation by its outputId (returned by generate_image / generate_video when a render is still in progress). Returns the final URLs once complete.',
+        inputSchema: {
+            outputId: z.string().describe('The outputId from generate_image or generate_video.'),
+        },
+    }, async (args) => {
+        try {
+            const gen = await getClient().getGeneration(args.outputId);
+            return generationStatusResult(gen);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    // -- get_balance ----------------------------------------------------------
+    server.registerTool('get_balance', {
+        title: 'Get Balance',
+        description: 'Get the current ContentHero credit balance, subscription tier, and auto-top-up state.',
+    }, async () => {
+        try {
+            const balance = await getClient().getBalance();
+            return balanceResult(balance);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@contenthero/mcp",
+  "version": "0.1.0",
+  "description": "Official ContentHero MCP server. Generate images, video, and audio from any MCP client (Claude Code, Claude Desktop, etc.) using your ContentHero API key.",
+  "type": "module",
+  "bin": {
+    "contenthero-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "tsx --test \"src/**/*.test.ts\"",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/contenthero-ai/contenthero-packages.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": [
+    "contenthero",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "image-generation",
+    "video-generation",
+    "text-to-speech"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "private": false,
+  "dependencies": {
+    "@contenthero/sdk": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.19",
+    "tsx": "^4.22.3"
+  }
+}