@nooticr/mcp 1.26.42 → 1.26.43

package/README.md

@@ -52,10 +52,10 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-72 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+85 tools, grouped by what you are trying to do. Prices are in nooticr credits and
 match what the server actually charges.
 
-Seven of them — the ones under **Answer a question you actually have** — are not
+The job tools under **Answer a question you actually have** are not
 endpoint wrappers. Each names a job, fans out over the calls that job needs,
 groups the evidence by whatever you are deciding about, gives every item an id
 a follow-up tool can act on, and hands the reading to your model rather than to
@@ -191,6 +191,9 @@ Everything above reads someone else's content. These read and generate for **you
 | `get_scheduled_posts` | free | Your own scheduled and draft posts in the content pipeline — title, status, scheduled time, approval status. What is queued to publish. |
 | `get_post_performance` | free | Your own already-published posts with their engagement counters — views, likes, comments, shares, platform, post date. The raw performance history, not an interpretation of it; pair with `growth_brief` for that. |
 | `get_video_stats` | free | Your own most recently synced video performance stats across every connected creator — views, likes, comments, shares, plus a running total. Reads the last sync; does not trigger a new one. |
+| `get_google_analytics` | free | Your product's GA4 sync **as of its last sync into nooticr, not live** — property, date range, rows synced. The metrics feed `get_post_performance` and `growth_brief`. |
+| `get_search_console_data` | free | Search Console clicks, impressions and top queries, as of the last sync — whether people search for what your content is about. |
+| `get_posthog_analytics` | free | Your PostHog pageview trend, as of the last sync — line a post's date up against traffic to your site. |
 | `get_content_plan` | free | The saved weekly content plan for a product, if one has been generated. `plan: null` when none has. |
 | `get_brand_playbook` | free | Your product's brand playbook — name, description and the playbook text — if one has been configured, in the dashboard or by `analyze_product`. Read-only; `available: false` when none exists. |
 | `review_post` | free | Score a draft before you publish it — hook strength, an A/B hook comparison, aesthetic and storytelling notes, rewritten hooks/captions. Never billed, same as the dashboard's own pre-publish review. |

package/dist/shared/backend-only.js

@@ -21,7 +21,4 @@ export const BACKEND_ONLY_TOOLS = {
     get_batch_history: "History of the dashboard's compose batches, which only exist once rendering does; stays with #92.",
     get_latest_analysis: "Returns the dashboard's stored AI fleet-analysis verdict; the public surface sells the evidence, not a judgement of ours.",
     brand_watch_history: "Not a deliberate exclusion: a candidate for the public surface once it has a trend view to draw. Listed so it reads as pending, not forgotten.",
-    get_google_analytics: "Site analytics are dashboard-only until #104 decides their shape.",
-    get_posthog_analytics: "Site analytics are dashboard-only until #104 decides their shape.",
-    get_search_console_data: "Site analytics are dashboard-only until #104 decides their shape.",
 };

package/dist/shared/loading-plans.js

@@ -444,6 +444,9 @@ export const LOADING_PLANS = {
     get_scheduled_posts: { label: "Reading your pipeline", kind: "list", n: 5, steps: [], free: true },
     get_post_performance: { label: "Reading your numbers", kind: "list", n: 5, steps: [], free: true },
     get_video_stats: { label: "Reading the last sync", kind: "strip", n: 3, steps: [], free: true },
+    get_google_analytics: { label: "Reading your last GA4 sync", kind: "text", n: 1, steps: [], free: true },
+    get_search_console_data: { label: "Reading your last Search Console sync", kind: "text", n: 1, steps: [], free: true },
+    get_posthog_analytics: { label: "Reading your last PostHog sync", kind: "text", n: 1, steps: [], free: true },
     get_brand_playbook: { label: "Reading the playbook", kind: "text", n: 1, steps: [], free: true },
     // ─── The product analysis: the one own-account tool that spends ───
     // The only outbound fetch in this family — it reads an excerpt of the

package/dist/shared/output-schemas.js

@@ -1303,6 +1303,45 @@ export const OUTPUT_SCHEMAS = {
      * ui-template.ts's shared posts-gallery view picks this up. Declared here
      * too so a host validating structuredContent does not choke on it.
      */
+    // The connector reads (#104). Each is the backend's connector_sync_cache
+    // row as stored, plus `synced_at`, the hoisted appId/appName, and the
+    // `connector` this surface adds so the view knows which table to draw.
+    get_google_analytics: open({
+        connector: scalar(),
+        propertyId: scalar(),
+        rowsSynced: scalar(),
+        dateRange: open({ from: scalar(), to: scalar() }).nullish(),
+        lastSync: scalar(),
+        synced_at: scalar().describe("When nooticr last synced this. Not live: say this date when quoting it."),
+        message: scalar().describe("Set instead of data when nothing has been synced yet."),
+        appId: scalar(),
+        appName: scalar(),
+    }),
+    get_search_console_data: open({
+        connector: scalar(),
+        clicks: scalar(),
+        impressions: scalar(),
+        topQueries: listOf(z.string()),
+        error: scalar().describe("Search Console's own error at the last sync, when it refused."),
+        synced_at: scalar().describe("When nooticr last synced this. Not live: say this date when quoting it."),
+        message: scalar(),
+        appId: scalar(),
+        appName: scalar(),
+    }),
+    get_posthog_analytics: open({
+        connector: scalar(),
+        projectId: scalar(),
+        result: listOf(open({
+            label: scalar(),
+            data: listOf(z.number()).describe("One count per day, aligned with days."),
+            days: listOf(z.string()),
+        })).describe("PostHog's pageview trend series, as its API returned them."),
+        lastRefresh: scalar(),
+        synced_at: scalar().describe("When nooticr last synced this. Not live: say this date when quoting it."),
+        message: scalar(),
+        appId: scalar(),
+        appName: scalar(),
+    }),
     get_video_stats: open({
         videos: listOf(open({
             id: scalar(),

package/dist/shared/own-account.js

@@ -338,6 +338,68 @@ export function registerOwnAccountTools(server, makeClient) {
             return failed("get_brand_playbook failed", err);
         }
     });
+    /**
+     * The three connector reads (#104): GA4, Search Console, PostHog, as of
+     * their last sync into nooticr. They are the only tools here that say
+     * whether social moved a business metric, which is why they exist; the
+     * staleness is why the sync time is said in the text as well as the
+     * payload. A model that reads "1,204 clicks" without "as of" states a
+     * week-old number as today's.
+     */
+    const connectorRead = (name, connector, title, description) => server.registerTool(name, {
+        title,
+        description,
+        _meta: viewMeta(name),
+        // nooticr's own stored copy: nothing reaches Google or PostHog.
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        inputSchema: z
+            .object({
+            appId: z
+                .number()
+                .int()
+                .optional()
+                .describe("Your product's id. Omit only with a single-app workspace."),
+        })
+            .strict(),
+        outputSchema: OUTPUT_SCHEMAS[name],
+    }, async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        try {
+            const proxy = await client.callTool(name, args);
+            const data = { ...(proxy.structured ?? {}), connector };
+            const synced = String(data.synced_at ?? data.lastSync ?? data.lastRefresh ?? "");
+            const lead = data.message
+                ? String(data.message)
+                : synced
+                    ? `${title.replace(/^Get /, "")} for ${String(data.appName ?? "your product")}, as of its last sync at ` +
+                        `${synced} — not live. Say that date whenever you quote a number from it.`
+                    : `${title.replace(/^Get /, "")} for ${String(data.appName ?? "your product")}; the sync time was not reported, so do not present these as current.`;
+            return {
+                content: [{ type: "text", text: `${lead}\n\n${JSON.stringify(data, null, 2)}` }],
+                structuredContent: data,
+            };
+        }
+        catch (err) {
+            return failed(`${name} failed`, err);
+        }
+    });
+    connectorRead("get_google_analytics", "google_analytics", "Get Google Analytics", "Your own product's Google Analytics (GA4) sync, as of its last sync into nooticr — not a live " +
+        "GA4 call: the property, the date range synced and how many daily rows came in. The metrics " +
+        "themselves (installs, opens, purchases, revenue) feed get_post_performance and growth_brief " +
+        "rather than being repeated here. Returns a message rather than an error when nothing has " +
+        "ever been synced; connect GA4 in API Connections first. Takes appId (optional when your " +
+        "workspace has only one product). No cost to call.");
+    connectorRead("get_search_console_data", "search_console", "Get Search Console Data", "Your own product's Google Search Console data — total clicks and impressions and the top " +
+        "search queries — as of its last sync into nooticr, not a live Search Console call. Use it " +
+        "to see whether people search for what your social content is about. Returns a message " +
+        "rather than an error when nothing has been synced; connect Search Console in API " +
+        "Connections first. Takes appId (optional when your workspace has only one product). No " +
+        "cost to call.");
+    connectorRead("get_posthog_analytics", "posthog", "Get PostHog Analytics", "Your own product's PostHog pageview trend as of its last sync into nooticr — not a live " +
+        "PostHog call. Use it to line a post's date up against traffic to your site. Returns a " +
+        "message rather than an error when nothing has been synced; connect PostHog in API " +
+        "Connections first. Takes appId (optional when your workspace has only one product). No " +
+        "cost to call.");
     server.registerTool("analyze_product", {
         title: "Analyze Product",
         description: "Start an AI analysis of your own product: fetches an excerpt of the product's own website " +

package/dist/shared/tools-def.js

@@ -324,6 +324,24 @@ export const TOOL_DEFINITIONS = [
         description: "Your own most recently synced video performance stats across every connected creator — views, likes, comments, shares, plus a running total. Reads the last sync; does not trigger a new one. No cost to call.",
         inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-app workspace."), limit: z.number().int().optional().describe("Max videos (default 20, capped at 50).") }).strict(),
     },
+    {
+        name: "get_google_analytics",
+        title: "Get Google Analytics",
+        description: "Your own product's Google Analytics (GA4) sync, as of its last sync into nooticr — not a live GA4 call: the property, the date range synced and how many daily rows came in. Connect GA4 in API Connections first. No cost to call.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-app workspace.") }).strict(),
+    },
+    {
+        name: "get_search_console_data",
+        title: "Get Search Console Data",
+        description: "Your own product's Google Search Console clicks, impressions and top queries as of its last sync into nooticr — not a live Search Console call. Connect Search Console in API Connections first. No cost to call.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-app workspace.") }).strict(),
+    },
+    {
+        name: "get_posthog_analytics",
+        title: "Get PostHog Analytics",
+        description: "Your own product's PostHog pageview trend as of its last sync into nooticr — not a live PostHog call. Connect PostHog in API Connections first. No cost to call.",
+        inputSchema: z.object({ appId: z.number().int().optional().describe("Your product's id. Omit only with a single-app workspace.") }).strict(),
+    },
     {
         name: "get_content_plan",
         title: "Get Content Plan",

package/dist/shared/tools.js

@@ -29,7 +29,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.42";
+export const MCP_SERVER_VERSION = "1.26.43";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -642,6 +642,10 @@ export function createMcpServer(rawMakeClient, opts) {
         "get_scheduled_posts",
         "get_post_performance",
         "get_video_stats",
+        // The connector reads (#104): stored syncs, drawn by their own view.
+        "get_google_analytics",
+        "get_search_console_data",
+        "get_posthog_analytics",
         // get_content_plan gets the same card generate_content_plan does: they
         // return the same `plan` shape, so the generic template already renders it.
         "get_content_plan",

package/dist/shared/ui-template.js

@@ -48,6 +48,9 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     list_watchlist:"Watchlist",
     detect_spoken_mentions:"Spoken Mentions",
     nooticr_getting_started:"Getting Started",
+    get_google_analytics:"Google Analytics",
+    get_search_console_data:"Search Console",
+    get_posthog_analytics:"PostHog",
     compose_sequence:"Compose Sequence",
     overlay_bake:"Overlay Bake",
     spawn_variants:"Spawn Variants",
@@ -83,6 +86,9 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     list_watchlist:"The creators you are watching, and when you last caught up on each.",
     detect_spoken_mentions:"Brands named out loud in a video, beside what its caption says.",
     nooticr_getting_started:"Where your account stands and what to try first.",
+    get_google_analytics:"Your GA4 sync, as of its last sync.",
+    get_search_console_data:"Search clicks, impressions and top queries, as of the last sync.",
+    get_posthog_analytics:"Your PostHog pageview trend, as of the last sync.",
     compose_sequence:"AI-powered content composition for social posts.",
     overlay_bake:"Bake text/image overlays onto video or image.",
     spawn_variants:"Generate multiple content variants from a single seed.",
@@ -3088,6 +3094,62 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
       +'<div class="sec-label">Try next</div>'+steps+"</div>";
   }
 
+  // ─── Connector reads (get_google_analytics, get_search_console_data,
+  // get_posthog_analytics) ───
+  //
+  // Every one is a stored sync, so "as of" leads the card: a number drawn
+  // without its date is read as today's (#104).
+  function renderConnector(d){
+    var names={google_analytics:"Google Analytics",search_console:"Search Console",posthog:"PostHog"};
+    var name=names[d.connector]||"Analytics";
+    var when=String(d.synced_at||d.lastSync||d.lastRefresh||"");
+    var asOf=when?"as of "+esc(when.slice(0,16).split("T").join(" "))+" UTC · not live":"sync time not reported";
+    var head='<div style="margin-bottom:12px"><div style="font-size:15px;font-weight:700">'+esc(name)
+      +(d.appName?" · "+esc(d.appName):"")+"</div>"
+      +'<div data-as-of style="font-size:12px;color:var(--muted);margin-top:2px">'+asOf+"</div></div>";
+    if(d.message){
+      return '<div class="fade-in">'+head+'<div class="empty-state"><div class="icon">📊</div><div class="text">'+esc(d.message)+"</div></div></div>";
+    }
+    function tile(label,val){
+      return '<div style="flex:1;min-width:120px;padding:10px 12px;border:1px solid var(--border);border-radius:10px">'
+        +'<div style="font-size:11px;color:var(--muted);text-transform:uppercase;letter-spacing:.05em">'+esc(label)+"</div>"
+        +'<div style="font-size:18px;font-weight:700;margin-top:3px">'+esc(String(val))+"</div></div>";
+    }
+    var body="";
+    if(d.connector==="search_console"){
+      var clicks=Number(d.clicks)||0,imp=Number(d.impressions)||0;
+      body='<div style="display:flex;gap:8px;flex-wrap:wrap;margin-bottom:12px">'
+        +tile("Clicks",fmtNum(clicks))+tile("Impressions",fmtNum(imp))
+        +tile("Click-through",imp?(Math.round(clicks/imp*1000)/10)+"%":"—")+"</div>"
+        +(d.error?'<div style="font-size:12px;color:var(--red);margin-bottom:8px">Search Console refused the last sync: '+esc(d.error)+"</div>":"")
+        +((d.topQueries||[]).length
+          ?'<div class="sec-label">Top queries</div>'+(d.topQueries||[]).map(function(q,i){
+            return '<div data-query style="padding:6px 0;border-top:1px solid var(--border);font-size:13px"><span style="color:var(--muted);margin-right:8px">'+(i+1)+"</span>"+esc(q)+"</div>";
+          }).join("")
+          :"");
+    }else if(d.connector==="google_analytics"){
+      var r=d.dateRange||{};
+      body='<div style="display:flex;gap:8px;flex-wrap:wrap;margin-bottom:10px">'
+        +tile("Days synced",d.rowsSynced==null?"—":d.rowsSynced)
+        +tile("Range",(r.from||"?")+" → "+(r.to||"?"))+"</div>"
+        +(d.propertyId?'<div style="font-size:12px;color:var(--muted)">Property '+esc(d.propertyId)+"</div>":"")
+        +'<div style="font-size:12px;color:var(--muted);margin-top:6px">The metrics themselves feed post performance and the growth brief.</div>';
+    }else{
+      var series=Array.isArray(d.result)?d.result:[];
+      body=series.length?series.map(function(s){
+        var pts=Array.isArray(s.data)?s.data.map(Number):[];
+        var total=pts.reduce(function(a,b){return a+(b||0);},0),max=Math.max.apply(null,pts.concat([1]));
+        var bars=pts.slice(-30).map(function(v){
+          return '<span style="display:inline-block;width:6px;margin-right:2px;background:var(--fg);opacity:.55;height:'+Math.max(2,Math.round((v||0)/max*40))+'px"></span>';
+        }).join("");
+        return '<div data-series style="margin-bottom:12px"><div style="font-size:13px;font-weight:600">'+esc(s.label||s.action&&s.action.name||"Pageviews")
+          +' <span style="color:var(--muted);font-weight:500">· '+fmtNum(total)+" total</span></div>"
+          +'<div style="display:flex;align-items:flex-end;height:44px;margin-top:6px">'+bars+"</div></div>";
+      }).join(""):'<div style="font-size:13px;color:var(--muted)">No trend in the last sync.</div>';
+    }
+    return '<div class="fade-in">'+head+body+"</div>";
+  }
+
   // ─── Vetting strip ───
   //
   // Only show_collab_shortlist sends these fields, so every other creator card
@@ -4768,6 +4830,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
         +wlRows+"</div></div>";return;}
     // Credits
     if(d.gettingStarted===true){app.innerHTML=renderGettingStarted(d);setTimeout(reportSize,50);return;}
+    if(d.connector==="google_analytics"||d.connector==="search_console"||d.connector==="posthog"){app.innerHTML=renderConnector(d);setTimeout(reportSize,50);return;}
     if(d.balance!=null||d.tier){
       var bal=Number(d.balance)||0,tier=d.tier||"",ff=d.firstFreeTools||[];
       var freeHtml="";

package/package.json

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