@nooticr/mcp 1.26.62 → 1.26.64

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-106 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+108 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
@@ -108,6 +108,8 @@ them caps that fan-out with an argument.
 | `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_image` | quoted first | 1-4 still images from a `prompt` with GPT Image (low quality), at a `size` (default portrait 1024x1536), optionally `transparent`. 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. Returns the new `assets` and `creativeCredits`. Keep long text out of the prompt and ask for invented people, not real ones. |
+| `creative_image_edit` | quoted first | Edit or combine 1-4 existing image assets (`imageAssetIds`) with a `prompt`, with an optional `maskAssetId`. Same quote-then-confirm handshake as `creative_image`; returns a new asset and `creativeCredits`. |
 | `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,10 +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 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.
+ * The paid creative tools register here when they ship. The ElevenLabs half (CR2):
+ * `creative_voices_search` is free; `creative_voiceover`, `creative_sfx` and `creative_music` are paid.
+ * `creative_image` and `creative_image_edit` (CR3) are paid. All paid tools use the server's
+ * quote-then-confirm handshake. `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.
  */
@@ -66,6 +66,10 @@ 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 imageSize = z
+        .enum(["1024x1536", "1024x1024", "1536x1024", "1088x1920", "1088x1360"])
+        .optional()
+        .describe("Default 1024x1536 (portrait).");
     const voiceRef = z
         .object({ publicOwnerId: z.string(), voiceId: z.string() })
         .strict()
@@ -77,6 +81,48 @@ export function registerCreativeTools(server, makeClient) {
     };
     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_image", {
+        title: "Create Images",
+        description: "Generate 1-4 still images with GPT Image (low quality, fast and cheap) and store them as " +
+            "creative assets. The prompt is up to 4000 characters; do not put long text in it (put " +
+            "long text in a caption overlay) and do not ask for real named people. 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 the same arguments plus confirm: true and the " +
+            "confirmationToken. Settles to the real usage, never above the quote. Returns assets and " +
+            "creativeCredits.",
+        annotations: paidAnnotations,
+        inputSchema: z
+            .object({
+            appId: z.number().int(),
+            prompt: z.string().min(1).max(4000),
+            size: imageSize,
+            n: z.number().int().min(1).max(4).optional(),
+            transparent: z.boolean().optional(),
+            ...handshake,
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_image,
+    }, passthrough("creative_image"));
+    server.registerTool("creative_image_edit", {
+        title: "Edit Images",
+        description: "Edit or combine 1-4 existing creative image assets (imageAssetIds, from creative_assets_list " +
+            "or a previous creative_image) with GPT Image (low quality), with an optional maskAssetId, and " +
+            "store the result as a new asset. 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. Returns assets and creativeCredits.",
+        annotations: paidAnnotations,
+        inputSchema: z
+            .object({
+            appId: z.number().int(),
+            prompt: z.string().min(1).max(4000),
+            imageAssetIds: z.array(z.string()).min(1).max(4),
+            maskAssetId: z.string().optional(),
+            size: imageSize,
+            ...handshake,
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.creative_image_edit,
+    }, passthrough("creative_image_edit"));
     server.registerTool("creative_voices_search", {
         title: "Search Creative Voices",
         description: "Search ElevenLabs' voice library for a voice to use in creative_voiceover. Library voices " +

package/dist/shared/loading-plans.js

@@ -484,6 +484,9 @@ export const LOADING_PLANS = {
     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: [] },
+    // Paid, but the first call only quotes; the charge waits for the confirmed second call.
+    creative_image: { label: "Quoting the images", kind: "text", n: 1, steps: [] },
+    creative_image_edit: { label: "Quoting the image edit", 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

@@ -1265,23 +1265,55 @@ export const OUTPUT_SCHEMAS = {
     }),
     // The paid tools answer a quote first, then the generated assets (or a job for music).
     creative_voiceover: open({
-        requiresConfirmation: scalar().describe("true on the first call: nothing was generated or charged yet."),
+        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."),
-        creditsQuoted: scalar(),
-        assets: listOf(open({ id: scalar(), kind: scalar(), url: scalar() })),
+        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({
-        requiresConfirmation: scalar().describe("true on the first call: nothing was generated or charged yet."),
+        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."),
-        creditsQuoted: scalar(),
-        assets: listOf(open({ id: scalar(), kind: scalar(), url: scalar() })),
+        expiresAt: scalar(),
+        next: scalar(),
+        assetId: scalar(),
+        url: scalar(),
+        key: scalar(),
+        durationMs: scalar(),
+        creativeCredits: open({}).nullish(),
     }),
     creative_music: open({
-        requiresConfirmation: scalar().describe("true on the first call: nothing was generated or charged yet."),
+        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."),
-        creditsQuoted: scalar(),
+        expiresAt: scalar(),
+        next: scalar(),
         jobId: scalar().describe("Poll creative_job_status with this."),
-        pollAfterSeconds: scalar(),
+        status: scalar(),
+        creativeCredits: open({}).nullish(),
+        refused: scalar().describe("not_enabled when music generation is switched off for this account."),
+        alternative: scalar(),
+    }),
+    // The paid image tools answer a quote first (`quote`, a token, an expiry), then the generated assets
+    // with the credits settled. Keys are the server's (crates/server/src/creative/billing.rs, tools.rs).
+    creative_image: open({
+        quote: open({ credits: scalar() }).nullish(),
+        confirmationToken: scalar().describe("Pass this back with confirm: true to generate."),
+        expiresAt: scalar(),
+        assets: listOf(open({ assetId: scalar(), url: scalar(), key: scalar(), width: scalar(), height: scalar() })),
+        creativeCredits: open({ charged: scalar(), refunded: scalar(), quoted: scalar(), balance: scalar() }).nullish(),
+    }),
+    creative_image_edit: open({
+        quote: open({ credits: scalar() }).nullish(),
+        confirmationToken: scalar().describe("Pass this back with confirm: true to generate."),
+        expiresAt: scalar(),
+        assets: listOf(open({ assetId: scalar(), url: scalar(), key: scalar(), width: scalar(), height: scalar() })),
+        creativeCredits: open({ charged: scalar(), refunded: scalar(), quoted: scalar(), balance: scalar() }).nullish(),
     }),
     creative_job_status: open({
         jobId: scalar(),

package/dist/shared/tools-def.js

@@ -294,6 +294,18 @@ export const TOOL_DEFINITIONS = [
         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_image",
+        title: "Create Images",
+        description: "Generate 1-4 still images with GPT Image (low quality, fast and cheap) and store them as creative assets. The prompt is up to 4000 characters; do not put long text in it (put long text in a caption overlay) and do not ask for real named people. 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 the same arguments plus confirm: true and the confirmationToken. Settles to the real usage, never above the quote. Returns assets and creativeCredits.",
+        inputSchema: z.object({ appId: z.number().int(), prompt: z.string().min(1).max(4000), size: z.enum(["1024x1536", "1024x1024", "1536x1024", "1088x1920", "1088x1360"]).optional().describe("Default 1024x1536 (portrait)."), n: z.number().int().min(1).max(4).optional(), transparent: z.boolean().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_image_edit",
+        title: "Edit Images",
+        description: "Edit or combine 1-4 existing creative image assets (imageAssetIds, from creative_assets_list or a previous creative_image) with GPT Image (low quality), with an optional maskAssetId, and store the result as a new asset. 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. Returns assets and creativeCredits.",
+        inputSchema: z.object({ appId: z.number().int(), prompt: z.string().min(1).max(4000), imageAssetIds: z.array(z.string()).min(1).max(4), maskAssetId: z.string().optional(), size: z.enum(["1024x1536", "1024x1024", "1536x1024", "1088x1920", "1088x1360"]).optional().describe("Default 1024x1536 (portrait)."), 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.62";
+export const MCP_SERVER_VERSION = "1.26.64";
 /** 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.62",
+  "version": "1.26.64",
   "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": {