@nooticr/mcp 1.26.57 → 1.26.58

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-90 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+92 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
@@ -181,6 +181,8 @@ a `scanId` for the rest.
 | `nooticr_login` | free | Re-link the account when a call fails with an authentication error. |
 | `list_social_connections` | free | What you have connected and what each connection is actually allowed to do — read the account, publish a post, manage comments — as yes, no or **unknown**. "Manage comments" reports the platform's grant; no nooticr tool posts or replies to a comment. Unknown means the grant predates scope recording: treat it as "try it", not as a refusal. Also says which platforms can be linked at all, which is a smaller set than the networks nooticr reads. |
 | `connect_social_account` | free | A link the user opens to connect one account. They approve at the provider in their own browser; nothing is connected until they do, and no credential passes through the tool or the model's context. Each call mints a fresh link — an old one does not work twice. |
+| `connect_store` | free | A link a workspace owner or admin opens to connect an Amazon seller account or a Shopify shop. They approve at the store; nothing is connected until they do, and no credential passes through the tool. |
+| `list_store_products` | free | Read the connected store's own catalogue: title, description, status, price, and Amazon listing issues. Read-only. |
 | `create_product` | free | Create a product in your own workspace — the row every other own-account tool needs before it has anything to work with. Always creates in the calling session's workspace, never one you could name. `name` and `slug` are required; every other field is snake_case and read by exact key, so a camelCase `websiteUrl` lands nowhere. Writes no brand playbook. |
 | `update_product` | free | Patch a product's fields. An omitted argument leaves its column unchanged, so this cannot blank a field by not mentioning it, and the result lists what was actually written — a misspelled field shows up as one that did not change rather than as a silent no-op. |
 

package/dist/shared/backend-only.js

@@ -20,7 +20,7 @@ export const BACKEND_ONLY_TOOLS = {
     schedule_post: "Rendering and publishing stay in the dashboard (#92).",
     get_batch_history: "History of the dashboard's compose batches, which only exist once rendering does; stays with #92.",
     get_latest_analysis: "Returns the dashboard's stored AI fleet-analysis verdict; the public surface sells the evidence, not a judgement of ours.",
-    propose_listing_update: "Commerce writes (nooticr-server C1 3/4) stay in the dashboard until exposing store writes to hosts is a product decision. connect_store and list_store_products, the C1 read pair, are undecided and want settling together with these.",
+    propose_listing_update: "Commerce writes (nooticr-server C1 3/4) stay in the dashboard until exposing store writes to hosts is a product decision.",
     apply_listing_update: "Commerce writes (nooticr-server C1 3/4) stay in the dashboard until exposing store writes to hosts is a product decision; applying a change edits the merchant's live store.",
     propose_price_change: "Commerce writes (nooticr-server C1 3/4) stay in the dashboard until exposing store writes to hosts is a product decision.",
     apply_price_change: "Commerce writes (nooticr-server C1 3/4) stay in the dashboard until exposing store writes to hosts is a product decision; applying a change edits the merchant's live prices.",

package/dist/shared/loading-plans.js

@@ -477,6 +477,9 @@ export const LOADING_PLANS = {
     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 },
+    // ─── Store connections (store-read.ts): a link, and a read of the store's own catalogue ───
+    connect_store: { label: "Minting a store link", kind: "text", n: 1, steps: [], free: true },
+    list_store_products: { label: "Reading your store's catalogue", kind: "list", n: 3, steps: [], free: true },
     // ─── Own-account reads: nooticr's own stored rows, never an upstream call ───
     list_own_apps: { label: "Reading your products", kind: "list", n: 3, steps: [], free: true },
     get_content_plan: { label: "Reading the saved plan", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/output-schemas.js

@@ -1598,6 +1598,24 @@ export const OUTPUT_SCHEMAS = {
         connectUrl: scalar().describe("Open this in a browser to approve the connection."),
         message: scalar(),
     }),
+    // Store connections (nooticr-server C1). The catalogue rows are the platform's
+    // own shape, so only the stable fields are named.
+    connect_store: open({
+        platform: scalar(),
+        connectUrl: scalar().describe("Open this in a browser to approve the connection."),
+        message: scalar(),
+    }),
+    list_store_products: open({
+        products: listOf(anyObject()),
+        nextCursor: scalar(),
+        status: scalar(),
+        reportId: scalar(),
+        poll: anyObject().nullish(),
+        nextCall: anyObject().nullish(),
+        needsConnection: scalar(),
+        connections: listOf(anyObject()),
+        message: scalar(),
+    }),
     // Marketplace. One shape for all three collection tools: a status poll
     // returns exactly what the scan that started it returns, and a single
     // product is a scan of one — describing them differently would be three

package/dist/shared/store-read.js

@@ -0,0 +1,82 @@
+/**
+ * Store connections (nooticr-server C1): get the link a workspace owner opens to
+ * connect an Amazon seller account or a Shopify shop, and read that store's own
+ * catalogue. Both are passthroughs to the server's `POST /mcp` dispatch; the
+ * server owns the owner/admin check, the one-time link and the platform calls.
+ *
+ * The store *write* tools (propose/apply listing and price changes) are not
+ * here: they stay in BACKEND_ONLY_TOOLS until exposing them to hosts is decided.
+ * Neither tool has a view yet: a catalogue would be a table 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;
+    // No view draws structuredContent here, so the model reads it from the text.
+    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 platform = z.enum(["amazon", "shopify"]);
+export function registerStoreReadTools(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("connect_store", {
+        title: "Connect Store",
+        description: "Get a link a workspace owner or admin opens to connect an Amazon seller account " +
+            "(platform \"amazon\", optional region na/eu/fe) or a Shopify shop (platform \"shopify\", " +
+            "shop \"your-store.myshopify.com\"). Optionally appId ties the store to one product. The " +
+            "owner approves at Amazon or Shopify; nothing is connected until they do, and no " +
+            "credential passes through this tool. Nooticr only asks for access to listing copy and " +
+            "prices. Each call mints a fresh link. No cost to call.",
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+        inputSchema: z
+            .object({
+            platform: platform.describe("Which store platform to connect."),
+            shop: z.string().optional().describe("Shopify shop domain, e.g. your-store.myshopify.com."),
+            region: z.enum(["na", "eu", "fe"]).optional().describe("Amazon region; defaults to na."),
+            appId: z.string().optional().describe("Product id to tie the store to."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.connect_store,
+    }, passthrough("connect_store"));
+    server.registerTool("list_store_products", {
+        title: "List Store Products",
+        description: "Read the connected store's own catalogue: title, bullets, description, status, price, " +
+            "currency and Amazon listing issues. connectionId is optional when one store is " +
+            "connected; with several, the answer lists them and asks you to choose. query (Amazon: " +
+            "exact SKU; Shopify: product search), limit (up to 50), cursor from nextCursor, " +
+            "productRef to read one product by SKU or GID, includeIssues, includePricing (Amazon). " +
+            "For Amazon, source \"report\" reads the whole catalogue through a report: it answers " +
+            "status in_progress with a reportId and poll arguments until done. Read-only. No cost to call.",
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+        inputSchema: z
+            .object({
+            connectionId: z.string().optional().describe("Store connection id; optional when one store is connected."),
+            platform: platform.optional(),
+            query: z.string().optional().describe("Amazon: exact SKU. Shopify: product search query."),
+            limit: z.number().int().min(1).max(50).optional(),
+            cursor: z.string().optional().describe("nextCursor from the previous page."),
+            includeIssues: z.boolean().optional(),
+            includePricing: z.boolean().optional(),
+            productRef: z.string().optional().describe("Amazon SKU or Shopify product GID to read one product."),
+            marketplaceId: z.string().optional().describe("Amazon marketplace id; defaults to the first."),
+            source: z.enum(["live", "report"]).optional(),
+            reportId: z.string().optional().describe("Report id from an in_progress answer."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS.list_store_products,
+    }, passthrough("list_store_products"));
+}

package/dist/shared/tools-def.js

@@ -402,6 +402,18 @@ export const TOOL_DEFINITIONS = [
         description: "Get a link to open so you can connect one social account. The user approves at the provider; nothing is connected until they do, and no credential ever passes through this tool. For YouTube, pass capabilities [\"manage_comments\"] to also ask for the comment-management grant. No cost to call.",
         inputSchema: z.object({ platform: z.string().describe("Which network to connect."), influencerId: z.number().int().optional(), appId: z.number().int().optional(), capabilities: z.array(z.enum(["manage_comments"])).optional().describe("YouTube only: [\"manage_comments\"] asks for the comment-management grant.") }).strict(),
     },
+    {
+        name: "connect_store",
+        title: "Connect Store",
+        description: "Get a link a workspace owner or admin opens to connect an Amazon seller account (platform \"amazon\", optional region na/eu/fe) or a Shopify shop (platform \"shopify\", shop \"your-store.myshopify.com\"). Optionally appId ties the store to one product. The owner approves at Amazon or Shopify; nothing is connected until they do, and no credential passes through this tool. Nooticr only asks for access to listing copy and prices. Each call mints a fresh link. No cost to call.",
+        inputSchema: z.object({ platform: z.enum(["amazon", "shopify"]).describe("Which store platform to connect."), shop: z.string().optional().describe("Shopify shop domain, e.g. your-store.myshopify.com."), region: z.enum(["na", "eu", "fe"]).optional().describe("Amazon region; defaults to na."), appId: z.string().optional().describe("Product id to tie the store to.") }).strict(),
+    },
+    {
+        name: "list_store_products",
+        title: "List Store Products",
+        description: "Read the connected store's own catalogue: title, bullets, description, status, price, currency and Amazon listing issues. connectionId is optional when one store is connected; with several, the answer lists them and asks you to choose. query (Amazon: exact SKU; Shopify: product search), limit (up to 50), cursor from nextCursor, productRef to read one product by SKU or GID, includeIssues, includePricing (Amazon). For Amazon, source \"report\" reads the whole catalogue through a report: it answers status in_progress with a reportId and poll arguments until done. Read-only. No cost to call.",
+        inputSchema: z.object({ connectionId: z.string().optional().describe("Store connection id; optional when one store is connected."), platform: z.enum(["amazon", "shopify"]).optional(), query: z.string().optional().describe("Amazon: exact SKU. Shopify: product search query."), limit: z.number().int().min(1).max(50).optional(), cursor: z.string().optional().describe("nextCursor from the previous page."), includeIssues: z.boolean().optional(), includePricing: z.boolean().optional(), productRef: z.string().optional().describe("Amazon SKU or Shopify product GID to read one product."), marketplaceId: z.string().optional().describe("Amazon marketplace id; defaults to the first."), source: z.enum(["live", "report"]).optional(), reportId: z.string().optional().describe("Report id from an in_progress answer.") }).strict(),
+    },
     {
         name: "answer_my_audience",
         title: "Answer My Audience",

package/dist/shared/tools.js

@@ -23,6 +23,7 @@ import { registerJobTools } from "./jobs.js";
 import { registerBrandWatch } from "./brand-watch.js";
 import { registerOwnAccountTools } from "./own-account.js";
 import { registerConnectionTools } from "./connections.js";
+import { registerStoreReadTools } from "./store-read.js";
 import { registerGettingStarted, SERVER_INSTRUCTIONS } from "./getting-started.js";
 import { loadingPlansJson } from "./loading-plans.js";
 import { registerHandoff } from "./handoff.js";
@@ -31,7 +32,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.57";
+export const MCP_SERVER_VERSION = "1.26.58";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -2886,6 +2887,8 @@ export function createMcpServer(rawMakeClient, opts) {
     registerBrandWatch(server, makeClient);
     registerOwnAccountTools(server, makeClient);
     registerConnectionTools(server, makeClient);
+    // Store connections (store-read.ts): the connect link and the catalogue read.
+    registerStoreReadTools(server, makeClient);
     registerGettingStarted(server, makeClient, watchStore);
     // Neither fetches, neither takes a client: one formats what the model
     // classified for a tracker on another server, the other draws what it scored.

package/package.json

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