@nooticr/mcp 1.26.45 → 1.26.47

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-85 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+87 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
@@ -152,6 +152,7 @@ a `scanId` for the rest.
 | `marketplace_scan_status` | free | Picks a running marketplace collection back up by `scanId` and the same `marketplace`. Free, for the same reason `amazon_scan_status` is. |
 | `get_marketplace_product` | 3 | One product from any of the twelve sites, by id or URL: price, rating, the full star histogram, specs and the reviews. |
 | `show_amazon_category_insights` | free | Draws the read **your model** wrote — purchase drivers, barriers, what each brand does well, the gaps, the positioning angles — beside the listings and their reviews, so a person can click a product and check any claim against the text it came from. The conclusions are attributed to your model, never presented as a nooticr rating of anyone's product. Given the `scanId`, it re-reads the listings from the scan itself (free) instead of drawing whatever the model re-sends, and flags any ASIN the read cites that the scan does not contain; without one, the card says its listings were not checked. |
+| `show_marketplace_category_insights` | free | The same card for the other eleven marketplaces: your read beside that site's listings and reviews, labelled with the right site, re-read from the scan by `scanId` and `marketplace` so nothing is re-typed. |
 
 ### Make something
 
@@ -173,6 +174,7 @@ a `scanId` for the rest.
 | `check_nooticr_credits` | free | Balance and billing URL. |
 | `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. |
 | `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. |

package/dist/shared/amazon.js

@@ -217,7 +217,8 @@ export function categoryGuidance(opts) {
     }
     if (insightsTool) {
         lines.push("");
-        lines.push("To show the result in the conversation — products, their reviews, and your read side by", `side — call ${insightsTool} with what you concluded${opts.scanId ? ` and scanId "${opts.scanId}"` : " and the scanId"}.`, "It costs nothing, and it re-reads the listings from the scan itself, so do not re-send them.");
+        lines.push("To show the result in the conversation — products, their reviews, and your read side by", `side — call ${insightsTool} with what you concluded${opts.scanId ? ` and scanId "${opts.scanId}"` : " and the scanId"}` +
+            `${Object.entries(opts.statusArgs ?? {}).map(([k, v]) => `, ${k} "${v}"`).join("")}.`, "It costs nothing, and it re-reads the listings from the scan itself, so do not re-send them.");
     }
     return lines.join("\n");
 }
@@ -260,6 +261,76 @@ export const CREDITS_PER_LISTING = 3;
 export function scanCost(args) {
     return listingCount(args) * CREDITS_PER_LISTING;
 }
+/**
+ * The read a model writes over a category scan, shared by the Amazon and
+ * the eleven-marketplace insights tools (#95): one shape, so the card and the
+ * guidance cannot drift between sites.
+ */
+export const insightsInputShape = {
+    category: z.string().describe("The category this is a read of, e.g. 'Ashwagandha supplements'."),
+    summary: z.string().optional().describe("The category in two or three sentences."),
+    drivers: z
+        .array(z.object({
+        label: z.string().describe("The driver, in a few words."),
+        detail: z.string().optional().describe("What the reviews actually say."),
+        evidence: z
+            .array(z.string())
+            .optional()
+            .describe("Review ids or short quotes that show it."),
+        strength: z
+            .enum(["strong", "moderate", "thin"])
+            .optional()
+            .describe("How well the collected text supports it. Say `thin` rather than overstating."),
+    }))
+        .optional()
+        .describe("What makes someone buy in this category."),
+    barriers: z
+        .array(z.object({
+        label: z.string(),
+        detail: z.string().optional(),
+        evidence: z.array(z.string()).optional(),
+        strength: z.enum(["strong", "moderate", "thin"]).optional(),
+    }))
+        .optional()
+        .describe("What stops them buying, or makes them return it."),
+    strengths: z
+        .array(z.object({
+        brand: z.string(),
+        detail: z.string(),
+        asin: z
+            .string()
+            .optional()
+            .describe("The product id this is about: an ASIN on Amazon, the site's own id elsewhere."),
+    }))
+        .optional()
+        .describe("What each incumbent is genuinely doing well."),
+    gaps: z
+        .array(z.object({
+        label: z.string(),
+        detail: z.string().optional(),
+        evidence: z.array(z.string()).optional(),
+    }))
+        .optional()
+        .describe("What buyers keep asking for that nobody in the set serves."),
+    positioning: z
+        .array(z.object({
+        angle: z.string().describe("The claim, in one line."),
+        who: z.string().optional().describe("Who it is for."),
+        why: z.string().optional().describe("The driver it answers or the gap it fills."),
+        risk: z.string().optional().describe("What would have to be true, or what could go wrong."),
+    }))
+        .optional()
+        .describe("Concrete angles a new entrant could take."),
+    products: z
+        .array(anyObject())
+        .optional()
+        .describe("Only when there is no scanId. With one, the listings are re-read from the scan and anything here is ignored."),
+    rollup: anyObject().optional().describe("Only when there is no scanId; re-read from the scan otherwise."),
+    scanId: z
+        .string()
+        .optional()
+        .describe("The scan this reads. Pass it: it is what lets the card draw the collector's own listings."),
+};
 export function registerAmazonTools(server, makeClient) {
     server.registerTool("scan_amazon_category", {
         title: "Scan Amazon Category",
@@ -454,105 +525,8 @@ export function registerAmazonTools(server, makeClient) {
             openWorldHint: false,
         },
         outputSchema: OUTPUT_SCHEMAS.show_amazon_category_insights,
-        inputSchema: z
-            .object({
-            category: z.string().describe("The category this is a read of, e.g. 'Ashwagandha supplements'."),
-            summary: z.string().optional().describe("The category in two or three sentences."),
-            drivers: z
-                .array(z.object({
-                label: z.string().describe("The driver, in a few words."),
-                detail: z.string().optional().describe("What the reviews actually say."),
-                evidence: z
-                    .array(z.string())
-                    .optional()
-                    .describe("Review ids or short quotes that show it."),
-                strength: z
-                    .enum(["strong", "moderate", "thin"])
-                    .optional()
-                    .describe("How well the collected text supports it. Say `thin` rather than overstating."),
-            }))
-                .optional()
-                .describe("What makes someone buy in this category."),
-            barriers: z
-                .array(z.object({
-                label: z.string(),
-                detail: z.string().optional(),
-                evidence: z.array(z.string()).optional(),
-                strength: z.enum(["strong", "moderate", "thin"]).optional(),
-            }))
-                .optional()
-                .describe("What stops them buying, or makes them return it."),
-            strengths: z
-                .array(z.object({
-                brand: z.string(),
-                detail: z.string(),
-                asin: z.string().optional(),
-            }))
-                .optional()
-                .describe("What each incumbent is genuinely doing well."),
-            gaps: z
-                .array(z.object({
-                label: z.string(),
-                detail: z.string().optional(),
-                evidence: z.array(z.string()).optional(),
-            }))
-                .optional()
-                .describe("What buyers keep asking for that nobody in the set serves."),
-            positioning: z
-                .array(z.object({
-                angle: z.string().describe("The claim, in one line."),
-                who: z.string().optional().describe("Who it is for."),
-                why: z.string().optional().describe("The driver it answers or the gap it fills."),
-                risk: z.string().optional().describe("What would have to be true, or what could go wrong."),
-            }))
-                .optional()
-                .describe("Concrete angles a new entrant could take."),
-            products: z
-                .array(anyObject())
-                .optional()
-                .describe("Only when there is no scanId. With one, the listings are re-read from the scan and anything here is ignored."),
-            rollup: anyObject().optional().describe("Only when there is no scanId; re-read from the scan otherwise."),
-            scanId: z
-                .string()
-                .optional()
-                .describe("The scan this reads. Pass it: it is what lets the card draw the collector's own listings."),
-        })
-            .passthrough(),
-    }, async (args, extra) => {
-        const checked = await rehydrate(args, () => makeClient({ ...extra, arguments: args }));
-        const products = checked.products;
-        const counts = {
-            drivers: Array.isArray(args.drivers) ? args.drivers.length : 0,
-            barriers: Array.isArray(args.barriers) ? args.barriers.length : 0,
-            gaps: Array.isArray(args.gaps) ? args.gaps.length : 0,
-            positioning: Array.isArray(args.positioning) ? args.positioning.length : 0,
-        };
-        const text = `Category read for ${String(args.category ?? "this category")}: ${counts.drivers} driver(s), ` +
-            `${counts.barriers} barrier(s), ${counts.gaps} gap(s), ${counts.positioning} positioning angle(s)` +
-            `${products.length ? `, drawn beside ${products.length} listing(s)` : ""}.` +
-            (args.summary ? ` ${String(args.summary)}` : "") +
-            ` ${checked.verification.note}`;
-        return {
-            content: [{ type: "text", text }],
-            structuredContent: {
-                marketplace: "amazon",
-                view: "insights",
-                category: String(args.category ?? ""),
-                summary: args.summary ?? null,
-                drivers: args.drivers ?? [],
-                barriers: args.barriers ?? [],
-                strengths: args.strengths ?? [],
-                gaps: args.gaps ?? [],
-                positioning: args.positioning ?? [],
-                products,
-                rollup: checked.rollup,
-                scanId: args.scanId ?? null,
-                verification: checked.verification,
-                // The one read is amazon_scan_status, which is free by design.
-                mcpCredits: { cost: 0 },
-            },
-        };
-    });
+        inputSchema: z.object(insightsInputShape).passthrough(),
+    }, async (args, extra) => insightsResult(args, () => makeClient({ ...extra, arguments: args }), { marketplace: "amazon" }));
 }
 /**
  * The listings a category read is drawn beside, from the scan rather than
@@ -567,7 +541,7 @@ export function registerAmazonTools(server, makeClient) {
  * model sent is drawn and marked unverified rather than refused: a card with a
  * visible caveat is more use to a person than no card.
  */
-export async function rehydrate(args, client) {
+export async function rehydrate(args, client, opts = {}) {
     const sent = Array.isArray(args.products) ? args.products : [];
     const sentRollup = (args.rollup ?? {});
     const scanId = typeof args.scanId === "string" ? args.scanId.trim() : "";
@@ -583,7 +557,11 @@ export async function rehydrate(args, client) {
     }
     let payload;
     try {
-        const res = await (await client()).callTool("amazon_scan_status", { scanId, waitSeconds: 0 });
+        const res = await (await client()).callTool(opts.statusTool ?? "amazon_scan_status", {
+            ...(opts.statusArgs ?? {}),
+            scanId,
+            waitSeconds: 0,
+        });
         payload = structured(res);
     }
     catch (err) {
@@ -601,7 +579,7 @@ export async function rehydrate(args, client) {
     const scanComplete = payload.complete !== false;
     const flags = [
         notInScan.length ? `${notInScan.length} listing(s) you sent are not in the scan (${notInScan.join(", ")}) and are not drawn.` : "",
-        unknownAsins.length ? `ASIN(s) cited in strengths but not in the scan: ${unknownAsins.join(", ")}.` : "",
+        unknownAsins.length ? `Product id(s) cited in strengths but not in the scan: ${unknownAsins.join(", ")}.` : "",
         scanComplete ? "" : "The scan is still running, so the set drawn is what it had collected so far.",
     ].filter(Boolean);
     return {
@@ -616,6 +594,48 @@ export async function rehydrate(args, client) {
         },
     };
 }
+/**
+ * The insights card for any site: the model's read, drawn beside the scan's
+ * own listings, re-read by scanId so a mis-copied price or an invented
+ * competitor cannot reach the card (#107). `marketplace` is what the view
+ * labels the header with, so a Lazada read is never drawn as an Amazon one.
+ */
+export async function insightsResult(args, client, site) {
+    const checked = await rehydrate(args, client, { statusTool: site.statusTool, statusArgs: site.statusArgs });
+    const products = checked.products;
+    const counts = {
+        drivers: Array.isArray(args.drivers) ? args.drivers.length : 0,
+        barriers: Array.isArray(args.barriers) ? args.barriers.length : 0,
+        gaps: Array.isArray(args.gaps) ? args.gaps.length : 0,
+        positioning: Array.isArray(args.positioning) ? args.positioning.length : 0,
+    };
+    const on = site.label ? ` on ${site.label}` : "";
+    const text = `Category read for ${String(args.category ?? "this category")}${on}: ${counts.drivers} driver(s), ` +
+        `${counts.barriers} barrier(s), ${counts.gaps} gap(s), ${counts.positioning} positioning angle(s)` +
+        `${products.length ? `, drawn beside ${products.length} listing(s)` : ""}.` +
+        (args.summary ? ` ${String(args.summary)}` : "") +
+        ` ${checked.verification.note}`;
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: {
+            marketplace: site.marketplace,
+            view: "insights",
+            category: String(args.category ?? ""),
+            summary: args.summary ?? null,
+            drivers: args.drivers ?? [],
+            barriers: args.barriers ?? [],
+            strengths: args.strengths ?? [],
+            gaps: args.gaps ?? [],
+            positioning: args.positioning ?? [],
+            products,
+            rollup: checked.rollup,
+            scanId: args.scanId ?? null,
+            verification: checked.verification,
+            // The one read is the site's scan-status poll, free by design.
+            mcpCredits: { cost: 0 },
+        },
+    };
+}
 /**
  * One scan result, shaped for both channels.
  *

package/dist/shared/loading-plans.js

@@ -353,6 +353,13 @@ export const LOADING_PLANS = {
         steps: [],
         free: true,
     },
+    show_marketplace_category_insights: {
+        label: "Drawing the category read",
+        kind: "list",
+        n: 5,
+        steps: [],
+        free: true,
+    },
     // ─── Marketplace ───
     //
     // The wait here is genuinely long and the reason is worth showing rather
@@ -488,6 +495,7 @@ export const LOADING_PLANS = {
     check_nooticr_credits: { label: "Checking your balance", kind: "text", n: 1, steps: [], free: true },
     list_tool_runs: { label: "Reading your run history", kind: "text", n: 1, steps: [], free: true },
     get_tool_run: { label: "Reading the run", kind: "text", n: 1, steps: [], free: true },
+    get_usage_report: { label: "Adding up the run ledger", kind: "text", n: 1, steps: [], free: true },
     nooticr_getting_started: { label: "Reading where your account stands", kind: "text", n: 1, steps: [], free: true },
     nooticr_login: { label: "Getting a sign-in link", kind: "text", n: 1, steps: [], free: true },
     watch_creator: { label: "Adding to your watchlist", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/marketplace.js

@@ -3,7 +3,7 @@ import { OUTPUT_SCHEMAS } from "./output-schemas.js";
 import { viewMeta } from "./view-meta.js";
 import { withEvidence } from "./evidence-digest.js";
 import { confirmSpend, declinedResult } from "./spend.js";
-import { allReviews, categoryGuidance, listingCount, nextPoll, normaliseProducts, pollTail, scanCost } from "./amazon.js";
+import { allReviews, categoryGuidance, insightsInputShape, insightsResult, listingCount, nextPoll, normaliseProducts, pollTail, scanCost, } from "./amazon.js";
 /**
  * The twelve sites, mirroring `MARKETPLACES` in nooticr-server.
  *
@@ -199,10 +199,10 @@ function marketplaceResult(payload, m, focus) {
         statusArgs: { marketplace: m.slug },
         status: typeof payload.status === "string" ? payload.status : undefined,
         total: num(progress.total) ?? undefined,
-        // There is no free insights view for these sites yet, and pointing a model
-        // at show_amazon_category_insights would have it draw a Lazada scan as an
-        // Amazon one. Better to say nothing than to name the wrong tool.
-        insightsTool: null,
+        // Its own view, labelled with this site (#95): pointing a model at
+        // show_amazon_category_insights would have it draw a Lazada scan as an
+        // Amazon one.
+        insightsTool: "show_marketplace_category_insights",
     });
     const structuredPayload = {
         guidance,
@@ -426,4 +426,48 @@ export function registerMarketplaceTools(server, makeClient) {
             return toolError("get_marketplace_product failed", err);
         }
     });
+    /**
+     * The read a model writes from scan_marketplace_category, drawn beside the
+     * site's own listings (#95). The same card and the same check against the
+     * scan as show_amazon_category_insights; the name shares whole words with
+     * its predecessor (`marketplace`, `category`) because that is what decides
+     * whether a host's tool search returns it.
+     */
+    server.registerTool("show_marketplace_category_insights", {
+        title: "Show Marketplace Category Insights",
+        _meta: viewMeta("show_marketplace_category_insights"),
+        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, drawn beside the " +
+            "site's listings and their reviews so a person can check any claim against the text it came " +
+            "from. Pass the same marketplace and the scanId: the listings are then re-read from the scan " +
+            "itself (free) rather than taken from you, so do not re-send them, and any product id 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, never " +
+            "presented as a nooticr rating of anyone's product. For Amazon scans use " +
+            "show_amazon_category_insights. Call this after you have read the reviews, not instead of reading them.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            // Its one request re-reads a scan the caller already ran, from
+            // nooticr's job store with no wait: nothing new is fetched.
+            openWorldHint: false,
+        },
+        outputSchema: OUTPUT_SCHEMAS.show_marketplace_category_insights,
+        inputSchema: z.object({ marketplace: marketplaceArg, ...insightsInputShape }).passthrough(),
+    }, async (args, extra) => {
+        const m = BY_SLUG.get(String(args.marketplace ?? ""));
+        if (!m) {
+            return {
+                content: [{ type: "text", text: `Unknown marketplace "${String(args.marketplace)}". One of: ${SLUGS}.` }],
+                isError: true,
+            };
+        }
+        return insightsResult(args, () => makeClient({ ...extra, arguments: args }), {
+            marketplace: m.slug,
+            label: m.label,
+            statusTool: "marketplace_scan_status",
+            statusArgs: { marketplace: m.slug },
+        });
+    });
 }

package/dist/shared/output-schemas.js

@@ -311,6 +311,29 @@ const marketplaceScanShape = {
 };
 const marketplaceScan = open(marketplaceScanShape);
 const amazonScan = open(amazonScanShape);
+/** A category read drawn beside a scan's listings, on any site. */
+const categoryInsights = open({
+    marketplace: scalar(),
+    view: scalar(),
+    category: scalar(),
+    summary: scalar(),
+    drivers: listOf(amazonFinding).describe("What makes someone buy, as you read it."),
+    barriers: listOf(amazonFinding).describe("What stops them, or makes them return it."),
+    strengths: listOf(open({ brand: scalar(), detail: scalar(), asin: scalar() })),
+    gaps: listOf(amazonFinding),
+    positioning: listOf(open({ angle: scalar(), who: scalar(), why: scalar(), risk: scalar() })),
+    products: listOf(amazonProduct).describe("The listings drawn: the scan's own, re-read by scanId, unless verification.status is unverified."),
+    rollup: open({}).nullish(),
+    scanId: scalar(),
+    verification: open({
+        status: scalar().describe("verified: the listings are the scan's own. unverified: as re-sent by the model."),
+        note: scalar(),
+        scanComplete: scalar(),
+        notInScan: listOf(z.string()).describe("Listings the model sent that the scan does not contain; not drawn."),
+        unknownAsins: listOf(z.string()).describe("ASINs cited in strengths that the scan does not contain."),
+    }).nullish(),
+    mcpCredits,
+});
 /**
  * Whether a show_* view drew nooticr's own figures (#107): the session's
  * fetch ledger overlays what was actually returned on what the model sent.
@@ -1112,6 +1135,23 @@ export const OUTPUT_SCHEMAS = {
             userId: scalar().describe("Whose run it was; only in the workspace scope."),
         }).nullish(),
     }),
+    get_usage_report: open({
+        report: scalar(),
+        scope: scalar().describe("mine or workspace."),
+        from: scalar(),
+        to: scalar(),
+        totals: open({
+            calls: scalar(),
+            failures: scalar(),
+            credits: scalar().describe("Credits actually taken: free first uses, refunds and replays are zero."),
+            tools: scalar(),
+            seats: scalar(),
+        }).nullish(),
+        byTool: listOf(open({ tool: scalar(), calls: scalar(), failures: scalar(), credits: scalar(), lastUsedAt: scalar() })),
+        bySeat: listOf(open({ userId: scalar(), email: scalar(), name: scalar(), calls: scalar(), failures: scalar(), credits: scalar() })).describe("Workspace reports only; empty on a personal one."),
+        byDay: listOf(open({ day: scalar(), calls: scalar(), failures: scalar(), credits: scalar() })),
+        recentFailures: listOf(open({ id: scalar(), tool: scalar(), error: scalar(), startedAt: scalar(), userId: scalar(), credits: scalar() })),
+    }),
     nooticr_login: open({
         signedIn: scalar().describe("true when the session is already good and no link is needed."),
         loginUrl: scalar().describe("Only present when a sign-in is actually required."),
@@ -1556,26 +1596,7 @@ export const OUTPUT_SCHEMAS = {
         ...amazonScanShape,
         product: amazonProduct.nullish().describe("The single listing, also present as products[0]."),
     }),
-    show_amazon_category_insights: open({
-        marketplace: scalar(),
-        view: scalar(),
-        category: scalar(),
-        summary: scalar(),
-        drivers: listOf(amazonFinding).describe("What makes someone buy, as you read it."),
-        barriers: listOf(amazonFinding).describe("What stops them, or makes them return it."),
-        strengths: listOf(open({ brand: scalar(), detail: scalar(), asin: scalar() })),
-        gaps: listOf(amazonFinding),
-        positioning: listOf(open({ angle: scalar(), who: scalar(), why: scalar(), risk: scalar() })),
-        products: listOf(amazonProduct).describe("The listings drawn: the scan's own, re-read by scanId, unless verification.status is unverified."),
-        rollup: open({}).nullish(),
-        scanId: scalar(),
-        verification: open({
-            status: scalar().describe("verified: the listings are the scan's own. unverified: as re-sent by the model."),
-            note: scalar(),
-            scanComplete: scalar(),
-            notInScan: listOf(z.string()).describe("Listings the model sent that the scan does not contain; not drawn."),
-            unknownAsins: listOf(z.string()).describe("ASINs cited in strengths that the scan does not contain."),
-        }).nullish(),
-        mcpCredits,
-    }),
+    show_amazon_category_insights: categoryInsights,
+    // The same card for the other eleven sites (#95); `marketplace` says which.
+    show_marketplace_category_insights: categoryInsights,
 };

package/dist/shared/tools-def.js

@@ -222,6 +222,12 @@ export const TOOL_DEFINITIONS = [
         description: "One run from list_tool_runs by its id, with its full error text, credentials scrubbed. A run outside your scope reads as not found. No cost to call. Use to look closely at one charge.",
         inputSchema: z.object({ id: z.number().int(), scope: z.enum(["mine", "workspace"]).optional() }).strict(),
     },
+    {
+        name: "get_usage_report",
+        title: "Get Usage Report",
+        description: "A usage report over a window: total calls, failures and credits actually taken, per tool, per day, and recent failures; scope workspace adds one row per seat, for owners and admins. No cost to call.",
+        inputSchema: z.object({ days: z.number().int().min(1).max(366).optional(), from: z.string().optional(), to: z.string().optional(), scope: z.enum(["mine", "workspace"]).optional() }).strict(),
+    },
     {
         name: "nooticr_login",
         title: "Nooticr Login",
@@ -510,4 +516,10 @@ export const TOOL_DEFINITIONS = [
         description: "Display the category read you produced from scan_amazon_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({ 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: "show_marketplace_category_insights",
+        title: "Show Marketplace Category Insights",
+        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(),
+    },
 ];

package/dist/shared/tools.js

@@ -30,7 +30,7 @@ import { registerCollabTools } from "./collab.js";
 import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.45";
+export const MCP_SERVER_VERSION = "1.26.47";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -604,6 +604,7 @@ export function createMcpServer(rawMakeClient, opts) {
         "check_nooticr_credits",
         "list_tool_runs",
         "get_tool_run",
+        "get_usage_report",
         "list_watchlist",
         "nooticr_getting_started",
         "understand_social_post",
@@ -694,6 +695,7 @@ export function createMcpServer(rawMakeClient, opts) {
         "amazon_scan_status",
         "get_amazon_product",
         "show_amazon_category_insights",
+        "show_marketplace_category_insights",
         // The marketplace-agnostic trio. Every name here gets a ui://nooticr/<tool>
         // resource, which is what gives a tool its card — a tool missing from this
         // list is one the host is told to render and then 404s on.
@@ -2609,6 +2611,43 @@ export function createMcpServer(rawMakeClient, opts) {
             return toolError("get_tool_run failed", err);
         }
     });
+    // The run ledger added up (#93): the question an owner or a security review
+    // asks ("what did the team run this month, what did it cost, what failed")
+    // answered from the same rows as the history, never from memory.
+    server.registerTool("get_usage_report", {
+        title: "Get Usage Report",
+        description: "A usage report over a window: total calls, failures and credits actually taken; one row " +
+            "per tool, most expensive first; one row per day, quiet days included; and the ten most " +
+            "recent failures with their errors, credentials scrubbed. scope: \"workspace\" covers " +
+            "every member of your workspace and adds one row per seat; it is for the workspace's " +
+            "owners and admins. Reads the stored run ledger, so it is free and says what happened, " +
+            "not what is running. No cost to call. Use for \"what did we spend this month and on " +
+            "what\" or an audit of what nooticr did on the workspace's behalf; list_tool_runs is the " +
+            "call-by-call view.",
+        _meta: {
+            ui: { resourceUri: uiResource("get_usage_report") },
+            "ui/resourceUri": uiResource("get_usage_report"),
+            "openai/outputTemplate": appsSdkResource("get_usage_report"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        outputSchema: OUTPUT_SCHEMAS.get_usage_report,
+        inputSchema: z
+            .object({
+            days: z.number().int().min(1).max(366).optional().describe("The window, in days back from now (default 30)."),
+            from: z.string().optional().describe("Start of the window, ISO date or timestamp. Overrides days."),
+            to: z.string().optional().describe("End of the window, ISO date or timestamp (default now)."),
+            scope: runFilters.scope,
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        try {
+            return await toToolResult(await client.callTool("get_usage_report", { ...args }));
+        }
+        catch (err) {
+            return toolError("get_usage_report failed", err);
+        }
+    });
     server.registerTool("nooticr_login", {
         title: "Nooticr Login",
         description: "Get a fresh login URL to re-authenticate your MCP session. Call this tool when you need to reconnect or when the session has expired. No cost to call." +

package/dist/shared/ui-template.js

@@ -45,6 +45,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     check_nooticr_credits:"Check Credits",
     list_tool_runs:"Tool Runs",
     get_tool_run:"Tool Run",
+    get_usage_report:"Usage Report",
     list_watchlist:"Watchlist",
     detect_spoken_mentions:"Spoken Mentions",
     nooticr_getting_started:"Getting Started",
@@ -66,7 +67,8 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     get_amazon_product:"Get Amazon Product",
     scan_marketplace_category:"Scan Marketplace Category",
     marketplace_scan_status:"Marketplace Scan Status",
-    get_marketplace_product:"Get Marketplace Product"
+    get_marketplace_product:"Get Marketplace Product",
+    show_marketplace_category_insights:"Marketplace Category Insights"
   };
   var TOOL_DESCS={
     analyze_post:"Frames from the post plus its transcript, for you to read yourself.",
@@ -83,6 +85,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     check_nooticr_credits:"View your Nooticr credit balance and usage.",
     list_tool_runs:"Where your credits went: every call, what it cost, and whether it worked.",
     get_tool_run:"One call from your history, with its full error.",
+    get_usage_report:"What was spent, on what, by whom, and what failed.",
     list_watchlist:"The creators you are watching, and when you last caught up on each.",
     detect_spoken_mentions:"Brands named out loud in a video, beside what its caption says.",
     nooticr_getting_started:"Where your account stands and what to try first.",
@@ -102,9 +105,10 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     scan_amazon_category:"A category on Amazon — prices, ratings and what reviewers keep raising.",
     amazon_scan_status:"The listings an Amazon scan has collected so far.",
     get_amazon_product:"One Amazon listing: price, rating, star histogram and reviews.",
-    scan_marketplace_category:"A category on any of eleven marketplaces — prices, ratings and review themes.",
+    scan_marketplace_category:"A category on any of twelve marketplaces — prices, ratings and review themes.",
     marketplace_scan_status:"The products a marketplace scan has collected so far.",
-    get_marketplace_product:"One product from any marketplace: price, rating, histogram and reviews."
+    get_marketplace_product:"One product from any marketplace: price, rating, histogram and reviews.",
+    show_marketplace_category_insights:"Your read of a marketplace category, beside its listings."
   };
 
   // ─── The mark ───
@@ -3150,6 +3154,48 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     return '<div class="fade-in">'+head+body+"</div>";
   }
 
+  // ─── Usage report (get_usage_report) ───
+  //
+  // A spend table: the totals first, then where it went. Credits are what was
+  // actually taken, so a free first use or a refund reads as 0, not as the
+  // tool's price.
+  function renderUsageReport(d){
+    var t=d.totals||{};
+    function tile(label,val){
+      return '<div style="flex:1;min-width:110px;padding:10px 12px;border:1px solid var(--border);border-radius:10px">'
+        +'<div style="font-size:11px;color:var(--muted);text-transform:uppercase;letter-spacing:.05em">'+esc(label)+"</div>"
+        +'<div style="font-size:18px;font-weight:700;margin-top:3px">'+esc(String(val==null?"—":val))+"</div></div>";
+    }
+    function table(title,cols,rows){
+      if(!rows.length)return "";
+      return '<div class="sec-label" style="margin-top:14px">'+esc(title)+"</div>"
+        +'<table style="width:100%;border-collapse:collapse;font-size:13px">'
+        +"<tr>"+cols.map(function(c,i){return '<th style="text-align:'+(i?"right":"left")+';font-weight:600;color:var(--muted);padding:4px 0">'+esc(c)+"</th>";}).join("")+"</tr>"
+        +rows.map(function(r){return '<tr data-usage-row style="border-top:1px solid var(--border)">'+r.map(function(v,i){return '<td style="padding:6px 0;text-align:'+(i?"right":"left")+'">'+esc(String(v))+"</td>";}).join("")+"</tr>";}).join("")
+        +"</table>";
+    }
+    var from=String(d.from||"").slice(0,10),to=String(d.to||"").slice(0,10);
+    var days=(d.byDay||[]),max=1;
+    days.forEach(function(x){max=Math.max(max,Number(x.credits)||0);});
+    var bars=days.length?'<div class="sec-label" style="margin-top:14px">Credits per day</div><div style="display:flex;align-items:flex-end;gap:2px;height:48px">'
+      +days.map(function(x){var c=Number(x.credits)||0;return '<span title="'+esc(String(x.day))+": "+c+' cr" style="flex:1;min-width:2px;background:var(--fg);opacity:'+(c?".6":".12")+';height:'+Math.max(2,Math.round(c/max*46))+'px"></span>';}).join("")+"</div>":"";
+    var fails=(d.recentFailures||[]).map(function(f){
+      return '<div style="padding:6px 0;border-top:1px solid var(--border);font-size:12.5px"><b>'+esc(f.tool||"")+"</b> "
+        +'<span style="color:var(--muted)">'+esc(String(f.startedAt||"").slice(0,16).split("T").join(" "))+"</span>"
+        +(f.error?'<div style="color:var(--muted);word-break:break-word">'+esc(f.error)+"</div>":"")+"</div>";
+    }).join("");
+    return '<div class="fade-in">'
+      +'<div style="font-size:15px;font-weight:700">'+(d.scope==="workspace"?"Workspace usage":"Your usage")+"</div>"
+      +'<div style="font-size:12px;color:var(--muted);margin:2px 0 12px">'+esc(from)+" → "+esc(to)+"</div>"
+      +'<div style="display:flex;gap:8px;flex-wrap:wrap">'+tile("Credits",t.credits)+tile("Calls",t.calls)+tile("Failures",t.failures)
+      +(d.scope==="workspace"?tile("Seats",t.seats):"")+"</div>"
+      +table("By tool",["Tool","Calls","Failed","Credits"],(d.byTool||[]).map(function(r){return [r.tool,r.calls,r.failures,r.credits];}))
+      +table("By seat",["Member","Calls","Failed","Credits"],(d.bySeat||[]).map(function(r){return [r.name||r.email||String(r.userId||"").slice(0,8),r.calls,r.failures,r.credits];}))
+      +bars
+      +(fails?'<div class="sec-label" style="margin-top:14px">Recent failures</div>'+fails:"")
+      +"</div>";
+  }
+
   // ─── Vetting strip ───
   //
   // Only show_collab_shortlist sends these fields, so every other creator card
@@ -4848,6 +4894,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     // Credits
     if(d.gettingStarted===true){app.innerHTML=renderGettingStarted(d);setTimeout(reportSize,50);return;}
     if(d.connector==="google_analytics"||d.connector==="search_console"||d.connector==="posthog"){app.innerHTML=renderConnector(d);setTimeout(reportSize,50);return;}
+    if(d.report===true&&d.totals){app.innerHTML=renderUsageReport(d);setTimeout(reportSize,50);return;}
     if(d.balance!=null||d.tier){
       var bal=Number(d.balance)||0,tier=d.tier||"",ff=d.firstFreeTools||[];
       var freeHtml="";

package/package.json

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