@nooticr/mcp 1.26.31 → 1.26.33

package/README.md

@@ -80,9 +80,9 @@ them caps that fan-out with an argument.
 | `understand_social_post` | 3 | The same two fetches, asked for a description of what physically happens on screen rather than why it works. Use when you need the events, not the strategy. |
 | `analyze_comments` | 2 | The comment section, every comment with a stable id, and the taxonomy to label them with — sentiment, and whether each is praise, a complaint, a bug report, a question, a request, a comparison or spam. The same `get_post_comments` call, at the same price as reading them directly. |
 | `show_comment_review` | free | Draws the classifications your model produced — every comment with its sentiment and category, filterable and selectable. Makes no requests; it only renders what you pass it. |
-| `show_analysis` | free | Draws the analysis your model wrote from `analyze_post`/`analyze_post_fast`/`understand_social_post` — hook strength, script structure, quotable lines, suggested hashtags and more, whichever fields you produced. Makes no requests; it only renders what you pass it. |
+| `show_post_analysis` | free | Draws the analysis your model wrote from `analyze_post`/`analyze_post_fast`/`understand_social_post` — hook strength, script structure, quotable lines, suggested hashtags and more, whichever fields you produced. Makes no requests; it only renders what you pass it. |
 | `compare_posts` | 1 | The first of two to five posts, fetched with its stats, and the comparison left to you. Fetch the rest with `get_social_media` at 1 credit each. Use when performance differs and you need to know why. |
-| `show_comparison` | free | Draws the comparison your model wrote from `compare_posts` — each post scored, the winner marked, what differed and the next test worth running. Makes no requests; it only renders what you pass it. |
+| `show_compared_posts` | free | Draws the comparison your model wrote from `compare_posts` — each post scored, the winner marked, what differed and the next test worth running. Makes no requests; it only renders what you pass it. |
 
 ### Research a niche or a creator
 

package/dist/shared/evidence-digest.js

@@ -94,7 +94,20 @@ function postLine(row) {
         .join(" · ");
     const text = clamp(str(row.caption) || str(row.title) || str(row.text));
     const url = str(row.externalUrl) || str(row.url);
-    return [head && `[${head}]`, text, url].filter(Boolean).join("\n  ");
+    // Replies under the post, when something opened it. Nested one level down,
+    // which is exactly where #59 could come back without the chain-map gate
+    // noticing: `posts` is rendered, so the check is satisfied while the thing
+    // that was paid for — the comment that says "same here, this is my problem"
+    // — stays in the payload only.
+    const replies = Array.isArray(row.commentSample) ? row.commentSample : [];
+    const shown = replies.slice(0, 4).map((c) => `    - ${clamp(commentLine(c), 240)}`);
+    if (replies.length > shown.length) {
+        shown.push(`    - (${replies.length - shown.length} more under this post)`);
+    }
+    const readNothing = row.commentsRead === 0 ? "    - (this thread would not open — not that nobody replied)" : "";
+    return [head && `[${head}]`, text, url, ...shown, readNothing]
+        .filter(Boolean)
+        .join("\n  ");
 }
 /**
  * One comment, with its id.

package/dist/shared/evidence.js

@@ -204,7 +204,7 @@ export const EVIDENCE_PLANS = {
             "what moved while it was there, so do not describe motion you have not",
             "seen across two frames.",
             "",
-            "When you are done, call show_analysis with the url and your analysis —",
+            "When you are done, call show_post_analysis with the url and your analysis —",
             "it draws what you found (hook strength, script structure, quotable",
             "lines, suggested hashtags, target audience and whichever other fields",
             "you produced) so it is visible, not only said in chat.",
@@ -239,7 +239,7 @@ export const EVIDENCE_PLANS = {
                 "not what moved during it, so describe stills unless two frames actually",
                 "show the change.",
                 "",
-                "When you are done, call show_analysis with the url and your analysis —",
+                "When you are done, call show_post_analysis with the url and your analysis —",
                 "it draws what you found so it is visible, not only said in chat.",
                 ownIt,
             ].join("\n");
@@ -259,7 +259,7 @@ export const EVIDENCE_PLANS = {
             "yourself and look at the frames — do not ask anyone else to fetch",
             "them for you.",
             "",
-            "When you are done, call show_analysis with the url and your analysis —",
+            "When you are done, call show_post_analysis with the url and your analysis —",
             "it draws what you found so it is visible, not only said in chat.",
             ownIt,
         ].join("\n"),
@@ -274,7 +274,7 @@ export const EVIDENCE_PLANS = {
             "which performed better, what actually differed, and the single test",
             "worth running next. Ground every difference in a number or a quote.",
             "",
-            "When you are done, call show_comparison with all the posts (same shape",
+            "When you are done, call show_compared_posts with all the posts (same shape",
             "get_social_media returned for each) and your comparison — it draws a",
             "scoreboard with the winner marked, so the comparison is visible, not",
             "only said in chat.",

package/dist/shared/jobs.js

@@ -2112,6 +2112,15 @@ export function registerJobTools(server, makeClient, store) {
                 .optional()
                 .describe("Where to look (default reddit). Each one is a separate paid search."),
             limit: z.number().int().optional().describe("Posts per query shape (default 6, max 15)."),
+            readComments: z
+                .boolean()
+                .optional()
+                .describe("Open the most promising results and read their comments too (default false). " +
+                "On Reddit especially, the person with the problem is at least as often replying " +
+                "under someone else's thread as posting their own, and a post-only search cannot " +
+                "see any of them. Costs 2 nooticr credits per post opened, up to 5 — and they are " +
+                "opened on the MERGED, deduped results, so it is five extra calls in total rather " +
+                "than five per query shape per platform."),
             queries: z
                 .array(z.string())
                 .optional()
@@ -2181,6 +2190,41 @@ export function registerJobTools(server, makeClient, store) {
                 }
             }
         }
+        // Read the comments under the most promising results, on the MERGED,
+        // deduped list rather than per search.
+        //
+        // That distinction is the whole reason this lives here and not in the
+        // backend's own `includeComments`: three query shapes across two
+        // platforms is six searches, and opening five posts under each would be
+        // thirty paid calls for a tool whose description promises a wide CHEAP
+        // net. On the merged list it is five, once.
+        //
+        // Why at all: on Reddit the person with the problem is at least as often
+        // replying under someone else's thread as posting their own, and a
+        // post-only search cannot see any of them (Nooticr/nooticr-server#63).
+        if (args.readComments && posts.length) {
+            const OPEN = 5;
+            for (const post of posts.slice(0, OPEN)) {
+                const url = String(post.externalUrl ?? post.url ?? "");
+                if (!url)
+                    continue;
+                try {
+                    const res = await client.callTool("get_post_comments", { url, limit: 8 });
+                    const structured = (res.structured ?? {});
+                    spend.record("get_post_comments", structured);
+                    const comments = Array.isArray(structured.comments) ? structured.comments : [];
+                    post.commentsRead = comments.length;
+                    post.commentSample = comments;
+                }
+                catch {
+                    // A thread that will not open is not a failed sweep — the post's
+                    // own text may carry the complaint, and this is the cheap net.
+                    // Stated rather than left absent, so a reader can tell "no
+                    // comments" from "not looked at".
+                    post.commentsRead = 0;
+                }
+            }
+        }
         if (!posts.length) {
             return evidence([
                 `Nothing came back for "${problem}" on ${platforms.join(", ")}.`,
@@ -2223,6 +2267,17 @@ export function registerJobTools(server, makeClient, store) {
                 "and say how many you rejected and why — a shortlist with no reject count reads as if " +
                 "the search was precise.",
             "",
+            args.readComments
+                ? "The first few posts carry `commentSample`: the replies underneath them. Judge those " +
+                    "the same way — a person saying \"same here, this is exactly my problem\" under " +
+                    "someone else's thread is a better find than the thread itself, and the permalink " +
+                    "to quote is the post's. `commentsRead: 0` means the thread would not open, not " +
+                    "that nobody replied."
+                : "Only the posts themselves were searched. On Reddit the person with the problem is " +
+                    "at least as often replying under someone else's thread as posting their own — if " +
+                    "these results look thin, call again with `readComments: true` to open the top few " +
+                    "and read what is underneath.",
+            "",
             args.queries?.length
                 ? "`foundBy` says which of your own phrasings surfaced each post, in the order you " +
                     "gave them."

package/dist/shared/loading-plans.js

@@ -320,8 +320,8 @@ export const LOADING_PLANS = {
     // The show_* family renders the model's own output. A wait here is brief
     // and free, but it still says which, because "nothing is happening" and
     // "this is free and instant" look identical on a blank screen.
-    show_analysis: { label: "Drawing the reading", kind: "text", n: 1, steps: [], free: true },
-    show_comparison: { label: "Drawing the comparison", kind: "strip", n: 2, steps: [], free: true },
+    show_post_analysis: { label: "Drawing the reading", kind: "text", n: 1, steps: [], free: true },
+    show_compared_posts: { label: "Drawing the comparison", kind: "strip", n: 2, steps: [], free: true },
     show_hooks: { label: "Laying out the hooks", kind: "list", n: 5, steps: [], free: true },
     show_variants: { label: "Laying out the variants", kind: "list", n: 4, steps: [], free: true },
     show_repurposed_post: { label: "Laying out the rewrites", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/output-schemas.js

@@ -418,7 +418,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 +429,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, " +

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(),
@@ -394,7 +394,7 @@ export const TOOL_DEFINITIONS = [
         name: "find_people_with_problem",
         title: "Find People With A Problem",
         description: "Find people describing a problem in their own words — prospects, early users, anyone whose complaint your product answers. Say the problem the way a person would say it (\"I spend hours checking competitors by hand\") and this searches for posts shaped like that complaint, not for the topic it is about. That difference is the point: searching the TOPIC finds marketing about it, which is what discover_social_posts is for. Widens the query into the forms a complaint takes — the plain phrasing, the does-anyone-else question, the is-there-a-tool ask — and merges what each returns. It is a wide cheap net and NOT a filter: the posts come back for you to judge, and many will be off-target. Consumes 2 nooticr credits per platform searched. Defaults to reddit, where people describe workflow pain in sentences; add twitter for volume.",
-        inputSchema: z.object({ problem: z.string().describe("The problem in a person's own words, not a topic. \"I waste an hour a day checking what competitors posted\" finds people; \"competitor analysis\" finds marketing about competitor analysis."), platforms: z.array(z.enum(["reddit", "twitter", "youtube", "tiktok", "instagram", "linkedin"])).optional().describe("Where to look (default reddit). Each one is a separate paid search."), limit: z.number().int().optional().describe("Posts per query shape (default 6, max 15)."), queries: z.array(z.string()).optional().describe("Search these exact phrasings instead of the ones derived from `problem` (max 4). You are better at this than a string template is: write how a person would actually word the complaint on the network being searched \u2014 a Reddit title, an X post \u2014 and keep each one short, because this is a keyword search and a long sentence matches on its commonest words.") }).strict(),
+        inputSchema: z.object({ problem: z.string().describe("The problem in a person's own words, not a topic. \"I waste an hour a day checking what competitors posted\" finds people; \"competitor analysis\" finds marketing about competitor analysis."), platforms: z.array(z.enum(["reddit", "twitter", "youtube", "tiktok", "instagram", "linkedin"])).optional().describe("Where to look (default reddit). Each one is a separate paid search."), limit: z.number().int().optional().describe("Posts per query shape (default 6, max 15)."), readComments: z.boolean().optional().describe("Open the most promising results and read their comments too (default false). On Reddit especially, the person with the problem is at least as often replying under someone else's thread as posting their own, and a post-only search cannot see any of them. Costs 2 nooticr credits per post opened, up to 5 \u2014 and they are opened on the MERGED, deduped results, so it is five extra calls in total rather than five per query shape per platform."), queries: z.array(z.string()).optional().describe("Search these exact phrasings instead of the ones derived from `problem` (max 4). You are better at this than a string template is: write how a person would actually word the complaint on the network being searched \u2014 a Reddit title, an X post \u2014 and keep each one short, because this is a keyword search and a long sentence matches on its commonest words.") }).strict(),
     },
     {
         name: "search_spoken_mentions",

package/dist/shared/tools.js

@@ -26,7 +26,7 @@ import { loadingPlansJson } from "./loading-plans.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.31";
+export const MCP_SERVER_VERSION = "1.26.33";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -407,9 +407,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 +561,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",
@@ -1426,8 +1426,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 +1547,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 +1555,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 +1600,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 +1608,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."),

package/package.json

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