@nooticr/mcp 1.26.65 → 1.26.67

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-108 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+114 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
@@ -111,6 +111,12 @@ them caps that fan-out with an argument.
 | `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`. |
+| `sheets_create` | free | Create a Google spreadsheet in the connected Google account, with named tabs and a header row on each. Returns its id and URL; Nooticr owns the file, so later writes need no approval. Needs the product's Google Sheets connection. |
+| `sheets_list` | free | The spreadsheets the connection can see (created by Nooticr or picked by the customer) and whether each may be edited without approval. |
+| `sheets_read` | free | Read an A1 range (e.g. `Ledger!A1:F200`) of a spreadsheet; at most 10000 cells. |
+| `sheets_append_rows` | free | Append typed rows after the last row of a tab. Free on files Nooticr created or the customer allowed you to edit; any other picked file waits for approval. |
+| `sheets_update_range` | free | Overwrite an A1 range with typed values. Same approval rule as `sheets_append_rows`. |
+| `sheets_add_sheet` | free | Add an empty tab to a spreadsheet. Same approval rule as `sheets_append_rows`. |
 | `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/employees.js

@@ -45,8 +45,8 @@ export function registerEmployeeTools(server, makeClient) {
     server.registerTool("hire_employee", {
         title: "Hire Employee",
         description: "Hire an AI employee (for example a Social Media Manager) that works on a schedule inside " +
-            "this workspace. Pass `template` and optionally name, instructions, appId, schedule, " +
-            "monthlyBudgetCredits, maxCreditsPerRun, approvalPolicy and notify. " +
+            "this workspace. Pass `template` and optionally name, instructions, products (the string all, or a list of product ids; appId is deprecated), schedule, " +
+            "monthlyBudgetCredits, maxCreditsPerRun, approvalPolicy and notify (channels, and recipients: hirer, admins or member user ids). " +
             TWO_STEP_RULE +
             " Public actions (publish, email, reply, listing or price changes) wait for the user's " +
             "approval unless autopilot is turned on. The hiring user is billed for runs, up to the " +
@@ -57,7 +57,11 @@ export function registerEmployeeTools(server, makeClient) {
             template: z.string().describe("Template slug, e.g. social-media-manager."),
             name: z.string().optional().describe("What to call the employee."),
             instructions: z.string().optional().describe("Standing instructions from the customer (tone, topics to avoid, ...)."),
-            appId: z.number().int().optional().describe("Focus product id."),
+            appId: z.number().int().optional().describe("Deprecated: same as products:[appId]. Do not send together with products."),
+            products: z
+                .union([z.literal("all"), z.array(z.number().int()).min(1)])
+                .optional()
+                .describe('"all" (every product, including ones added later) or a list of product ids the employee covers.'),
             schedule: z
                 .object({}).passthrough()
                 .optional()
@@ -65,7 +69,7 @@ export function registerEmployeeTools(server, makeClient) {
             monthlyBudgetCredits: z.number().int().min(1).optional(),
             maxCreditsPerRun: z.number().int().min(1).optional(),
             approvalPolicy: z.object({}).passthrough().optional().describe("Action type -> 'approval' | 'auto'."),
-            notify: z.object({}).passthrough().optional().describe("{channels:['email'|'slack']}."),
+            notify: z.object({}).passthrough().optional().describe("{channels:['email'|'slack'], recipients?:'hirer'|'admins'|[member user ids, max 25]}."),
             model: z.string().optional().describe("Optional model."),
             effort: z.string().optional().describe("low | medium | high."),
             confirm,

package/dist/shared/loading-plans.js

@@ -487,6 +487,13 @@ export const LOADING_PLANS = {
     // 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: [] },
+    // Google Sheets (sheets.ts): reads are free; writes are free too (approval waits on the server side).
+    sheets_create: { label: "Creating the spreadsheet", kind: "text", n: 1, steps: [], free: true },
+    sheets_list: { label: "Listing your spreadsheets", kind: "list", n: 3, steps: [], free: true },
+    sheets_read: { label: "Reading the spreadsheet", kind: "text", n: 1, steps: [], free: true },
+    sheets_append_rows: { label: "Adding rows to the spreadsheet", kind: "text", n: 1, steps: [], free: true },
+    sheets_update_range: { label: "Updating the spreadsheet", kind: "text", n: 1, steps: [], free: true },
+    sheets_add_sheet: { label: "Adding a tab to the spreadsheet", 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

@@ -1327,6 +1327,13 @@ export const OUTPUT_SCHEMAS = {
         pollAfterSeconds: scalar(),
         error: scalar(),
     }),
+    // Google Sheets (nooticr-server BK2, sheets.ts): the server's own shapes, only stable keys named.
+    sheets_create: open({ id: scalar(), url: scalar(), title: scalar(), sheets: listOf(oneType(z.string())), owner: scalar() }),
+    sheets_list: open({ files: listOf(open({ id: scalar(), title: scalar(), url: scalar() })) }),
+    sheets_read: open({}),
+    sheets_append_rows: open({ id: scalar(), sheet: scalar(), rowsAppended: scalar(), cells: scalar(), updatedRange: scalar() }),
+    sheets_update_range: open({ id: scalar(), updatedRange: scalar(), updatedCells: scalar(), cells: scalar() }),
+    sheets_add_sheet: open({ id: scalar(), sheetId: scalar(), name: scalar() }),
     list_brand_watches: open({
         watches: listOf(open({
             watchId: scalar(),

package/dist/shared/sheets.js

@@ -0,0 +1,100 @@
+/**
+ * nooticr-server's `sheets_*` family (BK2, Google Sheets): create, list, read
+ * and write spreadsheets in the customer's connected Google account. Plain
+ * passthroughs to the server's `POST /mcp` dispatch, which owns the Google
+ * connection, the approval rule for files the customer picked, and the
+ * 10000-cell limit. Argument names match the server's schema exactly.
+ */
+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;
+    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,
+    };
+}
+const appId = z.number().int().optional().describe("Product id; optional when the workspace has one product.");
+const spreadsheetId = z.string().describe("Spreadsheet id from sheets_create or sheets_list.");
+const cell = z
+    .union([z.number(), z.boolean(), z.string(), z.null(), z.object({ formula: z.string() }).strict()])
+    .describe("A number, boolean, text or an ISO date (2026-01-31) or datetime; null leaves the cell empty. " +
+    'Text that looks like a formula or number stays text; use {"formula": "=SUM(A1:A3)"} for a formula.');
+const rows = z.array(z.array(cell));
+const READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+const WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
+export function registerSheetsTools(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("sheets_create", {
+        title: "Create Spreadsheet",
+        description: "Create a Google spreadsheet in the connected Google account, with the named sheets and a header row on each. " +
+            "Returns its id and URL; Nooticr owns the file, so later writes need no approval. " +
+            "Requires the product's Google Sheets connection. Free.",
+        annotations: WRITE,
+        inputSchema: z
+            .object({
+            appId,
+            title: z.string(),
+            sheets: z
+                .array(z.object({ name: z.string(), headers: z.array(z.string()).optional() }))
+                .optional()
+                .describe("Tabs to create."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_create,
+    }, passthrough("sheets_create"));
+    server.registerTool("sheets_list", {
+        title: "List Spreadsheets",
+        description: "List the spreadsheets this connection can see: the ones Nooticr created and the ones the customer picked. " +
+            "Each says whether it was created or picked and whether the employee may edit it without approval. Free.",
+        annotations: READ,
+        inputSchema: z.object({ appId, limit: z.number().int().min(1).max(100).optional() }).strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_list,
+    }, passthrough("sheets_list"));
+    server.registerTool("sheets_read", {
+        title: "Read Spreadsheet Range",
+        description: 'Read a range (A1 notation, e.g. "Ledger!A1:F200") of a spreadsheet. ' +
+            "Numbers come back as numbers and dates as formatted text; at most 10000 cells. Free.",
+        annotations: READ,
+        inputSchema: z.object({ appId, id: spreadsheetId, range: z.string() }).strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_read,
+    }, passthrough("sheets_read"));
+    server.registerTool("sheets_append_rows", {
+        title: "Append Spreadsheet Rows",
+        description: "Append rows after the last row of a sheet (tab). Values are typed: numbers stay numbers and ISO dates become sheet dates. " +
+            "At most 10000 cells per call. Free on a file Nooticr created or one the customer allowed you to edit; " +
+            "on any other file the customer picked it waits for their approval.",
+        annotations: WRITE,
+        inputSchema: z.object({ appId, id: spreadsheetId, sheet: z.string().describe("Tab name."), rows }).strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_append_rows,
+    }, passthrough("sheets_append_rows"));
+    server.registerTool("sheets_update_range", {
+        title: "Update Spreadsheet Range",
+        description: 'Overwrite a range (A1 notation, e.g. "Ledger!B2:C3") with values. Typed like sheets_append_rows; ' +
+            "at most 10000 cells per call. Same approval rule as sheets_append_rows: free on a file Nooticr created or one the customer allowed you to edit, otherwise it waits for their approval.",
+        annotations: WRITE,
+        inputSchema: z.object({ appId, id: spreadsheetId, range: z.string(), values: rows }).strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_update_range,
+    }, passthrough("sheets_update_range"));
+    server.registerTool("sheets_add_sheet", {
+        title: "Add Spreadsheet Tab",
+        description: "Add an empty sheet (tab) to a spreadsheet. Same approval rule as sheets_append_rows: free on a file Nooticr created or one the customer allowed you to edit, otherwise it waits for their approval.",
+        annotations: WRITE,
+        inputSchema: z.object({ appId, id: spreadsheetId, name: z.string() }).strict(),
+        outputSchema: OUTPUT_SCHEMAS.sheets_add_sheet,
+    }, passthrough("sheets_add_sheet"));
+}

package/dist/shared/tools-def.js

@@ -312,6 +312,42 @@ export const TOOL_DEFINITIONS = [
         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: "sheets_create",
+        title: "Create Spreadsheet",
+        description: "Create a Google spreadsheet in the connected Google account, with the named sheets and a header row on each. Returns its id and URL; Nooticr owns the file, so later writes need no approval. Requires the product's Google Sheets connection. Free.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), title: z.string(), sheets: z.array(z.object({ name: z.string(), headers: z.array(z.string()).optional() })).optional().describe("Tabs to create.") }).strict(),
+    },
+    {
+        name: "sheets_list",
+        title: "List Spreadsheets",
+        description: "List the spreadsheets this connection can see: the ones Nooticr created and the ones the customer picked. Each says whether it was created or picked and whether the employee may edit it without approval. Free.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), limit: z.number().int().min(1).max(100).optional() }).strict(),
+    },
+    {
+        name: "sheets_read",
+        title: "Read Spreadsheet Range",
+        description: "Read a range (A1 notation, e.g. \"Ledger!A1:F200\") of a spreadsheet. Numbers come back as numbers and dates as formatted text; at most 10000 cells. Free.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), id: z.string().describe("Spreadsheet id from sheets_create or sheets_list."), range: z.string() }).strict(),
+    },
+    {
+        name: "sheets_append_rows",
+        title: "Append Spreadsheet Rows",
+        description: "Append rows after the last row of a sheet (tab). Values are typed: numbers stay numbers and ISO dates become sheet dates. At most 10000 cells per call. Free on a file Nooticr created or one the customer allowed you to edit; on any other file the customer picked it waits for their approval.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), id: z.string().describe("Spreadsheet id from sheets_create or sheets_list."), sheet: z.string().describe("Tab name."), rows: z.array(z.array(z.union([z.number(), z.boolean(), z.string(), z.null(), z.object({ formula: z.string() }).strict()]).describe('A number, boolean, text or an ISO date (2026-01-31) or datetime; null leaves the cell empty. Text that looks like a formula or number stays text; use {"formula": "=SUM(A1:A3)"} for a formula.'))) }).strict(),
+    },
+    {
+        name: "sheets_update_range",
+        title: "Update Spreadsheet Range",
+        description: "Overwrite a range (A1 notation, e.g. \"Ledger!B2:C3\") with values. Typed like sheets_append_rows; at most 10000 cells per call. Same approval rule as sheets_append_rows: free on a file Nooticr created or one the customer allowed you to edit, otherwise it waits for their approval.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), id: z.string().describe("Spreadsheet id from sheets_create or sheets_list."), range: z.string(), values: z.array(z.array(z.union([z.number(), z.boolean(), z.string(), z.null(), z.object({ formula: z.string() }).strict()]).describe('A number, boolean, text or an ISO date (2026-01-31) or datetime; null leaves the cell empty. Text that looks like a formula or number stays text; use {"formula": "=SUM(A1:A3)"} for a formula.'))) }).strict(),
+    },
+    {
+        name: "sheets_add_sheet",
+        title: "Add Spreadsheet Tab",
+        description: "Add an empty sheet (tab) to a spreadsheet. Same approval rule as sheets_append_rows: free on a file Nooticr created or one the customer allowed you to edit, otherwise it waits for their approval.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Product id; optional when the workspace has one product."), id: z.string().describe("Spreadsheet id from sheets_create or sheets_list."), name: z.string() }).strict(),
+    },
     {
         name: "list_brand_watches",
         title: "List Brand Watches",
@@ -573,8 +609,8 @@ export const TOOL_DEFINITIONS = [
     {
         name: "hire_employee",
         title: "Hire Employee",
-        description: "Hire an AI employee (for example a Social Media Manager) that works on a schedule inside this workspace. Pass `template` and optionally name, instructions, appId, schedule, monthlyBudgetCredits, maxCreditsPerRun, approvalPolicy and notify. The first call changes nothing and returns a preview and a confirmationToken; show it to the user, and call again with confirm: true and the token only after the user explicitly agrees — never confirm on the user's behalf. Public actions (publish, email, reply, listing or price changes) wait for the user's approval unless autopilot is turned on. The hiring user is billed for runs, up to the monthly budget. No cost to call.",
-        inputSchema: z.object({ template: z.string().describe("Template slug, e.g. social-media-manager."), name: z.string().optional().describe("What to call the employee."), instructions: z.string().optional().describe("Standing instructions from the customer (tone, topics to avoid, ...)."), appId: z.number().int().optional().describe("Focus product id."), schedule: z.object({}).passthrough().optional().describe("{kind:'weekly',days:['mon'],times:['09:00'],tz:'Europe/Paris'} | {kind:'interval',minutes:N>=60} | {kind:'manual'}."), monthlyBudgetCredits: z.number().int().min(1).optional(), maxCreditsPerRun: z.number().int().min(1).optional(), approvalPolicy: z.object({}).passthrough().optional().describe("Action type -> 'approval' | 'auto'."), notify: z.object({}).passthrough().optional().describe("{channels:['email'|'slack']}."), model: z.string().optional().describe("Optional model."), effort: z.string().optional().describe("low | medium | high."), confirm: z.boolean().optional(), confirmationToken: z.string().optional().describe("Token returned in the quote.") }).strict(),
+        description: "Hire an AI employee (for example a Social Media Manager) that works on a schedule inside this workspace. Pass `template` and optionally name, instructions, products (the string all, or a list of product ids; appId is deprecated), schedule, monthlyBudgetCredits, maxCreditsPerRun, approvalPolicy and notify (channels, and recipients: hirer, admins or member user ids). The first call changes nothing and returns a preview and a confirmationToken; show it to the user, and call again with confirm: true and the token only after the user explicitly agrees — never confirm on the user's behalf. Public actions (publish, email, reply, listing or price changes) wait for the user's approval unless autopilot is turned on. The hiring user is billed for runs, up to the monthly budget. No cost to call.",
+        inputSchema: z.object({ template: z.string().describe("Template slug, e.g. social-media-manager."), name: z.string().optional().describe("What to call the employee."), instructions: z.string().optional().describe("Standing instructions from the customer (tone, topics to avoid, ...)."), appId: z.number().int().optional().describe("Deprecated: same as products:[appId]. Do not send together with products."), products: z.union([z.literal("all"), z.array(z.number().int()).min(1)]).optional().describe('"all" (every product, including ones added later) or a list of product ids the employee covers.'), schedule: z.object({}).passthrough().optional().describe("{kind:'weekly',days:['mon'],times:['09:00'],tz:'Europe/Paris'} | {kind:'interval',minutes:N>=60} | {kind:'manual'}."), monthlyBudgetCredits: z.number().int().min(1).optional(), maxCreditsPerRun: z.number().int().min(1).optional(), approvalPolicy: z.object({}).passthrough().optional().describe("Action type -> 'approval' | 'auto'."), notify: z.object({}).passthrough().optional().describe("{channels:['email'|'slack'], recipients?:'hirer'|'admins'|[member user ids, max 25]}."), model: z.string().optional().describe("Optional model."), effort: z.string().optional().describe("low | medium | high."), confirm: z.boolean().optional(), confirmationToken: z.string().optional().describe("Token returned in the quote.") }).strict(),
     },
     {
         name: "list_employees",

package/dist/shared/tools.js

@@ -22,6 +22,7 @@ import { BackendWatchStore, MemoryWatchStore, registerWatchlist, } from "./watch
 import { registerJobTools } from "./jobs.js";
 import { registerBrandWatch } from "./brand-watch.js";
 import { registerCreativeTools } from "./creative.js";
+import { registerSheetsTools } from "./sheets.js";
 import { registerOwnAccountTools } from "./own-account.js";
 import { registerConnectionTools } from "./connections.js";
 import { registerEmployeeTools } from "./employees.js";
@@ -34,7 +35,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.65";
+export const MCP_SERVER_VERSION = "1.26.67";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -2890,6 +2891,8 @@ export function createMcpServer(rawMakeClient, opts) {
     registerOwnAccountTools(server, makeClient);
     // Creative assets (creative.ts): the free reads of nooticr-server's creative_* family.
     registerCreativeTools(server, makeClient);
+    // Google Sheets (sheets.ts): the sheets_* family of nooticr-server BK2.
+    registerSheetsTools(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.65",
+  "version": "1.26.67",
   "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": {