@nooticr/mcp 1.26.44 → 1.26.46

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
+86 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
 

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/fetch-ledger.js

@@ -0,0 +1,154 @@
+const LIMIT = 2000;
+const POST_KEYS = ["posts", "window", "demand", "supply", "results"];
+/** One spelling per post: no trailing slash, no tracking query, YouTube's id kept. */
+export function postKey(url) {
+    if (typeof url !== "string" || !url.trim())
+        return "";
+    const raw = url.trim();
+    try {
+        const u = new URL(raw);
+        const host = u.hostname.toLowerCase().replace(/^(www|m|mobile)\./, "");
+        const keep = host.endsWith("youtube.com") && u.searchParams.get("v") ? `?v=${u.searchParams.get("v")}` : "";
+        return `${host}${u.pathname.replace(/\/+$/, "")}${keep}`;
+    }
+    catch {
+        return raw.replace(/[?#].*$/, "").replace(/\/+$/, "").toLowerCase();
+    }
+}
+const urlsOf = (row) => [row.externalUrl, row.url, row.permalink, row.postUrl].map(postKey).filter(Boolean);
+const handleOf = (row) => String(row.handle ?? row.username ?? row.creatorHandle ?? "")
+    .trim()
+    .replace(/^@/, "")
+    .toLowerCase();
+export const creatorKey = (row) => {
+    const h = handleOf(row);
+    return h ? `${String(row.platform ?? "").toLowerCase()}:${h}` : "";
+};
+const runKey = (term, ranAt) => `${String(term ?? "").trim().toLowerCase()}|${String(ranAt ?? "")}`;
+class Bounded {
+    map = new Map();
+    set(k, v) {
+        if (!k)
+            return;
+        this.map.delete(k);
+        this.map.set(k, v);
+        if (this.map.size > LIMIT)
+            this.map.delete(this.map.keys().next().value);
+    }
+    get(k) {
+        return k ? this.map.get(k) : undefined;
+    }
+}
+export class FetchLedger {
+    posts = new Bounded();
+    creators = new Bounded();
+    runs = new Bounded();
+    /** Keep what a tool returned. The views' own results are never kept: they echo the model. */
+    record(tool, structured) {
+        if (tool.startsWith("show_") || !structured || typeof structured !== "object")
+            return;
+        const sc = structured;
+        const keepPost = (p) => {
+            if (!p || typeof p !== "object")
+                return;
+            for (const k of urlsOf(p))
+                this.posts.set(k, p);
+        };
+        for (const key of POST_KEYS) {
+            if (Array.isArray(sc[key]))
+                for (const p of sc[key])
+                    keepPost(p);
+        }
+        keepPost(sc.post);
+        // analyze_post and its siblings carry the post's fields at the top level.
+        if (urlsOf(sc).length && (sc.views != null || sc.caption != null || sc.title != null))
+            keepPost(sc);
+        if (Array.isArray(sc.creators)) {
+            for (const c of sc.creators) {
+                if (c && typeof c === "object")
+                    this.creators.set(creatorKey(c), c);
+            }
+        }
+        if (Array.isArray(sc.runs)) {
+            for (const r of sc.runs) {
+                if (!r || typeof r !== "object" || r.ranAt == null)
+                    continue;
+                this.runs.set(runKey(sc.term, r.ranAt), r);
+                this.runs.set(runKey("", r.ranAt), r);
+            }
+        }
+    }
+    post(url) {
+        return this.posts.get(postKey(url));
+    }
+    /**
+     * Posts as the view should draw them: nooticr's fields over the model's,
+     * so a copied stat can never win, and the model's extra fields survive.
+     */
+    checkPosts(sent) {
+        const unmatched = [];
+        const rows = sent.map((p) => {
+            const ours = urlsOf(p).map((k) => this.posts.get(k)).find(Boolean);
+            if (!ours) {
+                unmatched.push(String(p.externalUrl ?? p.url ?? "a post with no URL"));
+                return p;
+            }
+            return { ...p, ...ours, verified: true };
+        });
+        return { rows, verification: verdict(rows.length, unmatched, "post") };
+    }
+    checkCreators(sent) {
+        const unmatched = [];
+        const rows = sent.map((c) => {
+            const ours = this.creators.get(creatorKey(c));
+            if (!ours) {
+                unmatched.push(`@${handleOf(c) || "?"}${c.platform ? ` on ${String(c.platform)}` : ""}`);
+                return c;
+            }
+            // The order and any ranking note are the model's; every figure is ours.
+            return { ...c, ...ours, verified: true };
+        });
+        return { rows, verification: verdict(rows.length, unmatched, "creator") };
+    }
+    checkRuns(sent, term) {
+        const unmatched = [];
+        const rows = sent.map((r) => {
+            const ours = this.runs.get(runKey(term, r.ranAt)) ?? this.runs.get(runKey("", r.ranAt));
+            if (!ours) {
+                unmatched.push(String(r.ranAt ?? "an undated point"));
+                return r;
+            }
+            return { ...r, ...ours, verified: true };
+        });
+        return { rows, verification: verdict(rows.length, unmatched, "point") };
+    }
+}
+function verdict(total, unmatched, noun) {
+    if (!unmatched.length) {
+        return {
+            status: "verified",
+            note: `All ${total} ${noun}${total === 1 ? "" : "s"} drawn with the figures nooticr returned in this session.`,
+            unmatched,
+        };
+    }
+    const n = unmatched.length;
+    return {
+        status: "unverified",
+        note: `${n} of ${total} ${noun}${total === 1 ? "" : "s"} ${n === 1 ? "is" : "are"} not among what nooticr ` +
+            `returned in this session, so ${n === 1 ? "its" : "their"} figures are as re-sent and were not ` +
+            `checked: ${unmatched.slice(0, 5).join(", ")}${n > 5 ? ", …" : ""}.`,
+        unmatched,
+    };
+}
+/**
+ * One ledger per server. Keyed off the server object so the task path
+ * (registerSlowTool) and the plain path record into the same one without
+ * threading it through every registration.
+ */
+const LEDGERS = new WeakMap();
+export function ledgerFor(server) {
+    let l = LEDGERS.get(server);
+    if (!l)
+        LEDGERS.set(server, (l = new FetchLedger()));
+    return l;
+}

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

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,38 @@ 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.
+ */
+const checkedAgainstSession = open({
+    status: scalar().describe("verified: every row matched what nooticr returned this session. unverified: some are as re-sent."),
+    note: scalar(),
+    unmatched: listOf(z.string()).describe("Rows not among what nooticr returned in this session; drawn as sent, unchecked."),
+}).nullish();
 export const OUTPUT_SCHEMAS = {
     analyze_post: open({ ...analyzed, ...evidence }),
     analyze_post_fast: open({ ...evidence, ...analyzed }),
@@ -539,6 +571,7 @@ export const OUTPUT_SCHEMAS = {
     // to land except chat text. Free, and make no requests, same as
     // show_comment_review: they only draw what they're handed.
     show_compared_posts: open({
+        verification: checkedAgainstSession,
         posts: listOf(post).describe("The 2-5 posts being compared, same shape as compare_posts returned."),
         comparison: open({
             winner: scalar().describe("1-indexed position of the post that won, matching the posts array."),
@@ -550,6 +583,7 @@ export const OUTPUT_SCHEMAS = {
         mcpCredits,
     }),
     show_post_analysis: open({
+        verification: checkedAgainstSession,
         url: scalar(),
         post: post.nullish().describe("The post analyze_post/analyze_post_fast/understand_social_post handed back."),
         analysis: open({}).passthrough().nullish().describe("Your own analysis, any of the fields analyze_post's guidance asked for — summary, " +
@@ -569,6 +603,7 @@ export const OUTPUT_SCHEMAS = {
         mcpCredits,
     }),
     show_variants: open({
+        verification: checkedAgainstSession,
         sourceUrl: scalar(),
         post: post.nullish(),
         variants: listOf(open({
@@ -945,6 +980,7 @@ export const OUTPUT_SCHEMAS = {
         mcpCredits,
     }),
     show_standings: open({
+        verification: checkedAgainstSession,
         creators: listOf(anyObject()),
         metric: scalar(),
         ranking: scalar().describe("Which axis the order is on — 'how often' and 'how big' disagree."),
@@ -1148,6 +1184,7 @@ export const OUTPUT_SCHEMAS = {
      * might want is left underived on purpose — the model reads the series.
      */
     show_trend: open({
+        verification: checkedAgainstSession,
         points: listOf(anyObject()),
         term: scalar(),
         metric: scalar(),
@@ -1542,26 +1579,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/tasks.js

@@ -24,6 +24,7 @@
  * The task APIs are experimental in SDK 1.30 and may change under us. They are
  * contained here for that reason — one file to fix rather than three handlers.
  */
+import { ledgerFor } from "./fetch-ledger.js";
 import { InMemoryTaskStore } from "@modelcontextprotocol/sdk/experimental/tasks/stores/in-memory.js";
 /** How long a finished result stays fetchable. */
 export const TASK_TTL_MS = 900_000;
@@ -67,6 +68,7 @@ export function registerSlowTool(server, name, config, run) {
             void (async () => {
                 try {
                     const result = await run(args, extra);
+                    ledgerFor(server).record(name, result?.structuredContent);
                     await extra.taskStore.storeTaskResult(task.taskId, result?.isError ? "failed" : "completed", result);
                 }
                 catch (err) {

package/dist/shared/tools-def.js

@@ -510,4 +510,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

@@ -5,6 +5,7 @@
  * file for the CLI, KV session for the worker) — the tool bodies, schemas and
  * result formatting live here and nowhere else.
  */
+import { ledgerFor } from "./fetch-ledger.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { NooticrError, safeCreditsHint } from "./nooticr.js";
@@ -29,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.44";
+export const MCP_SERVER_VERSION = "1.26.46";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -556,6 +557,18 @@ export function createMcpServer(rawMakeClient, opts) {
             },
         },
     });
+    // Every tool result passes through the session's fetch ledger on its way
+    // out, so the show_* views can draw what nooticr returned rather than the
+    // 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 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));
+        ledger.record(name, result?.structuredContent);
+        return result;
+    });
     // 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
@@ -681,6 +694,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.
@@ -1685,7 +1699,9 @@ export function createMcpServer(rawMakeClient, opts) {
     // it (show_hooks, show_variants, show_repurposed_post).
     server.registerTool("show_trend", {
         title: "Show Trend",
-        description: "Draw the trend you read out of mention_trend. Free, and makes no requests — it renders what " +
+        description: "Figures are checked against what nooticr returned in this session: its own numbers are drawn, " +
+            "and a row it never returned is drawn marked as unchecked, so there is no need to re-type them exactly. " +
+            "Draw the trend you read out of mention_trend. Free, and makes no requests — it renders what " +
             "you pass it: the series as a chart, per-network lines where you supply them, and your own " +
             "read of what changed. Pass `tooShort` when the series has too few points to call a " +
             "direction, and `edgeIsRecordStart` when the left edge is where the record begins rather " +
@@ -1726,16 +1742,19 @@ export function createMcpServer(rawMakeClient, opts) {
         })
             .strict(),
     }, async (args) => {
+        const checked = ledger.checkRuns(args.points, args.term);
         return {
             content: [
                 {
                     type: "text",
                     text: `Showing a ${args.points.length}-point trend${args.term ? ` for "${args.term}"` : ""}.` +
-                        (args.verdict ? ` ${args.verdict}` : ""),
+                        (args.verdict ? ` ${args.verdict}` : "") +
+                        ` ${checked.verification.note}`,
                 },
             ],
             structuredContent: {
-                points: args.points,
+                points: checked.rows,
+                verification: checked.verification,
                 term: args.term ?? null,
                 metric: args.metric ?? "found",
                 verdict: args.verdict ?? null,
@@ -1747,7 +1766,9 @@ export function createMcpServer(rawMakeClient, opts) {
     });
     server.registerTool("show_standings", {
         title: "Show Standings",
-        description: "Draw the standings you read out of compare_creators or watchlist_standings. Free, and makes " +
+        description: "Figures are checked against what nooticr returned in this session: its own numbers are drawn, " +
+            "and a row it never returned is drawn marked as unchecked, so there is no need to re-type them exactly. " +
+            "Draw the standings you read out of compare_creators or watchlist_standings. Free, and makes " +
             "no requests — it only renders what you pass it: one row per creator with their window, their " +
             "own median, how often they beat it and how hard, and the post that did best. Pass `ranking` " +
             "to say which axis you ordered on, and `tooThin` for the creators whose window was too short " +
@@ -1783,16 +1804,19 @@ export function createMcpServer(rawMakeClient, opts) {
         })
             .strict(),
     }, async (args) => {
+        const checked = ledger.checkCreators(args.creators);
         return {
             content: [
                 {
                     type: "text",
                     text: `Showing standings for ${args.creators.length} creator${args.creators.length === 1 ? "" : "s"}.` +
-                        (args.verdict ? ` ${args.verdict}` : ""),
+                        (args.verdict ? ` ${args.verdict}` : "") +
+                        ` ${checked.verification.note}`,
                 },
             ],
             structuredContent: {
-                creators: args.creators,
+                creators: checked.rows,
+                verification: checked.verification,
                 metric: args.metric ?? "views",
                 ranking: args.ranking ?? null,
                 verdict: args.verdict ?? null,
@@ -1803,7 +1827,9 @@ export function createMcpServer(rawMakeClient, opts) {
     });
     server.registerTool("show_compared_posts", {
         title: "Show Comparison",
-        description: "Display a comparison you wrote after compare_posts fetched the first post and you fetched " +
+        description: "Figures are checked against what nooticr returned in this session: its own numbers are drawn, " +
+            "and a row it never returned is drawn marked as unchecked, so there is no need to re-type them exactly. " +
+            "Display a comparison you wrote after compare_posts fetched the first post and you fetched " +
             "the rest yourself (get_social_media, 1 credit each). Free, and makes no requests — it only " +
             "draws what you pass it: each post with a BEST badge on the winner, what differed, shared " +
             "strengths and the next experiment worth running. Call this after you have done the " +
@@ -1834,15 +1860,18 @@ export function createMcpServer(rawMakeClient, opts) {
         })
             .strict(),
     }, async (args) => {
+        const checked = ledger.checkPosts(args.posts);
         return {
             content: [
                 {
                     type: "text",
-                    text: `Showing a comparison of ${args.posts.length} posts.${args.winnerReason ? ` ${args.winnerReason}` : ""}`,
+                    text: `Showing a comparison of ${args.posts.length} posts.${args.winnerReason ? ` ${args.winnerReason}` : ""}` +
+                        ` ${checked.verification.note}`,
                 },
             ],
             structuredContent: {
-                posts: args.posts,
+                posts: checked.rows,
+                verification: checked.verification,
                 comparison: {
                     winner: args.winner,
                     winnerReason: args.winnerReason ?? null,
@@ -1856,7 +1885,9 @@ export function createMcpServer(rawMakeClient, opts) {
     });
     server.registerTool("show_post_analysis", {
         title: "Show Analysis",
-        description: "Display an analysis you wrote after analyze_post, analyze_post_fast or understand_social_post " +
+        description: "Figures are checked against what nooticr returned in this session: its own numbers are drawn, " +
+            "and a row it never returned is drawn marked as unchecked, so there is no need to re-type them exactly. " +
+            "Display an analysis you wrote after analyze_post, analyze_post_fast or understand_social_post " +
             "handed you the material. Free, and makes no requests — it only draws what you pass it: hook " +
             "strength, script structure, quotable lines, hashtags, target audience, viral triggers and " +
             "more, whichever of these you actually produced. Call this after you have done the analysing, " +
@@ -1883,11 +1914,15 @@ export function createMcpServer(rawMakeClient, opts) {
         })
             .strict(),
     }, async (args) => {
+        const checked = ledger.checkPosts([
+            { ...(args.post ?? { platform: platformFromUrl(args.url) }), externalUrl: args.post?.externalUrl ?? args.url },
+        ]);
         return {
-            content: [{ type: "text", text: `Showing your analysis of ${args.url}.` }],
+            content: [{ type: "text", text: `Showing your analysis of ${args.url}. ${checked.verification.note}` }],
             structuredContent: {
                 url: args.url,
-                post: args.post ?? { platform: platformFromUrl(args.url), externalUrl: args.url },
+                post: checked.rows[0],
+                verification: checked.verification,
                 analysis: args.analysis,
                 mcpCredits: { cost: 0 },
             },
@@ -1932,7 +1967,9 @@ export function createMcpServer(rawMakeClient, opts) {
     });
     server.registerTool("show_variants", {
         title: "Show Variants",
-        description: "Display the post variants you wrote after create_variants handed you the original post's " +
+        description: "Figures are checked against what nooticr returned in this session: its own numbers are drawn, " +
+            "and a row it never returned is drawn marked as unchecked, so there is no need to re-type them exactly. " +
+            "Display the post variants you wrote after create_variants handed you the original post's " +
             "material. Free, and makes no requests — it only draws what you pass it: each variant's hook, " +
             "the angle that changes, its shot beats and its call to action. Call this after you have " +
             "written the variants, not instead of writing them.",
@@ -1960,11 +1997,23 @@ export function createMcpServer(rawMakeClient, opts) {
         })
             .strict(),
     }, async (args) => {
+        const checked = ledger.checkPosts([
+            {
+                ...(args.post ?? { platform: platformFromUrl(args.sourceUrl) }),
+                externalUrl: args.post?.externalUrl ?? args.sourceUrl,
+            },
+        ]);
         return {
-            content: [{ type: "text", text: `Showing ${args.variants.length} variants of ${args.sourceUrl}.` }],
+            content: [
+                {
+                    type: "text",
+                    text: `Showing ${args.variants.length} variants of ${args.sourceUrl}. ${checked.verification.note}`,
+                },
+            ],
             structuredContent: {
                 sourceUrl: args.sourceUrl,
-                post: args.post ?? { platform: platformFromUrl(args.sourceUrl), externalUrl: args.sourceUrl },
+                post: checked.rows[0],
+                verification: checked.verification,
                 variants: args.variants,
                 mcpCredits: { cost: 0 },
             },

package/dist/shared/ui-template.js

@@ -66,7 +66,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.",
@@ -102,9 +103,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 ───
@@ -3464,7 +3466,24 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
   // after it — one wrapper instead of a call at each of the many early
   // returns below.
   function render(result){
-    try{renderView(result);}finally{initPlayers();setTimeout(reportSize,80);}
+    try{renderView(result);verificationBanner(result);}finally{initPlayers();setTimeout(reportSize,80);}
+  }
+
+  // #107: a show_* view whose rows could not all be matched to what nooticr
+  // returned this session says so above the card. The marketplace card draws
+  // its own. Only the unverified case is drawn: a banner on every honest card
+  // would be noise that trains a reader to skip it.
+  function verificationBanner(result){
+    var d=extractResult(result);
+    if(!d||typeof d!=="object"||d.marketplace)return;
+    var v=d.verification;
+    if(!v||v.status!=="unverified")return;
+    var app=document.getElementById("app");if(!app)return;
+    var b=document.createElement("div");
+    b.setAttribute("data-verification","unverified");
+    b.style.cssText="font-size:12px;padding:8px 10px;margin:0 0 10px;border-radius:8px;border:1px solid var(--border);background:rgba(180,35,24,.06)";
+    b.innerHTML="<b>Not checked against nooticr</b> · "+esc(v.note||"");
+    app.insertBefore(b,app.firstChild);
   }
 
   // ─── Own account ───

package/package.json

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