@nooticr/mcp 1.26.19 → 1.26.20

package/dist/shared/evidence.js

@@ -36,6 +36,68 @@
  */
 import { BACKEND_CALL_CREDITS, costOf } from "./spend.js";
 const url = (a) => String(a.url ?? "");
+/**
+ * Platforms whose accounts can be found by NAME. This is the backend's
+ * search_creators enum, not a preference — no other network has a keyword
+ * search behind it, so on the rest a handle has to arrive from outside.
+ */
+export const NAME_SEARCHABLE = ["tiktok", "instagram", "xiaohongshu"];
+/**
+ * The `platform` argument description every tool sharing the silent tiktok
+ * default should use.
+ *
+ * Saying "default tiktok" was technically true and operationally useless: it
+ * reads as a harmless convenience rather than as the thing that will answer a
+ * question about X with TikTok data. The default cannot simply be removed —
+ * hosts already call these without it — so the description has to carry the
+ * warning instead.
+ */
+export const PLATFORM_ARG = "Platform. Defaults to tiktok, so SET IT whenever the user named a network — otherwise a " +
+    "question about X, LinkedIn or Reddit is silently answered with TikTok data, and an empty " +
+    "result looks like the account does not exist. Accepts what get_user_posts does: tiktok, " +
+    "instagram, youtube, douyin, xiaohongshu, twitter, bilibili, linkedin, reddit, weibo.";
+/**
+ * What to say when a handle lookup comes back empty.
+ *
+ * Written because of a real session: someone asked what a competitor was doing
+ * on X, the tool searched TikTok (the silent default), found nothing, offered
+ * to guess another TikTok handle, and gave up. Every part of that was the
+ * surface's fault. It never said which network it had searched, so the wrong
+ * one looked like an absent account; and an empty result carried no next step,
+ * so the only move left was to apologise.
+ *
+ * The fix is to be specific about what happened and to hand back the one step
+ * that actually works. We cannot search X, LinkedIn or Reddit by name — but the
+ * model calling us can search the open web, and `get_user_posts` will happily
+ * fetch any of them once it has the handle. So ask for that rather than
+ * substituting a network the user did not ask about.
+ */
+export function handleMissGuidance(a) {
+    const searchable = NAME_SEARCHABLE.includes(a.platform);
+    const lines = [
+        `No posts for @${a.handle} on ${a.platform}.`,
+        "",
+        a.defaulted
+            ? `Note that ${a.platform} was the default here — it was not asked for. If the user named a ` +
+                "different network, call this again with `platform` set to it before concluding anything: " +
+                "an empty result on the wrong network says nothing about the account they meant."
+            : `That is the network that was searched, so the account either does not exist there, is ` +
+                "private, or uses a different handle.",
+        "",
+        searchable
+            ? `${a.platform} can be searched by name: call search_creators with the brand or person as ` +
+                "the keyword to find the right handle, then come back."
+            : `${a.platform} cannot be searched by name here — there is no keyword index behind it, so ` +
+                "guessing handles will not converge. Find the account yourself with a web search, or ask " +
+                "the user for the handle or profile URL, then call this again with that. Do NOT quietly " +
+                "switch to a network you can search instead: answering about TikTok when the question " +
+                "was about X is worse than saying you need the handle.",
+        "",
+        "Say plainly that nothing was found and which network was checked. Do not present an empty " +
+            "result as evidence the competitor is inactive.",
+    ];
+    return lines.filter((l, i, all) => !(l === "" && all[i - 1] === "")).join("\n");
+}
 /** Closing line every guidance block shares. */
 export const ownIt = "Reason over this yourself rather than asking for an interpretation of it — " +
     "you can see everything the analysis would have been built from. Everything fetched here — " +

package/dist/shared/jobs.js

@@ -56,7 +56,7 @@
 import { z } from "zod";
 import { OUTPUT_SCHEMAS } from "./output-schemas.js";
 import { platformFromUrl, postSlug } from "./comment-review.js";
-import { ownIt } from "./evidence.js";
+import { handleMissGuidance, ownIt, PLATFORM_ARG } from "./evidence.js";
 import { confirmSpend, costOf, declinedResult, MAX_SPOKEN_HANDLE_CALLS, MAX_SPOKEN_TRANSCRIPTS, } from "./spend.js";
 import { distributionOf, excluding, numberOf, standing, } from "./performance.js";
 import { normaliseHandle, watchEntryId, watchlistOwner } from "./watchlist.js";
@@ -353,8 +353,12 @@ function audienceGuidance(a) {
 }
 function competitorGuidance(a) {
     const lines = [
-        `${a.shipped} recent post${a.shipped === 1 ? "" : "s"} by @${a.handle}, each scored against ` +
-            `that account's own median ${a.metric} rather than against anyone else's numbers.`,
+        // The network is named here, not just in the structured payload, because
+        // the platform argument defaults silently: without this line an answer
+        // about the wrong network is indistinguishable from the right one.
+        `${a.shipped} recent post${a.shipped === 1 ? "" : "s"} by @${a.handle} on ${a.platform}, each ` +
+            `scored against that account's own median ${a.metric} rather than against anyone else's ` +
+            "numbers.",
         "",
         a.baseline
             ? `Their median is ${Math.round(a.baseline.median).toLocaleString("en-US")} ${a.metric}, ` +
@@ -592,7 +596,7 @@ export function registerJobTools(server, makeClient, store) {
         inputSchema: z
             .object({
             username: z.string().describe("Your handle, with or without @."),
-            platform: z.string().optional().describe("Platform (default tiktok)."),
+            platform: z.string().optional().describe(PLATFORM_ARG),
             limit: z
                 .number()
                 .int()
@@ -790,8 +794,12 @@ export function registerJobTools(server, makeClient, store) {
         outputSchema: OUTPUT_SCHEMAS.track_competitor,
         inputSchema: z
             .object({
-            username: z.string().describe("Creator handle, with or without @."),
-            platform: z.string().optional().describe("Platform (default tiktok)."),
+            username: z
+                .string()
+                .describe("Creator handle, with or without @. This is a handle, not a brand name — if you " +
+                "only have a company name, find the handle first (search_creators on TikTok, " +
+                "Instagram or Xiaohongshu; a web search anywhere else)."),
+            platform: z.string().optional().describe(PLATFORM_ARG),
             limit: z.number().int().optional().describe("Posts in the window (default 12, max 30). One fetch either way."),
             metric: metricArg,
             since: z
@@ -804,6 +812,10 @@ export function registerJobTools(server, makeClient, store) {
     }, async (args, extra) => {
         const client = await makeClient({ ...extra, arguments: args });
         const handle = normaliseHandle(args.username);
+        // Whether the network was chosen or merely fallen back to. An empty
+        // result means something different in each case, and the caller cannot
+        // tell them apart unless we say which happened.
+        const platformDefaulted = !args.platform;
         const platform = (args.platform || "tiktok").toLowerCase();
         const cap = clamp(args.limit, 12, 1, 30);
         const metric = args.metric ?? "views";
@@ -818,6 +830,24 @@ export function registerJobTools(server, makeClient, store) {
         catch (err) {
             return failed("track_competitor could not list the posts", err);
         }
+        // Nothing came back. Previously this fell through to the scoring path and
+        // produced a baseline-less report about zero posts, which reads as "this
+        // competitor has been quiet" — a claim the tool has no evidence for.
+        if (feed.length === 0) {
+            return evidence(handleMissGuidance({ handle, platform, defaulted: platformDefaulted }), {
+                mode: "evidence",
+                tool: "track_competitor",
+                evidenceFrom: ["get_user_posts"],
+                username: handle,
+                platform,
+                platformDefaulted,
+                found: false,
+                posts: [],
+                unavailable: [],
+                creditsCharged: spend.credits,
+                mcpCredits: spend.payload,
+            });
+        }
         const windowed = applySince(feed, args.since);
         const posts = windowed.posts;
         const values = posts.map((p) => metricOf(p, metric));
@@ -867,6 +897,7 @@ export function registerJobTools(server, makeClient, store) {
         const newSince = previous ? scoredPosts.filter((p) => p.isNew === true).length : null;
         return evidence(competitorGuidance({
             handle,
+            platform,
             metric,
             shipped: scoredPosts.length,
             baseline,
@@ -1161,7 +1192,7 @@ export function registerJobTools(server, makeClient, store) {
         inputSchema: z
             .object({
             username: z.string().describe("Your handle, with or without @."),
-            platform: z.string().optional().describe("Platform (default tiktok)."),
+            platform: z.string().optional().describe(PLATFORM_ARG),
             niche: z
                 .string()
                 .optional()

package/dist/shared/tools.js

@@ -23,7 +23,7 @@ import { registerConnectionTools } from "./connections.js";
 import { registerHandoff } from "./handoff.js";
 import { registerCollabTools } from "./collab.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.19";
+export const MCP_SERVER_VERSION = "1.26.20";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */

package/dist/shared/watchlist.js

@@ -45,6 +45,7 @@
  */
 import { z } from "zod";
 import { confirmSpend, declinedResult, CREDITS_PER_CREATOR } from "./spend.js";
+import { PLATFORM_ARG } from "./evidence.js";
 export const WATCHLIST_URI = "nooticr://watchlist";
 /** Default, and what the tests use. Fine for a single process. */
 export class MemoryWatchStore {
@@ -448,7 +449,7 @@ export function registerWatchlist(server, makeClient, store) {
         inputSchema: z
             .object({
             username: z.string().describe("Creator handle, with or without @."),
-            platform: z.string().optional().describe("Platform (default tiktok)."),
+            platform: z.string().optional().describe(PLATFORM_ARG),
             note: z.string().optional().describe("Why you are watching them — shown back to you later."),
         })
             .strict(),
@@ -485,7 +486,7 @@ export function registerWatchlist(server, makeClient, store) {
         inputSchema: z
             .object({
             username: z.string().describe("Creator handle, with or without @."),
-            platform: z.string().optional().describe("Platform (default tiktok)."),
+            platform: z.string().optional().describe(PLATFORM_ARG),
         })
             .strict(),
         outputSchema: z

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.19",
+  "version": "1.26.20",
   "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)",
   "type": "module",
   "main": "dist/index.js",