@nooticr/mcp 1.26.32 → 1.26.34

package/dist/shared/output-schemas.js

@@ -225,6 +225,65 @@ const analyzed = { ...singlePost, analysis, analyzed: scalar() };
  * One entry per tool. A tool missing from here declares nothing, which is the
  * honest option when the shape has not been checked against a real response.
  */
+/**
+ * One Amazon listing, as the scan hands it over.
+ *
+ * `aspects` and `reviewSummary` are Amazon's own, not ours, and they are the
+ * half of a listing that survives the sign-in gate which withholds review
+ * bodies — so they are declared beside `reviews` rather than folded into it.
+ */
+const amazonProduct = open({
+    asin: scalar(),
+    url: scalar(),
+    title: scalar(),
+    brand: scalar(),
+    price: scalar(),
+    priceValue: scalar(),
+    listPrice: scalar(),
+    availability: scalar(),
+    rating: scalar(),
+    ratingCount: scalar(),
+    image: scalar(),
+    images: listOf(z.string()),
+    features: listOf(z.string()),
+    categories: listOf(z.string()),
+    specs: open({}).nullish(),
+    ratingHistogram: open({}).nullish().describe("Star bucket to share, e.g. {\"5\": \"73%\"}."),
+    reviewSummary: scalar().describe("Amazon's own digest of the reviews."),
+    aspects: listOf(open({ name: scalar(), mentions: scalar(), sentiment: scalar() })),
+    reviewsGated: scalar().describe("True when Amazon withheld the review bodies behind sign-in."),
+    reviews: anyList(),
+});
+/** One thing you concluded, with what it rests on. */
+const amazonFinding = open({
+    label: scalar(),
+    detail: scalar(),
+    evidence: listOf(z.string()).describe("Review ids or short quotes."),
+    strength: scalar().describe("strong / moderate / thin — how well the collected text supports it."),
+});
+const amazonScanShape = {
+    guidance: scalar(),
+    mode: scalar(),
+    marketplace: scalar(),
+    scanId: scalar().describe("Pass to amazon_scan_status to pick a running collection back up."),
+    status: scalar(),
+    complete: scalar().describe("False means more listings are still coming."),
+    query: scalar(),
+    domain: scalar(),
+    progress: open({
+        done: scalar(),
+        total: scalar(),
+        message: scalar(),
+        elapsedMs: scalar(),
+        fromCache: scalar(),
+    }).nullish(),
+    rollup: open({}).nullish().describe("The arithmetic over the set: price and rating spread, aspects by brand, 1-2 star share."),
+    products: listOf(amazonProduct),
+    reviews: anyList().describe("Every review across the scan, worst-rated first — the barriers are the half a summary drops."),
+    errors: anyList(),
+    mcpCredits,
+};
+const amazonScan = open(amazonScanShape);
 export const OUTPUT_SCHEMAS = {
     analyze_post: open({ ...analyzed, ...evidence }),
     analyze_post_fast: open({ ...evidence, ...analyzed }),
@@ -418,7 +477,7 @@ export const OUTPUT_SCHEMAS = {
     // thinking" (README) — but until these existed, the thinking had nowhere
     // to land except chat text. Free, and make no requests, same as
     // show_comment_review: they only draw what they're handed.
-    show_comparison: open({
+    show_compared_posts: open({
         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."),
@@ -429,7 +488,7 @@ export const OUTPUT_SCHEMAS = {
         }).nullish(),
         mcpCredits,
     }),
-    show_analysis: open({
+    show_post_analysis: open({
         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, " +
@@ -1288,4 +1347,29 @@ export const OUTPUT_SCHEMAS = {
         connectUrl: scalar().describe("Open this in a browser to approve the connection."),
         message: scalar(),
     }),
+    // Marketplace. One shape for all three collection tools: a status poll
+    // returns exactly what the scan that started it returns, and a single
+    // product is a scan of one — describing them differently would be three
+    // names for one payload and three places for the view to drift.
+    scan_amazon_category: amazonScan,
+    amazon_scan_status: amazonScan,
+    get_amazon_product: open({
+        ...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, passed through so the view can draw them."),
+        rollup: open({}).nullish(),
+        scanId: scalar(),
+        mcpCredits,
+    }),
 };

package/dist/shared/tools-def.js

@@ -157,13 +157,13 @@ export const TOOL_DEFINITIONS = [
         inputSchema: z.object({ url: z.string().describe("The post the comments came from."), summary: z.string().optional(), title: z.string().optional(), comments: z.array(z.object({ id: z.string(), text: z.string(), author: z.string().optional(), likes: z.number().optional(), sentiment: z.string().optional(), category: z.string().optional(), note: z.string().optional() })), themes: z.array(z.string()).optional(), nextSteps: z.array(z.string()).optional() }).strict(),
     },
     {
-        name: "show_comparison",
+        name: "show_compared_posts",
         title: "Show Comparison",
         description: "Display a comparison you wrote after compare_posts fetched the first post and you fetched the rest yourself. 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 comparing, not instead of it.",
         inputSchema: z.object({ posts: z.array(z.object({}).passthrough()).min(2).max(5), winner: z.number().int(), winnerReason: z.string().optional(), differences: z.array(z.object({ factor: z.string(), detail: z.string() })).optional(), lessons: z.array(z.string()).optional(), nextTest: z.string().optional() }).strict(),
     },
     {
-        name: "show_analysis",
+        name: "show_post_analysis",
         title: "Show Analysis",
         description: "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, not instead of it.",
         inputSchema: z.object({ url: z.string(), post: z.object({}).passthrough().optional(), analysis: z.object({}).passthrough() }).strict(),
@@ -414,4 +414,28 @@ export const TOOL_DEFINITIONS = [
         description: "Patch your own product's fields \u2014 omitted arguments leave their column unchanged, so this cannot blank a field by not mentioning it. Takes appId, optional when your workspace has exactly one product; every other field is snake_case, the same names create_product takes and read the same way. The result lists which fields were actually written, so a name you spelled wrong shows up as a field that did not change rather than as a silent no-op. Free \u2014 no AI call, just a row.",
         inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-product workspace."), name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), website_url: z.string().optional(), niche: z.string().optional(), product_type: z.string().optional(), icon_url: z.string().optional(), primary_cta_label: z.string().optional(), primary_cta_url: z.string().optional(), external_listing_id: z.string().optional(), ios_bundle_id: z.string().optional(), android_package: z.string().optional() }).strict(),
     },
+    {
+        name: "scan_amazon_category",
+        title: "Scan Amazon Category",
+        description: "Collect an Amazon category and read it: listings with prices, star histograms, Amazon's own review-aspect counts and the review text itself, plus the arithmetic over them (price spread, rating spread, which aspects recur across how many brands, and the share of each listing's ratings sitting at 1-2 stars). Pass query to search the category, asins to pin named competitors, or both \u2014 named competitors keep their place at the front. You write the read: purchase drivers, barriers, what the incumbents do well, the gaps, and how a new entrant could position; show_amazon_category_insights draws it for free afterwards. Collection runs in the background, so this returns everything ready within waitSeconds plus a scanId to continue with amazon_scan_status. Consumes 3 nooticr credits per listing collected \u2014 a listing with reviews is a real browser render behind Amazon's bot defences.",
+        inputSchema: z.object({ query: z.string().optional().describe("Category or keyword to search on Amazon, e.g. 'ashwagandha gummies'."), asins: z.array(z.string()).optional().describe("Named competitors: ASINs or any Amazon product URL. Kept at the front of the set."), limit: z.number().int().optional().describe("Listings to collect (default 10, max 50)."), reviews: z.boolean().optional().describe("Collect review text too (default true)."), domain: z.string().optional().describe("Marketplace host, e.g. www.amazon.co.uk (default www.amazon.com)."), waitSeconds: z.number().int().optional().describe("How long to wait before returning partial results (default 90, max 240)."), focus: z.string().optional().describe("An extra question to answer from the reviews.") }).strict(),
+    },
+    {
+        name: "amazon_scan_status",
+        title: "Amazon Scan Status",
+        description: "Pick up a scan_amazon_category collection that was still running, by scanId \u2014 the listings and reviews collected since, with the same rollup and the same instructions for reading them. Free: it is the poll scan_amazon_category asked for, and charging for the second half of one answer would bill a wait this server chose. Call it when a scan came back incomplete, then write your read from the full set.",
+        inputSchema: z.object({ scanId: z.string().describe("The scanId scan_amazon_category returned."), waitSeconds: z.number().int().optional().describe("How long to wait for more listings before answering (default 30, max 240)."), focus: z.string().optional().describe("Same optional steer as scan_amazon_category.") }).strict(),
+    },
+    {
+        name: "get_amazon_product",
+        title: "Get Amazon Product",
+        description: "Fetch one Amazon listing by ASIN or URL: price, rating, the full star histogram, features, specs, Amazon's review digest and aspect breakdown, and the review text. Use for a single product; for a category or a competitive set, scan_amazon_category collects many in one job and rolls them up. Consumes 3 nooticr credits.",
+        inputSchema: z.object({ asin: z.string().optional().describe("ASIN, or a full Amazon product URL."), url: z.string().optional().describe("Full Amazon product URL, if you have that instead."), reviews: z.boolean().optional().describe("Collect review text too (default true)."), domain: z.string().optional().describe("Marketplace host (default www.amazon.com).") }).strict(),
+    },
+    {
+        name: "show_amazon_category_insights",
+        title: "Show Amazon Category Insights",
+        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. Free, and makes no requests: it only draws what you pass it, 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(),
+    },
 ];

package/dist/shared/tools.js

@@ -25,8 +25,9 @@ import { registerConnectionTools } from "./connections.js";
 import { loadingPlansJson } from "./loading-plans.js";
 import { registerHandoff } from "./handoff.js";
 import { registerCollabTools } from "./collab.js";
+import { registerAmazonTools } from "./amazon.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.32";
+export const MCP_SERVER_VERSION = "1.26.34";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -407,9 +408,9 @@ async function runEvidence(tool, args, client) {
     //
     // Measured before changing it, over 59 real runs of the quest suite: 0
     // guidance phrases across 175 tool results. `analyze_post` handed back frames,
-    // a transcript and 2,000 characters ending in "call show_analysis when you are
+    // a transcript and 2,000 characters ending in "call show_post_analysis when you are
     // done"; the model wrote the analysis and delivered it in chat, and
-    // show_analysis was called in 1 run of 12.
+    // show_post_analysis was called in 1 run of 12.
     //
     // The text block stays for hosts that honour it (and for the images, which
     // must sit in `content`). `guidance` on the payload is what reaches the rest.
@@ -561,8 +562,8 @@ export function createMcpServer(rawMakeClient, opts) {
         // Close the loop the evidence-only tools open: your own analysis/hooks/
         // variants/repurposing/comparison, drawn — same shape as
         // show_comment_review, free and no requests.
-        "show_comparison",
-        "show_analysis",
+        "show_compared_posts",
+        "show_post_analysis",
         "show_hooks",
         "show_variants",
         "show_repurposed_post",
@@ -627,6 +628,12 @@ export function createMcpServer(rawMakeClient, opts) {
         // grant each connection carries is a table, which is what a view is for.
         "list_social_connections",
         "connect_social_account",
+        // Marketplace. All four draw: the three collection tools render the
+        // listings and their reviews, and the view draws the read on top of them.
+        "scan_amazon_category",
+        "amazon_scan_status",
+        "get_amazon_product",
+        "show_amazon_category_insights",
     ];
     // Human-readable resource name per tool (used in resources/list + tools/list).
     function resourceName(tool) {
@@ -706,6 +713,12 @@ export function createMcpServer(rawMakeClient, opts) {
         // LinkedIn
         "https://*.licdn.com",
         "https://*.linkedin.com",
+        // Amazon product images. Listings serve from m.media-amazon.com and, on
+        // older listings, images-na.ssl-images-amazon.com — a listing whose picture
+        // is blocked draws as a brand initial, which is a worse comparison screen
+        // than the one the scan paid for.
+        "https://*.media-amazon.com",
+        "https://*.ssl-images-amazon.com",
     ];
     const apiUrl = process.env.NOOTICR_API_URL || process.env.NOOTICR_BASE_URL;
     if (apiUrl && apiUrl.trim()) {
@@ -1426,8 +1439,8 @@ export function createMcpServer(rawMakeClient, opts) {
     // the plain post card it started on. Same shape as show_comment_review in
     // every way that matters: free, no requests, draws only what it is
     // handed. Each one's structuredContent is built to match an existing view
-    // ui-template.ts already renders (show_comparison → the comparison
-    // scoreboard, show_analysis → analysisCard) or a new one added alongside
+    // ui-template.ts already renders (show_compared_posts → the comparison
+    // scoreboard, show_post_analysis → analysisCard) or a new one added alongside
     // it (show_hooks, show_variants, show_repurposed_post).
     server.registerTool("show_trend", {
         title: "Show Trend",
@@ -1547,7 +1560,7 @@ export function createMcpServer(rawMakeClient, opts) {
             },
         };
     });
-    server.registerTool("show_comparison", {
+    server.registerTool("show_compared_posts", {
         title: "Show Comparison",
         description: "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 " +
@@ -1555,12 +1568,12 @@ export function createMcpServer(rawMakeClient, opts) {
             "strengths and the next experiment worth running. Call this after you have done the " +
             "comparing, not instead of it.",
         _meta: {
-            ui: { resourceUri: uiResource("show_comparison") },
-            "ui/resourceUri": uiResource("show_comparison"),
-            "openai/outputTemplate": appsSdkResource("show_comparison"),
+            ui: { resourceUri: uiResource("show_compared_posts") },
+            "ui/resourceUri": uiResource("show_compared_posts"),
+            "openai/outputTemplate": appsSdkResource("show_compared_posts"),
         },
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-        outputSchema: OUTPUT_SCHEMAS.show_comparison,
+        outputSchema: OUTPUT_SCHEMAS.show_compared_posts,
         inputSchema: z
             .object({
             posts: z
@@ -1600,7 +1613,7 @@ export function createMcpServer(rawMakeClient, opts) {
             },
         };
     });
-    server.registerTool("show_analysis", {
+    server.registerTool("show_post_analysis", {
         title: "Show Analysis",
         description: "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 " +
@@ -1608,12 +1621,12 @@ export function createMcpServer(rawMakeClient, opts) {
             "more, whichever of these you actually produced. Call this after you have done the analysing, " +
             "not instead of it.",
         _meta: {
-            ui: { resourceUri: uiResource("show_analysis") },
-            "ui/resourceUri": uiResource("show_analysis"),
-            "openai/outputTemplate": appsSdkResource("show_analysis"),
+            ui: { resourceUri: uiResource("show_post_analysis") },
+            "ui/resourceUri": uiResource("show_post_analysis"),
+            "openai/outputTemplate": appsSdkResource("show_post_analysis"),
         },
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
-        outputSchema: OUTPUT_SCHEMAS.show_analysis,
+        outputSchema: OUTPUT_SCHEMAS.show_post_analysis,
         inputSchema: z
             .object({
             url: z.string().describe("The post you analyzed."),
@@ -2351,5 +2364,9 @@ export function createMcpServer(rawMakeClient, opts) {
     // classified for a tracker on another server, the other draws what it scored.
     registerHandoff(server);
     registerCollabTools(server);
+    // Marketplace intelligence (amazon.ts): the category collection, the poll
+    // that picks it back up, a single listing, and the free view for the read
+    // the model writes out of them.
+    registerAmazonTools(server, makeClient);
     return server;
 }