@nooticr/mcp 1.26.60 → 1.26.61

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-100 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+102 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
@@ -103,6 +103,8 @@ them caps that fan-out with an argument.
 | `catch_up_watchlist` | 2 per creator | What everyone you watch has posted since your last catch-up. Compares against the snapshot taken last time and moves it forward, so it answers "what is new" rather than "what exists". |
 | `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_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. |
 | `stop_brand_watch` | free | Stop a watch by `watchId` or `term`. Immediate — the next run does not happen and nothing more is charged. |

package/dist/shared/creative.js

@@ -0,0 +1,67 @@
+/**
+ * The free read half of nooticr-server's `creative_*` family (CR1): list the
+ * creative assets generated in the workspace and poll one asynchronous job.
+ * 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.
+ * Neither tool has a view yet: the asset list would be a gallery, which the
+ * design system has no card for.
+ */
+import { z } from "zod";
+import { OUTPUT_SCHEMAS } from "./output-schemas.js";
+function toResult(proxy) {
+    const textBlock = proxy.contentBlocks.find((c) => c.type === "text");
+    const structured = proxy.structured;
+    // The assets and the job's finished outputs are in `structuredContent`; with no
+    // view here the model reads them from the text, so carry the payload in both.
+    const text = structured ? JSON.stringify(structured) : String(textBlock?.text ?? "");
+    return { content: [{ type: "text", text }], structuredContent: structured };
+}
+function failed(prefix, err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: "text", text: `${prefix}: ${msg}` }],
+        isError: true,
+    };
+}
+export const CREATIVE_ASSET_KINDS = ["voiceover", "sfx", "music", "image", "video", "composite"];
+export function registerCreativeTools(server, makeClient) {
+    const passthrough = (name) => async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        try {
+            return toResult(await client.callTool(name, args));
+        }
+        catch (err) {
+            return failed(`${name} failed`, err);
+        }
+    };
+    server.registerTool("creative_assets_list", {
+        title: "List Creative Assets",
+        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.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: z
+            .object({
+            appId: z.number().int().optional().describe("Only this product's assets."),
+            kind: z.enum(CREATIVE_ASSET_KINDS).optional(),
+            briefId: z.string().uuid().optional(),
+            since: z.string().datetime({ offset: true }).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(),
+        outputSchema: OUTPUT_SCHEMAS.creative_assets_list,
+    }, passthrough("creative_assets_list"));
+    server.registerTool("creative_job_status", {
+        title: "Creative Job Status",
+        description: "Status of an asynchronous creative job by jobId: queued, running, done, failed or " +
+            "canceled, with the finished assets and the credits quoted, charged and refunded. Poll " +
+            "after pollAfterSeconds. No cost to call.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        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"));
+}

package/dist/shared/loading-plans.js

@@ -476,6 +476,9 @@ export const LOADING_PLANS = {
     // Managing a schedule is not using it: the sweeps a watch makes are billed
     // as search_mentions when the worker runs them, later and elsewhere.
     create_brand_watch: { label: "Setting up the watch", kind: "text", n: 1, steps: [], free: true },
+    // 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 },
     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

@@ -1254,6 +1254,24 @@ export const OUTPUT_SCHEMAS = {
         billable: scalar(),
         mcpCredits,
     }),
+    // Creative assets (nooticr-server CR1). Assets and jobs are the server's own
+    // shapes, so only the stable fields are named.
+    creative_assets_list: open({
+        assets: listOf(open({ id: scalar(), kind: scalar(), appId: scalar(), url: scalar(), mime: scalar(), createdAt: scalar() })),
+        nextCursor: scalar(),
+    }),
+    creative_job_status: open({
+        jobId: scalar(),
+        tool: scalar(),
+        status: scalar(),
+        assetIds: listOf(oneType(z.string())),
+        assets: listOf(open({ id: scalar(), kind: scalar(), url: scalar() })),
+        creditsQuoted: scalar(),
+        creditsCharged: scalar(),
+        creditsRefunded: scalar(),
+        pollAfterSeconds: scalar(),
+        error: scalar(),
+    }),
     list_brand_watches: open({
         watches: listOf(open({
             watchId: scalar(),

package/dist/shared/tools-def.js

@@ -264,6 +264,18 @@ export const TOOL_DEFINITIONS = [
         description: "Run a sweep on a schedule and email what is new, instead of remembering to ask. kind: \"mentions\" (default) sweeps term across platforms; kind: \"competitor\" sweeps one creator's own posts (handle + platform) and reports only what beats their own recent median; kind: \"report\" runs job {tool, args} (niche_report or discover_social_posts) on the schedule at that tool's own price; kind: \"portfolio\" sweeps several terms across the same platforms under one budget and mails one digest with each term's share of voice. Two calls by design: call it once with no confirmation to get back the cost per run and what it multiplies out to per day, then call it again with confirm: true and the confirmationToken to actually start it. The first call creates nothing and spends nothing. Bills 2 credits per network per run (5 for Xiaohongshu) for a mentions watch, or a flat 2 credits for a competitor watch, trimmed to fit budgetCredits. A run that finds nothing new (or, for a competitor watch, nothing above median) sends no mail. No cost to call.",
         inputSchema: z.object({ kind: z.enum(["mentions", "competitor", "report", "portfolio"]).optional().describe("\"mentions\" (default), \"competitor\", \"report\" or \"portfolio\"."), job: z.object({ tool: z.enum(["niche_report", "discover_social_posts"]), args: z.object({}).passthrough() }).optional().describe("kind: report only — the job each run performs."), terms: z.array(z.string()).optional().describe("kind: portfolio only — the terms to compare (1-25)."), term: z.string().optional().describe("kind: mentions only — what to watch for (max 120 chars)."), platforms: z.array(z.string()).optional().describe("kind: mentions only — networks to sweep (default: every searchable network)."), handle: z.string().optional().describe("kind: competitor only — the creator's handle."), platform: z.string().optional().describe("kind: competitor only — the platform that creator posts on."), cadence: z.enum(["hourly", "every_6_hours", "every_12_hours", "daily", "weekly"]).optional().describe("How often to run (default daily)."), budgetCredits: z.number().int().optional().describe("Hard per-run credit ceiling (default the full sweep's cost)."), deliverTo: z.string().optional().describe("Digest email (default the account's own)."), confirm: z.boolean().optional().describe("Set true only once the user has agreed to the quoted cost."), confirmationToken: z.string().optional().describe("The token the first call returned.") }).strict(),
     },
+    {
+        name: "creative_assets_list",
+        title: "List Creative Assets",
+        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_job_status",
+        title: "Creative Job Status",
+        description: "Status of an asynchronous creative job by jobId: queued, running, done, failed or canceled, with the finished assets and the credits quoted, charged and refunded. Poll after pollAfterSeconds. No cost to call.",
+        inputSchema: z.object({ jobId: z.string().describe("jobId returned when the job was started.") }).strict(),
+    },
     {
         name: "list_brand_watches",
         title: "List Brand Watches",

package/dist/shared/tools.js

@@ -21,6 +21,7 @@ import { confirmSpend, declinedResult, searchMentionsCost, SEARCH_PLATFORMS, DIS
 import { BackendWatchStore, MemoryWatchStore, registerWatchlist, } from "./watchlist.js";
 import { registerJobTools } from "./jobs.js";
 import { registerBrandWatch } from "./brand-watch.js";
+import { registerCreativeTools } from "./creative.js";
 import { registerOwnAccountTools } from "./own-account.js";
 import { registerConnectionTools } from "./connections.js";
 import { registerEmployeeTools } from "./employees.js";
@@ -33,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.60";
+export const MCP_SERVER_VERSION = "1.26.61";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -2887,6 +2888,8 @@ export function createMcpServer(rawMakeClient, opts) {
     registerJobTools(server, makeClient, watchStore);
     registerBrandWatch(server, makeClient);
     registerOwnAccountTools(server, makeClient);
+    // Creative assets (creative.ts): the free reads of nooticr-server's creative_* family.
+    registerCreativeTools(server, makeClient);
     registerConnectionTools(server, makeClient);
     // AI employees (employees.ts): hire, list, pause, fire, and approve or reject what they queue.
     registerEmployeeTools(server, makeClient);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.60",
+  "version": "1.26.61",
   "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": {