@nooticr/mcp 1.26.78 → 1.26.79

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-118 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+119 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
@@ -168,6 +168,7 @@ a `scanId` for the rest.
 | `get_amazon_product` | 3 | One listing by ASIN or URL: price, rating, the full star histogram, features, specs, Amazon's review digest and aspect breakdown, and the reviews. |
 | `scan_marketplace_category` | 3 per product collected (30 by default) | The same category read on eleven more sites — AliExpress, Cdiscount, Flipkart, Mercado Libre, Lazada, Otto, Rakuten, Trendyol, Jumia, Vinted and Temu. Vinted is resale rather than retail, so its `rating` describes the seller and the scan says so in `ratingScope` — do not read it as a product's reviews. `marketplace` picks the site; `market` picks the storefront for the sites that have several, and the argument names the real set per site so a model cannot send Otto a Lazada region. Same rollup, same confirmation before spending. |
 | `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_price_history` | free | One product's `price` over time, or its `rating`, `reviewCount` or `availability` with `metric`, from the observations stored each time it was scanned. `marketplace` and `id` name it as `get_marketplace_product` does; `from`/`to` default to the last 30 days. Returns the points oldest first with min, max, first, last and the change from first to last. Reads stored data only; a product never scanned answers `recorded: false`. |
 | `marketplace_changes` | free | What moved in a category since the previous scan of the same `marketplace` and `query`: products that entered or left the results and ones whose price or place changed. Read from the two latest stored scans, so it fetches nothing; a category scanned once says it has no earlier run. |
 | `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. |

package/dist/shared/loading-plans.js

@@ -438,6 +438,7 @@ export const LOADING_PLANS = {
     },
     // Free: reads two stored scans, fetches nothing.
     marketplace_changes: { label: "Comparing the two scans", kind: "list", n: 6, steps: [], free: true },
+    get_price_history: { label: "Reading the stored price history", kind: "text", n: 1, steps: [], free: true },
     get_marketplace_product: {
         label: "Reading the product",
         kind: "text",

package/dist/shared/marketplace.js

@@ -439,6 +439,53 @@ export function registerMarketplaceTools(server, makeClient) {
             return toolError("marketplace_changes failed", err);
         }
     });
+    server.registerTool("get_price_history", {
+        title: "Get Price History",
+        description: "One product's price over time — or its rating, review count or availability with `metric` — " +
+            "from the observations stored each time the product was scanned. `marketplace` and `id` name " +
+            "the product the same way get_marketplace_product does; `from` and `to` take dates (default: " +
+            "the last 30 days). Returns the points oldest first with min, max, first, last and the " +
+            "percentage change from first to last. A point is stored only when something changed, so the " +
+            "last value held until `lastSeenAt`. Reads stored data only: it never fetches, and a product " +
+            "nobody has scanned yet says so (`recorded: false`) — run get_marketplace_product once to " +
+            "start its record. Free.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        outputSchema: OUTPUT_SCHEMAS.get_price_history,
+        inputSchema: z
+            .object({
+            marketplace: marketplaceArg,
+            id: z.string().describe("The site's own product id, or a product URL from it."),
+            market: z.string().optional().describe("The storefront the product is on, if the site has several."),
+            from: z
+                .string()
+                .optional()
+                .describe("Start of the window, as a date (2026-09-01) or an ISO timestamp. Default: 30 days before `to`."),
+            to: z.string().optional().describe("End of the window, inclusive. Default: now."),
+            metric: z.enum(["price", "rating", "reviewCount", "availability"]).optional().describe("What to chart (default price)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        const m = marketOf(args.marketplace);
+        if (!m)
+            return toolError("get_price_history failed", new Error(`unknown marketplace — one of ${SLUGS}`));
+        try {
+            const res = await client.callTool("get_price_history", args);
+            const payload = structured(res);
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            return toolError("get_price_history failed", err);
+        }
+    });
     server.registerTool("get_marketplace_product", {
         title: "Get Marketplace Product",
         _meta: viewMeta("get_marketplace_product"),

package/dist/shared/output-schemas.js

@@ -1832,6 +1832,27 @@ export const OUTPUT_SCHEMAS = {
         })),
         note: scalar(),
     }),
+    // One product's stored observations as a series (nooticr-server marketplace_history.rs), drawn by no view yet.
+    // min/max/deltaPct are absent for availability; an unknown product answers recorded: false.
+    get_price_history: open({
+        recorded: scalar(),
+        metric: scalar(),
+        series: listOf(open({ t: scalar(), value: scalar(), currency: scalar(), priceText: scalar() })),
+        count: scalar(),
+        first: scalar(),
+        last: scalar(),
+        min: scalar(),
+        max: scalar(),
+        deltaPct: scalar(),
+        currency: scalar(),
+        mixedCurrencies: scalar(),
+        truncated: scalar(),
+        title: scalar(),
+        url: scalar(),
+        lastSeenAt: scalar(),
+        billable: scalar(),
+        note: scalar(),
+    }),
     get_marketplace_product: open({
         ...marketplaceScanShape,
         product: amazonProduct.nullish().describe("The single product, also present as products[0]."),

package/dist/shared/tools-def.js

@@ -678,6 +678,12 @@ export const TOOL_DEFINITIONS = [
         description: "What moved in a category since the run before: products that entered or left a search's results, and ones whose price or place changed. Compared from the two latest stored scans of the same marketplace and `query`, so it fetches nothing and never re-scans — run scan_marketplace_category first, and again later, to have two runs to compare. `new` and `gone` mean entered or left the results, not listed or delisted. A category scanned only once has no earlier run and says so. Free.",
         inputSchema: z.object({ marketplace: z.string().describe("Which site the scan read."), query: z.string().describe("The category search to compare, exactly as it was scanned."), market: z.string().optional().describe("The storefront the scan read, if the site has several.") }).strict(),
     },
+    {
+        name: "get_price_history",
+        title: "Get Price History",
+        description: "One product's price over time — or its rating, review count or availability with `metric` — from the observations stored each time the product was scanned. `marketplace` and `id` name the product the same way get_marketplace_product does; `from` and `to` take dates (default: the last 30 days). Returns the points oldest first with min, max, first, last and the percentage change from first to last. A point is stored only when something changed, so the last value held until `lastSeenAt`. Reads stored data only: it never fetches, and a product nobody has scanned yet says so (`recorded: false`) — run get_marketplace_product once to start its record. Free.",
+        inputSchema: z.object({ marketplace: z.string().describe("Which site the product is on."), id: z.string().describe("The site's own product id, or a product URL from it."), market: z.string().optional().describe("The storefront the product is on, if the site has several."), from: z.string().optional().describe("Start of the window, as a date (2026-09-01) or an ISO timestamp. Default: 30 days before `to`."), to: z.string().optional().describe("End of the window, inclusive. Default: now."), metric: z.enum(["price", "rating", "reviewCount", "availability"]).optional().describe("What to chart (default price).") }).strict(),
+    },
     {
         name: "get_marketplace_product",
         title: "Get Marketplace Product",

package/dist/shared/tools.js

@@ -36,7 +36,7 @@ import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 import { DEFAULT_NOOTICR_SETTINGS, DEFAULT_SOCIAL_PLATFORMS, MemorySettingsStore, SETTINGS_READ_TOOL, SETTINGS_UPDATE_TOOL, settingsOwnerFromAuth, } from "./settings.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.78";
+export const MCP_SERVER_VERSION = "1.26.79";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */

package/package.json

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