@nooticr/mcp 1.26.55 → 1.26.56

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-88 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+90 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
@@ -173,6 +173,8 @@ a `scanId` for the rest.
 |------|---------|----------------|
 | `nooticr_getting_started` | free | **Start here.** Where this account stands — balance, connected accounts, watchlist — and the next calls worth making, each with its price and an example. The server's `instructions` point every host at it. |
 | `check_nooticr_credits` | free | Balance and billing URL. |
+| `nooticr_settings_read` | free | Read your default social platform and result count. |
+| `nooticr_settings_update` | free | Save the default platform and result count used by supported searches when arguments are omitted. |
 | `list_tool_runs` | free | Your tool-call history: what ran, whether it worked, and the credits each call actually took (0 for a free, refunded, cached or replayed call). `scope: "workspace"` shows every member's runs to owners and admins. |
 | `get_tool_run` | free | One run from that history by id, with its full error. |
 | `get_usage_report` | free | The run ledger added up over a window: total calls, failures and credits actually taken, per tool, per day and the most recent failures. `scope: "workspace"` adds one row per seat, for the workspace's owners and admins. |

package/dist/shared/loading-plans.js

@@ -67,6 +67,8 @@ const CREATOR_UNIT = {
  * generic grey box that said "Working".
  */
 export const LOADING_PLANS = {
+    nooticr_settings_read: { label: "Reading your research defaults", kind: "text", n: 0, steps: [], free: true },
+    nooticr_settings_update: { label: "Saving your research defaults", kind: "text", n: 0, steps: [], free: true },
     // ─── Read a post ───
     get_social_media: { label: "Fetching the post", kind: "post", n: 1, steps: [step("get_social_media")] },
     get_post_transcript: {

package/dist/shared/settings.js

@@ -0,0 +1,69 @@
+export const SETTINGS_READ_TOOL = "nooticr_settings_read";
+export const SETTINGS_UPDATE_TOOL = "nooticr_settings_update";
+export const DEFAULT_SOCIAL_PLATFORMS = [
+    "tiktok",
+    "instagram",
+    "youtube",
+    "twitter",
+    "reddit",
+    "douyin",
+    "xiaohongshu",
+    "weibo",
+    "bilibili",
+];
+export const DEFAULT_NOOTICR_SETTINGS = {
+    defaultSocialPlatform: "tiktok",
+    // Keep existing tool behaviour until the user chooses another count.
+    defaultResultCount: 12,
+};
+export class MemorySettingsStore {
+    values = new Map();
+    async get(owner) {
+        const value = this.values.get(owner);
+        return value ? { ...value } : undefined;
+    }
+    async put(owner, value) {
+        this.values.set(owner, { ...value });
+    }
+}
+/** Durable account-scoped preferences for the Cloudflare-hosted MCP server. */
+export class KvSettingsStore {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    key(owner) {
+        return `plugin-settings:${owner}`;
+    }
+    async get(owner) {
+        const raw = await this.kv.get(this.key(owner));
+        if (!raw)
+            return undefined;
+        try {
+            const parsed = JSON.parse(raw);
+            const platform = DEFAULT_SOCIAL_PLATFORMS.find((candidate) => candidate === parsed.defaultSocialPlatform);
+            const count = parsed.defaultResultCount;
+            if (!platform || !Number.isInteger(count) || count < 3 || count > 12)
+                return undefined;
+            return { defaultSocialPlatform: platform, defaultResultCount: count };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async put(owner, value) {
+        await this.kv.put(this.key(owner), JSON.stringify(value));
+    }
+}
+/** Stable owner keys prefer the authenticated Nooticr account ID. */
+export async function settingsOwnerFromAuth(authInfo, resolveAccountId) {
+    const token = authInfo?.token ?? "";
+    const accountId = token && resolveAccountId ? await resolveAccountId(token) : undefined;
+    if (accountId)
+        return `account:${accountId}`;
+    if (!token)
+        return "local";
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(token));
+    const hex = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
+    return `credential:${hex}`;
+}

package/dist/shared/tools-def.js

@@ -528,4 +528,16 @@ export const TOOL_DEFINITIONS = [
         description: "Display the category read you produced from scan_marketplace_category: purchase drivers, barriers, what each brand does well, the gaps, and the positioning angles \u2014 drawn beside the listings and their reviews, so a person can click a product and check any claim against the text it came from. Pass the scanId: the listings are then re-read from the scan itself (free) rather than taken from you, and any ASIN you cite that the scan does not contain is flagged. Without a scanId, listings you pass are drawn marked as not checked against a scan. Free. Your read is attributed to you rather than presented as a nooticr rating of anyone's product. Call this after you have read the reviews, not instead of reading them.",
         inputSchema: z.object({ marketplace: z.string().describe("The site the scan ran on, e.g. lazada."), category: z.string().describe("The category this is a read of."), summary: z.string().optional(), drivers: z.array(z.any()).optional().describe("What makes someone buy, each with the review evidence behind it."), barriers: z.array(z.any()).optional().describe("What stops them buying, or makes them return it."), strengths: z.array(z.any()).optional().describe("What each incumbent does well."), gaps: z.array(z.any()).optional().describe("What buyers keep asking for that nobody serves."), positioning: z.array(z.any()).optional().describe("Angles a new entrant could take."), products: z.array(z.any()).optional().describe("The listings from the scan, passed straight through."), rollup: z.record(z.unknown()).optional().describe("The rollup from the scan, passed straight through."), scanId: z.string().optional() }).passthrough(),
     },
+    {
+        name: "nooticr_settings_read",
+        title: "Read Nooticr Settings",
+        description: "Read the current default social platform and result count for this Nooticr account. Free; no credits are used.",
+        inputSchema: z.object({}).strict(),
+    },
+    {
+        name: "nooticr_settings_update",
+        title: "Update Nooticr Settings",
+        description: "Save changed default social platform or result count preferences for this Nooticr account. Free; no credits are used.",
+        inputSchema: z.object({ set: z.object({ defaultSocialPlatform: z.enum(["tiktok", "instagram", "youtube", "twitter", "reddit", "douyin", "xiaohongshu", "weibo", "bilibili"]).optional(), defaultResultCount: z.number().int().min(3).max(12).optional() }).strict() }).strict(),
+    },
 ];

package/dist/shared/tools.js

@@ -29,8 +29,9 @@ import { registerHandoff } from "./handoff.js";
 import { registerCollabTools } from "./collab.js";
 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.55";
+export const MCP_SERVER_VERSION = "1.26.56";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -559,6 +560,10 @@ export function createMcpServer(rawMakeClient, opts) {
             prompts: {},
             extensions: {
                 [UI_EXTENSION]: { mimeTypes: [RESOURCE_MIME_TYPE] },
+                "openai/settings": {
+                    readTool: SETTINGS_READ_TOOL,
+                    updateTool: SETTINGS_UPDATE_TOOL,
+                },
             },
         },
     });
@@ -567,13 +572,110 @@ export function createMcpServer(rawMakeClient, opts) {
     // model's copy of it (#107). Wrapped once here rather than in eighty
     // handlers; registerSlowTool records the task path the same way.
     const ledger = ledgerFor(server);
+    const settingsStore = opts?.settingsStore ?? new MemorySettingsStore();
+    const settingsForCall = async (extra) => {
+        const owner = opts?.resolveSettingsOwner
+            ? await opts.resolveSettingsOwner(extra?.authInfo)
+            : await settingsOwnerFromAuth(extra?.authInfo);
+        return { owner, settings: (await settingsStore.get(owner)) ?? DEFAULT_NOOTICR_SETTINGS };
+    };
+    // Only apply defaults to search/research tools where these settings describe
+    // the omitted arguments. Explicit values always win; cost-bearing deeper
+    // reads such as comment counts and monitor sweeps are deliberately excluded.
+    const platformDefaults = {
+        discover_social_posts: DEFAULT_SOCIAL_PLATFORMS,
+        get_user_posts: DEFAULT_SOCIAL_PLATFORMS,
+        analyze_creator_profile: DEFAULT_SOCIAL_PLATFORMS,
+        search_creators: ["tiktok", "instagram", "xiaohongshu"],
+        get_similar_creators: ["tiktok", "instagram"],
+        discover_sounds: ["tiktok", "instagram"],
+        niche_report: DEFAULT_SOCIAL_PLATFORMS,
+        find_hook_pattern: DEFAULT_SOCIAL_PLATFORMS,
+    };
+    const resultCountFields = {
+        discover_social_posts: "limit",
+        get_user_posts: "limit",
+        analyze_creator_profile: "limit",
+        search_creators: "count",
+        discover_sounds: "count",
+        niche_report: "count",
+        find_hook_pattern: "limit",
+    };
     const registerTool = server.registerTool.bind(server);
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     server.registerTool = (name, config, handler) => registerTool(name, config, async (...a) => {
-        const result = (await handler(...a));
+        const [rawArgs, rawExtra, ...rest] = a;
+        let callArgs = a;
+        if (rawArgs &&
+            typeof rawArgs === "object" &&
+            !Array.isArray(rawArgs) &&
+            (platformDefaults[name] || resultCountFields[name])) {
+            const args = { ...rawArgs };
+            const extra = rawExtra;
+            try {
+                const { settings } = await settingsForCall(extra);
+                const allowed = platformDefaults[name];
+                if (allowed && args.platform === undefined && allowed.includes(settings.defaultSocialPlatform)) {
+                    args.platform = settings.defaultSocialPlatform;
+                }
+                const resultField = resultCountFields[name];
+                if (resultField && args[resultField] === undefined)
+                    args[resultField] = settings.defaultResultCount;
+                callArgs = [args, rawExtra, ...rest];
+            }
+            catch (err) {
+                if (name === SETTINGS_READ_TOOL || name === SETTINGS_UPDATE_TOOL)
+                    throw err;
+                // A preferences-store outage must not take down ordinary MCP tools.
+            }
+        }
+        const result = (await handler(...callArgs));
+        // Login recovery promises to retry what the caller originally supplied.
+        // The settings layer's effective defaults belong to this attempt only.
+        if (result?.isError && pendingAfterLogin?.name === name && rawArgs && typeof rawArgs === "object") {
+            pendingAfterLogin = { name, args: rawArgs };
+        }
         ledger.record(name, result?.structuredContent);
         return result;
     });
+    const settingsSchema = {
+        type: "object",
+        properties: {
+            defaultSocialPlatform: {
+                type: "string",
+                title: "Default social platform",
+                description: "Used when a supported social search omits its platform. Explicit tool arguments take precedence.",
+                enum: [...DEFAULT_SOCIAL_PLATFORMS],
+            },
+            defaultResultCount: {
+                type: "integer",
+                title: "Default result count",
+                description: "Used when supported search tools omit their result limit. Choose 3–12 results.",
+                minimum: 3,
+                maximum: 12,
+            },
+        },
+        required: ["defaultSocialPlatform", "defaultResultCount"],
+    };
+    const settingPropertySchema = z.object({
+        type: z.enum(["string", "integer"]),
+        title: z.string(),
+        description: z.string(),
+        enum: z.array(z.string()).optional(),
+        minimum: z.number().optional(),
+        maximum: z.number().optional(),
+    }).strict();
+    const settingsOutput = z.object({
+        schema: z.object({
+            type: z.literal("object"),
+            properties: z.object({
+                defaultSocialPlatform: settingPropertySchema,
+                defaultResultCount: settingPropertySchema,
+            }).strict(),
+            required: z.array(z.string()),
+        }).strict(),
+        values: z.object({ defaultSocialPlatform: z.string(), defaultResultCount: z.number().int() }),
+    });
     // Register one UI app resource per tool/view. Claude/ChatGPT render a
     // separate sandboxed app per resourceUri and key app state by it, so a
     // distinct URI per tool avoids a shared app instance/session colliding
@@ -984,12 +1086,12 @@ export function createMcpServer(rawMakeClient, opts) {
             .object({
             niche: z.string().describe("Niche/topic, e.g. 'fitness'."),
             keywords: z.string().optional().describe("Optional extra keywords."),
-            limit: z.number().int().optional().describe("Max results (default 6)."),
+            limit: z.number().int().optional().describe("Max results (default 6, or your Settings result count when omitted)."),
             offset: z.number().int().optional().describe("Skip first N results — for 'next' pagination."),
             platform: z
                 .enum(["youtube", "tiktok", "instagram", "douyin", "xiaohongshu", "twitter", "bilibili", "reddit", "weibo", "any"])
                 .optional()
-                .describe("Platform to search (default youtube)."),
+                .describe("Platform to search (your Settings default when omitted; otherwise youtube)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -1024,8 +1126,8 @@ export function createMcpServer(rawMakeClient, opts) {
             platform: z
                 .enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili", "linkedin", "reddit", "weibo"])
                 .optional()
-                .describe("Which platform (default tiktok)."),
-            limit: z.number().int().optional().describe("Max posts (default 6)."),
+                .describe("Which platform (your Settings default when supported, otherwise tiktok)."),
+            limit: z.number().int().optional().describe("Max posts (default 6, or your Settings result count when omitted)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -1064,7 +1166,7 @@ export function createMcpServer(rawMakeClient, opts) {
             platform: z
                 .enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili", "linkedin", "reddit", "weibo"])
                 .optional()
-                .describe("Which platform (default tiktok)."),
+                .describe("Which platform (your Settings default when supported, otherwise tiktok)."),
             limit: z.number().int().optional().describe("Posts to fetch (default 12, max 30)."),
             focus: z.string().optional().describe("Extra instruction for the profile synthesis."),
         })
@@ -1139,8 +1241,8 @@ export function createMcpServer(rawMakeClient, opts) {
                 // fields at all, so advertising them only spends a paid call to fail.
                 .enum(["tiktok", "instagram", "xiaohongshu"])
                 .optional()
-                .describe("Which platform (default tiktok)."),
-            count: z.number().int().optional().describe("Max creators (default 8)."),
+                .describe("Which platform (your Settings default when supported, otherwise tiktok)."),
+            count: z.number().int().optional().describe("Max creators (default 8, or your Settings result count when omitted)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -1244,8 +1346,8 @@ export function createMcpServer(rawMakeClient, opts) {
         inputSchema: z
             .object({
             keyword: z.string().describe("Niche/keyword, e.g. 'gym'."),
-            platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok)."),
-            count: z.number().int().optional().describe("Max sounds (default 6)."),
+            platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (your Settings default when supported, otherwise tiktok)."),
+            count: z.number().int().optional().describe("Max sounds (default 6, or your Settings result count when omitted)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -2374,7 +2476,7 @@ export function createMcpServer(rawMakeClient, opts) {
             .object({
             niche: z.string().describe("Niche or topic, e.g. 'home fitness'."),
             platform: z.string().optional().describe("Platform to survey (default tiktok)."),
-            count: z.number().int().optional().describe("Posts to survey (default 12, max 40)."),
+            count: z.number().int().optional().describe("Posts to survey (default 12, or your Settings result count when omitted; max 40)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -2406,7 +2508,7 @@ export function createMcpServer(rawMakeClient, opts) {
             .object({
             username: z.string().describe("Creator handle, with or without @."),
             platform: z.string().optional().describe("Platform (default tiktok)."),
-            limit: z.number().int().optional().describe("Posts to read (default 12, max 40)."),
+            limit: z.number().int().optional().describe("Posts to read (default 12, or your Settings result count when omitted; max 40)."),
         })
             .strict(),
     }, async (args, extra) => {
@@ -2798,5 +2900,41 @@ export function createMcpServer(rawMakeClient, opts) {
     // and the generic one cannot, so the two descriptions are not the same
     // promise — not because the question differs.
     registerMarketplaceTools(server, makeClient);
+    // Register the settings controls after the existing tool surface so adding
+    // them does not reorder tools that hosts already know about. These settings
+    // tools have no app view; the host renders them in its native settings UI.
+    server.registerTool(SETTINGS_READ_TOOL, {
+        title: "Read Nooticr Settings",
+        description: "Read the current default social platform and result count for this Nooticr account. Free; no credits are used.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: z.object({}).strict(),
+        outputSchema: settingsOutput,
+    }, async (_args, extra) => {
+        const { settings } = await settingsForCall(extra);
+        return {
+            content: [],
+            structuredContent: {
+                schema: settingsSchema,
+                values: settings,
+            },
+        };
+    });
+    server.registerTool(SETTINGS_UPDATE_TOOL, {
+        title: "Update Nooticr Settings",
+        description: "Save changed Nooticr research defaults for this account. Free; no credits are used.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: z.object({
+            set: z.object({
+                defaultSocialPlatform: z.enum(DEFAULT_SOCIAL_PLATFORMS).optional(),
+                defaultResultCount: z.number().int().min(3).max(12).optional(),
+            }).strict().refine((set) => Object.keys(set).length > 0, "At least one setting must change."),
+        }).strict(),
+        outputSchema: z.object({ values: settingsOutput.shape.values }),
+    }, async ({ set }, extra) => {
+        const { owner, settings } = await settingsForCall(extra);
+        const updated = { ...settings, ...set };
+        await settingsStore.put(owner, updated);
+        return { content: [], structuredContent: { values: updated } };
+    });
     return server;
 }

package/package.json

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