@nooticr/mcp 1.26.61 → 1.26.63

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-102 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+106 tools, grouped by what you are trying to do. Prices are in nooticr credits and
 match what the server actually charges.
 
 The job tools under **Answer a question you actually have** are not
@@ -104,6 +104,10 @@ them caps that fan-out with an argument.
 | `create_brand_watch` | free to call | Schedule a recurring sweep and get emailed only what is new. `kind: "mentions"` (default) is a recurring `search_mentions` sweep for `term`/`platforms`; `kind: "competitor"` is a recurring `get_user_posts` check on one creator (`handle`/`platform`), mailing only what beats their own recent median; `kind: "report"` runs `job: {tool, args}` — `niche_report` (mailed as written every run) or `discover_social_posts` (only unseen posts) — on the schedule; `kind: "portfolio"` sweeps up to 25 `terms` (your brand, products, competitors) across the same networks under one budget and mails one digest with each term's share of voice. Two calls by design: the first returns the quote (cost per run, cadence, cost per day) and a `confirmationToken`; nothing is created or charged until you call it again with `confirm: true` and that token. Each run then bills the same as calling the matching tool yourself — 2 credits per network (5 for Xiaohongshu) for mentions, a flat 2 credits for competitor, the job tool's own price for a report (3 for `niche_report`), and a mentions sweep per term for a portfolio — whose budget is split evenly and trims networks, never terms, and which refunds any term whose sweep fails. |
 | `list_brand_watches` | free | Every watch you have scheduled: term, networks, cadence, cost per run, credits spent so far, runs made, and when the next one is due. |
 | `creative_assets_list` | free | The creative assets (voice-overs, sound effects, music, images, videos, composites) generated in your workspace, newest first, with url, kind, dimensions or duration, and provenance. Filter by `appId`, `kind`, `briefId` or `since`; page with `nextCursor`. |
+| `creative_voices_search` | free | Search ElevenLabs' voice library by `query`, `language`, `accent`, `gender`, `age` or `useCase`. Returns a `voiceRef`, name, labels, language, accent and preview URL for each. Library voices only, never a cloned voice. |
+| `creative_voiceover` | quoted first | A voice-over of up to 2500 characters with word timings for burned-in captions, in a voice from `creative_voices_search`. The first call returns a quote in credits and charges nothing; call again with `confirm: true` and the `confirmationToken` to generate. Settled to actual usage, never above the quote. |
+| `creative_sfx` | quoted first | A short sound effect (0.5-10 s) from a description. Same quote-then-confirm handshake as `creative_voiceover`. |
+| `creative_music` | quoted first | An instrumental music bed of 5-60 seconds, generated as a job: confirm the quote, then poll `creative_job_status`. May be switched off on a deployment, in which case it says so. Describe mood, tempo and instruments, not artists or songs. |
 | `creative_job_status` | free | Where an asynchronous creative job stands by `jobId`: queued, running, done, failed or canceled, with the finished assets and the credits quoted, charged and refunded. Poll after `pollAfterSeconds`. |
 | `mention_trend` | free | **What a watch has seen over time**, which nothing else here answers — every other read is about now. One point per run: when it ran, how many mentions it found, how many were new, and both counts per network, so "which network is growing" and "did it go quiet or did we stop looking" come apart. On a competitor watch each point carries the median that run measured, which turns "they beat their own median" into "and that median has doubled". Plus the mentions more than one run has seen. Free because the sweeps were billed when they ran; charging again to read what was already paid for is the thing it fixes. |
 | `update_watch_portfolio` | free | Add or remove a portfolio watch's terms by `watchId`. No new confirmation, because the per-run budget you agreed to does not move — more terms split it more ways, and the reply names any network a run no longer reaches. |

package/dist/shared/creative.js

@@ -4,8 +4,10 @@
  * Both are passthroughs to the server's `POST /mcp` dispatch, which owns the
  * tenancy check (another workspace's id answers "not found").
  *
- * The paid creative tools (CR2-CR6) register here when they ship;
- * `creative_test_render` is a server test fixture and is never registered.
+ * The ElevenLabs half (CR2): `creative_voices_search` is free; `creative_voiceover`,
+ * `creative_sfx` and `creative_music` are paid and use the server's quote-then-confirm
+ * handshake. The remaining paid creative tools (image, video, ...) register here when
+ * they ship; `creative_test_render` is a server test fixture and is never registered.
  * Neither tool has a view yet: the asset list would be a gallery, which the
  * design system has no card for.
  */
@@ -64,4 +66,92 @@ export function registerCreativeTools(server, makeClient) {
         inputSchema: z.object({ jobId: z.string().uuid().describe("jobId returned when the job was started.") }).strict(),
         outputSchema: OUTPUT_SCHEMAS.creative_job_status,
     }, passthrough("creative_job_status"));
+    const voiceRef = z
+        .object({ publicOwnerId: z.string(), voiceId: z.string() })
+        .strict()
+        .describe("A voiceRef from creative_voices_search.");
+    const handshake = {
+        briefId: z.string().optional(),
+        confirm: z.boolean().optional().describe("Set true only once the user has agreed to the quoted credits."),
+        confirmationToken: z.string().optional().describe("The token the quote returned."),
+    };
+    const paidAnnotations = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
+    const NO_LIKENESS = " No real people's likeness or voice, no copyrighted music, logos or characters.";
+    server.registerTool("creative_voices_search", {
+        title: "Search Creative Voices",
+        description: "Search ElevenLabs' voice library for a voice to use in creative_voiceover. Library voices " +
+            "only, never a real person's cloned voice. Returns voiceRef, name, labels, language, accent " +
+            "and previewUrl. No cost to call.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+        inputSchema: z
+            .object({
+            query: z.string().optional(),
+            language: z.string().optional().describe("e.g. en, fr, es."),
+            accent: z.string().optional(),
+            gender: z.enum(["male", "female", "neutral"]).optional(),
+            age: z.enum(["young", "middle_aged", "old"]).optional(),
+            useCase: z.enum(["narration", "social_media", "advertisement", "conversational", "characters"]).optional(),
+            limit: z.number().int().min(1).max(20).optional(),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_voices_search,
+    }, passthrough("creative_voices_search"));
+    server.registerTool("creative_voiceover", {
+        title: "Create Voice-over",
+        description: "Voice-over with word timings (for burned-in captions); the text is spoken verbatim, up to 2500 " +
+            "characters. Pass a voiceRef (or voiceId) from creative_voices_search; library voices only, no " +
+            "cloning. quality: final (default) or draft (cheaper, faster). The first call is a free price " +
+            "quote in credits (vendor cost plus markup, never above the quote); nothing is charged until " +
+            "you confirm. Show the user the credits and ask before calling again with confirm: true and " +
+            "the confirmationToken." + NO_LIKENESS,
+        annotations: paidAnnotations,
+        inputSchema: z
+            .object({
+            appId: z.number().int(),
+            text: z.string().min(1).max(2500),
+            voiceRef: voiceRef.optional(),
+            voiceId: z.string().optional(),
+            quality: z.enum(["final", "draft"]).optional(),
+            stability: z.number().min(0).max(1).optional(),
+            style: z.number().min(0).max(1).optional(),
+            speed: z.number().min(0.7).max(1.2).optional(),
+            ...handshake,
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_voiceover,
+    }, passthrough("creative_voiceover"));
+    server.registerTool("creative_sfx", {
+        title: "Create Sound Effect",
+        description: "Generate a short sound effect (0.5-10 s) from a description of up to 300 characters; the text " +
+            "is a prompt, not spoken. The first call is a free price quote in credits; nothing is charged until you confirm. Show the user the " +
+            "credits and ask before calling again with confirm: true and the confirmationToken." + NO_LIKENESS,
+        annotations: paidAnnotations,
+        inputSchema: z
+            .object({
+            appId: z.number().int(),
+            description: z.string().min(1).max(300),
+            durationSeconds: z.number().min(0.5).max(10).optional(),
+            ...handshake,
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_sfx,
+    }, passthrough("creative_sfx"));
+    server.registerTool("creative_music", {
+        title: "Create Music Bed",
+        description: "Instrumental music bed, 5-60 seconds, as an asynchronous job. Describe mood, tempo and " +
+            "instruments, not artists or songs. May be switched off on this deployment (it then says so " +
+            "and offers stock music). The first call is a free price quote in credits; nothing is charged until you confirm. Show the user the " +
+            "credits and ask before calling again with confirm: true and the confirmationToken, then poll " +
+            "creative_job_status every 10-20 s." + NO_LIKENESS,
+        annotations: paidAnnotations,
+        inputSchema: z
+            .object({
+            appId: z.number().int(),
+            prompt: z.string().min(1).max(500),
+            durationSeconds: z.number().int().min(5).max(60),
+            ...handshake,
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_music,
+    }, passthrough("creative_music"));
 }

package/dist/shared/loading-plans.js

@@ -479,6 +479,11 @@ export const LOADING_PLANS = {
     // Creative assets (creative.ts): both are free reads.
     creative_assets_list: { label: "Reading your creative assets", kind: "list", n: 3, steps: [], free: true },
     creative_job_status: { label: "Checking the creative job", kind: "text", n: 1, steps: [], free: true },
+    creative_voices_search: { label: "Searching voices", kind: "list", n: 3, steps: [], free: true },
+    // Paid, but the first call only quotes; the charge waits for the confirmed second call.
+    creative_voiceover: { label: "Quoting the voice-over", kind: "text", n: 1, steps: [] },
+    creative_sfx: { label: "Quoting the sound effect", kind: "text", n: 1, steps: [] },
+    creative_music: { label: "Quoting the music bed", kind: "text", n: 1, steps: [] },
     list_brand_watches: { label: "Reading your watches", kind: "list", n: 3, steps: [], free: true },
     stop_brand_watch: { label: "Stopping the watch", kind: "text", n: 1, steps: [], free: true },
     update_watch_portfolio: { label: "Updating the portfolio", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/output-schemas.js

@@ -1260,6 +1260,45 @@ export const OUTPUT_SCHEMAS = {
         assets: listOf(open({ id: scalar(), kind: scalar(), appId: scalar(), url: scalar(), mime: scalar(), createdAt: scalar() })),
         nextCursor: scalar(),
     }),
+    creative_voices_search: open({
+        voices: listOf(open({ voiceRef: open({ publicOwnerId: scalar(), voiceId: scalar() }), name: scalar(), language: scalar(), accent: scalar(), previewUrl: scalar() })),
+    }),
+    // The paid tools answer a quote first, then the generated assets (or a job for music).
+    creative_voiceover: open({
+        quote: open({ credits: scalar() }).nullish().describe("First call: what generating will cost. Nothing was generated or charged yet."),
+        confirmationToken: scalar().describe("Pass this back with confirm: true to generate."),
+        expiresAt: scalar(),
+        next: scalar(),
+        assetId: scalar(),
+        url: scalar(),
+        key: scalar(),
+        durationMs: scalar(),
+        words: listOf(open({ text: scalar(), start: scalar(), end: scalar() })),
+        wordsTruncated: scalar(),
+        creativeCredits: open({}).nullish(),
+    }),
+    creative_sfx: open({
+        quote: open({ credits: scalar() }).nullish().describe("First call: what generating will cost. Nothing was generated or charged yet."),
+        confirmationToken: scalar().describe("Pass this back with confirm: true to generate."),
+        expiresAt: scalar(),
+        next: scalar(),
+        assetId: scalar(),
+        url: scalar(),
+        key: scalar(),
+        durationMs: scalar(),
+        creativeCredits: open({}).nullish(),
+    }),
+    creative_music: open({
+        quote: open({ credits: scalar() }).nullish().describe("First call: what generating will cost. Nothing was generated or charged yet."),
+        confirmationToken: scalar().describe("Pass this back with confirm: true to start the job."),
+        expiresAt: scalar(),
+        next: scalar(),
+        jobId: scalar().describe("Poll creative_job_status with this."),
+        status: scalar(),
+        creativeCredits: open({}).nullish(),
+        refused: scalar().describe("not_enabled when music generation is switched off for this account."),
+        alternative: scalar(),
+    }),
     creative_job_status: open({
         jobId: scalar(),
         tool: scalar(),

package/dist/shared/tools-def.js

@@ -270,6 +270,30 @@ export const TOOL_DEFINITIONS = [
         description: "List the creative assets (voice-overs, sound effects, music, images, videos, composites) generated in this workspace, newest first. Optional filters: appId, kind, briefId, since (ISO timestamp). Pass the returned nextCursor as cursor for the next page. No cost to call.",
         inputSchema: z.object({ appId: z.number().int().optional().describe("Only this product's assets."), kind: z.enum(["voiceover", "sfx", "music", "image", "video", "composite"]).optional(), briefId: z.string().optional(), since: z.string().optional().describe("ISO 8601 timestamp."), limit: z.number().int().min(1).max(100).optional(), cursor: z.string().optional().describe("nextCursor from the previous page.") }).strict(),
     },
+    {
+        name: "creative_voices_search",
+        title: "Search Creative Voices",
+        description: "Search ElevenLabs' voice library for a voice to use in creative_voiceover. Library voices only, never a real person's cloned voice. Returns voiceRef, name, labels, language, accent and previewUrl. No cost to call.",
+        inputSchema: z.object({ query: z.string().optional(), language: z.string().optional().describe("e.g. en, fr, es."), accent: z.string().optional(), gender: z.enum(["male", "female", "neutral"]).optional(), age: z.enum(["young", "middle_aged", "old"]).optional(), useCase: z.enum(["narration", "social_media", "advertisement", "conversational", "characters"]).optional(), limit: z.number().int().min(1).max(20).optional() }).strict(),
+    },
+    {
+        name: "creative_voiceover",
+        title: "Create Voice-over",
+        description: "Voice-over with word timings (for burned-in captions); the text is spoken verbatim, up to 2500 characters. Pass a voiceRef (or voiceId) from creative_voices_search; library voices only, no cloning. quality: final (default) or draft (cheaper, faster). The first call is a free price quote in credits; nothing is charged until you confirm (vendor cost plus markup, never above the quote); nothing is charged until you confirm. Show the user the credits and ask before calling again with confirm: true and the confirmationToken. No real people's likeness or voice, no copyrighted music, logos or characters.",
+        inputSchema: z.object({ appId: z.number().int(), text: z.string().min(1).max(2500), voiceRef: z.object({ publicOwnerId: z.string(), voiceId: z.string() }).strict().optional().describe("A voiceRef from creative_voices_search."), voiceId: z.string().optional(), quality: z.enum(["final", "draft"]).optional(), stability: z.number().min(0).max(1).optional(), style: z.number().min(0).max(1).optional(), speed: z.number().min(0.7).max(1.2).optional(), briefId: z.string().optional(), confirm: z.boolean().optional().describe("Set true only once the user has agreed to the quoted credits."), confirmationToken: z.string().optional().describe("The token the quote returned.") }).strict(),
+    },
+    {
+        name: "creative_sfx",
+        title: "Create Sound Effect",
+        description: "Generate a short sound effect (0.5-10 s) from a description of up to 300 characters; the text is a prompt, not spoken. The first call is a free price quote in credits; nothing is charged until you confirm. Show the user the credits and ask before calling again with confirm: true and the confirmationToken. No real people's likeness or voice, no copyrighted music, logos or characters.",
+        inputSchema: z.object({ appId: z.number().int(), description: z.string().min(1).max(300), durationSeconds: z.number().min(0.5).max(10).optional(), briefId: z.string().optional(), confirm: z.boolean().optional().describe("Set true only once the user has agreed to the quoted credits."), confirmationToken: z.string().optional().describe("The token the quote returned.") }).strict(),
+    },
+    {
+        name: "creative_music",
+        title: "Create Music Bed",
+        description: "Instrumental music bed, 5-60 seconds, as an asynchronous job. Describe mood, tempo and instruments, not artists or songs. May be switched off on this deployment (it then says so and offers stock music). The first call is a free price quote in credits; nothing is charged until you confirm. Show the user the credits and ask before calling again with confirm: true and the confirmationToken, then poll creative_job_status every 10-20 s. No real people's likeness or voice, no copyrighted music, logos or characters.",
+        inputSchema: z.object({ appId: z.number().int(), prompt: z.string().min(1).max(500), durationSeconds: z.number().int().min(5).max(60), briefId: z.string().optional(), confirm: z.boolean().optional().describe("Set true only once the user has agreed to the quoted credits."), confirmationToken: z.string().optional().describe("The token the quote returned.") }).strict(),
+    },
     {
         name: "creative_job_status",
         title: "Creative Job Status",

package/dist/shared/tools.js

@@ -34,7 +34,7 @@ import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 import { DEFAULT_NOOTICR_SETTINGS, DEFAULT_SOCIAL_PLATFORMS, MemorySettingsStore, SETTINGS_READ_TOOL, SETTINGS_UPDATE_TOOL, settingsOwnerFromAuth, } from "./settings.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.61";
+export const MCP_SERVER_VERSION = "1.26.63";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.61",
+  "version": "1.26.63",
   "description": "MCP server for nooticr - fetch, discover and understand TikTok/Instagram/YouTube/X/Reddit/LinkedIn/Weibo posts with AI (media metadata, niche discovery, brand monitoring, hook & viral analysis)",
   "homepage": "https://mcp.nooticr.com",
   "repository": {