@nooticr/mcp 1.26.46 → 1.26.47

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-86 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+87 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
@@ -174,6 +174,7 @@ a `scanId` for the rest.
 | `check_nooticr_credits` | free | Balance and billing URL. |
 | `list_tool_runs` | free | Your tool-call history: what ran, whether it worked, and the credits each call actually took (0 for a free, refunded, cached or replayed call). `scope: "workspace"` shows every member's runs to owners and admins. |
 | `get_tool_run` | free | One run from that history by id, with its full error. |
+| `get_usage_report` | free | The run ledger added up over a window: total calls, failures and credits actually taken, per tool, per day and the most recent failures. `scope: "workspace"` adds one row per seat, for the workspace's owners and admins. |
 | `nooticr_login` | free | Re-link the account when a call fails with an authentication error. |
 | `list_social_connections` | free | What you have connected and what each connection is actually allowed to do — read the account, publish a post, manage comments — as yes, no or **unknown**. "Manage comments" reports the platform's grant; no nooticr tool posts or replies to a comment. Unknown means the grant predates scope recording: treat it as "try it", not as a refusal. Also says which platforms can be linked at all, which is a smaller set than the networks nooticr reads. |
 | `connect_social_account` | free | A link the user opens to connect one account. They approve at the provider in their own browser; nothing is connected until they do, and no credential passes through the tool or the model's context. Each call mints a fresh link — an old one does not work twice. |

package/dist/shared/loading-plans.js

@@ -495,6 +495,7 @@ export const LOADING_PLANS = {
     check_nooticr_credits: { label: "Checking your balance", kind: "text", n: 1, steps: [], free: true },
     list_tool_runs: { label: "Reading your run history", kind: "text", n: 1, steps: [], free: true },
     get_tool_run: { label: "Reading the run", kind: "text", n: 1, steps: [], free: true },
+    get_usage_report: { label: "Adding up the run ledger", kind: "text", n: 1, steps: [], free: true },
     nooticr_getting_started: { label: "Reading where your account stands", kind: "text", n: 1, steps: [], free: true },
     nooticr_login: { label: "Getting a sign-in link", kind: "text", n: 1, steps: [], free: true },
     watch_creator: { label: "Adding to your watchlist", kind: "text", n: 1, steps: [], free: true },

package/dist/shared/output-schemas.js

@@ -1135,6 +1135,23 @@ export const OUTPUT_SCHEMAS = {
             userId: scalar().describe("Whose run it was; only in the workspace scope."),
         }).nullish(),
     }),
+    get_usage_report: open({
+        report: scalar(),
+        scope: scalar().describe("mine or workspace."),
+        from: scalar(),
+        to: scalar(),
+        totals: open({
+            calls: scalar(),
+            failures: scalar(),
+            credits: scalar().describe("Credits actually taken: free first uses, refunds and replays are zero."),
+            tools: scalar(),
+            seats: scalar(),
+        }).nullish(),
+        byTool: listOf(open({ tool: scalar(), calls: scalar(), failures: scalar(), credits: scalar(), lastUsedAt: scalar() })),
+        bySeat: listOf(open({ userId: scalar(), email: scalar(), name: scalar(), calls: scalar(), failures: scalar(), credits: scalar() })).describe("Workspace reports only; empty on a personal one."),
+        byDay: listOf(open({ day: scalar(), calls: scalar(), failures: scalar(), credits: scalar() })),
+        recentFailures: listOf(open({ id: scalar(), tool: scalar(), error: scalar(), startedAt: scalar(), userId: scalar(), credits: scalar() })),
+    }),
     nooticr_login: open({
         signedIn: scalar().describe("true when the session is already good and no link is needed."),
         loginUrl: scalar().describe("Only present when a sign-in is actually required."),

package/dist/shared/tools-def.js

@@ -222,6 +222,12 @@ export const TOOL_DEFINITIONS = [
         description: "One run from list_tool_runs by its id, with its full error text, credentials scrubbed. A run outside your scope reads as not found. No cost to call. Use to look closely at one charge.",
         inputSchema: z.object({ id: z.number().int(), scope: z.enum(["mine", "workspace"]).optional() }).strict(),
     },
+    {
+        name: "get_usage_report",
+        title: "Get Usage Report",
+        description: "A usage report over a window: total calls, failures and credits actually taken, per tool, per day, and recent failures; scope workspace adds one row per seat, for owners and admins. No cost to call.",
+        inputSchema: z.object({ days: z.number().int().min(1).max(366).optional(), from: z.string().optional(), to: z.string().optional(), scope: z.enum(["mine", "workspace"]).optional() }).strict(),
+    },
     {
         name: "nooticr_login",
         title: "Nooticr Login",

package/dist/shared/tools.js

@@ -30,7 +30,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.46";
+export const MCP_SERVER_VERSION = "1.26.47";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */
@@ -604,6 +604,7 @@ export function createMcpServer(rawMakeClient, opts) {
         "check_nooticr_credits",
         "list_tool_runs",
         "get_tool_run",
+        "get_usage_report",
         "list_watchlist",
         "nooticr_getting_started",
         "understand_social_post",
@@ -2610,6 +2611,43 @@ export function createMcpServer(rawMakeClient, opts) {
             return toolError("get_tool_run failed", err);
         }
     });
+    // The run ledger added up (#93): the question an owner or a security review
+    // asks ("what did the team run this month, what did it cost, what failed")
+    // answered from the same rows as the history, never from memory.
+    server.registerTool("get_usage_report", {
+        title: "Get Usage Report",
+        description: "A usage report over a window: total calls, failures and credits actually taken; one row " +
+            "per tool, most expensive first; one row per day, quiet days included; and the ten most " +
+            "recent failures with their errors, credentials scrubbed. scope: \"workspace\" covers " +
+            "every member of your workspace and adds one row per seat; it is for the workspace's " +
+            "owners and admins. Reads the stored run ledger, so it is free and says what happened, " +
+            "not what is running. No cost to call. Use for \"what did we spend this month and on " +
+            "what\" or an audit of what nooticr did on the workspace's behalf; list_tool_runs is the " +
+            "call-by-call view.",
+        _meta: {
+            ui: { resourceUri: uiResource("get_usage_report") },
+            "ui/resourceUri": uiResource("get_usage_report"),
+            "openai/outputTemplate": appsSdkResource("get_usage_report"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        outputSchema: OUTPUT_SCHEMAS.get_usage_report,
+        inputSchema: z
+            .object({
+            days: z.number().int().min(1).max(366).optional().describe("The window, in days back from now (default 30)."),
+            from: z.string().optional().describe("Start of the window, ISO date or timestamp. Overrides days."),
+            to: z.string().optional().describe("End of the window, ISO date or timestamp (default now)."),
+            scope: runFilters.scope,
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        try {
+            return await toToolResult(await client.callTool("get_usage_report", { ...args }));
+        }
+        catch (err) {
+            return toolError("get_usage_report failed", err);
+        }
+    });
     server.registerTool("nooticr_login", {
         title: "Nooticr Login",
         description: "Get a fresh login URL to re-authenticate your MCP session. Call this tool when you need to reconnect or when the session has expired. No cost to call." +

package/dist/shared/ui-template.js

@@ -45,6 +45,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     check_nooticr_credits:"Check Credits",
     list_tool_runs:"Tool Runs",
     get_tool_run:"Tool Run",
+    get_usage_report:"Usage Report",
     list_watchlist:"Watchlist",
     detect_spoken_mentions:"Spoken Mentions",
     nooticr_getting_started:"Getting Started",
@@ -84,6 +85,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     check_nooticr_credits:"View your Nooticr credit balance and usage.",
     list_tool_runs:"Where your credits went: every call, what it cost, and whether it worked.",
     get_tool_run:"One call from your history, with its full error.",
+    get_usage_report:"What was spent, on what, by whom, and what failed.",
     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.",
@@ -3152,6 +3154,48 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     return '<div class="fade-in">'+head+body+"</div>";
   }
 
+  // ─── Usage report (get_usage_report) ───
+  //
+  // A spend table: the totals first, then where it went. Credits are what was
+  // actually taken, so a free first use or a refund reads as 0, not as the
+  // tool's price.
+  function renderUsageReport(d){
+    var t=d.totals||{};
+    function tile(label,val){
+      return '<div style="flex:1;min-width:110px;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==null?"—":val))+"</div></div>";
+    }
+    function table(title,cols,rows){
+      if(!rows.length)return "";
+      return '<div class="sec-label" style="margin-top:14px">'+esc(title)+"</div>"
+        +'<table style="width:100%;border-collapse:collapse;font-size:13px">'
+        +"<tr>"+cols.map(function(c,i){return '<th style="text-align:'+(i?"right":"left")+';font-weight:600;color:var(--muted);padding:4px 0">'+esc(c)+"</th>";}).join("")+"</tr>"
+        +rows.map(function(r){return '<tr data-usage-row style="border-top:1px solid var(--border)">'+r.map(function(v,i){return '<td style="padding:6px 0;text-align:'+(i?"right":"left")+'">'+esc(String(v))+"</td>";}).join("")+"</tr>";}).join("")
+        +"</table>";
+    }
+    var from=String(d.from||"").slice(0,10),to=String(d.to||"").slice(0,10);
+    var days=(d.byDay||[]),max=1;
+    days.forEach(function(x){max=Math.max(max,Number(x.credits)||0);});
+    var bars=days.length?'<div class="sec-label" style="margin-top:14px">Credits per day</div><div style="display:flex;align-items:flex-end;gap:2px;height:48px">'
+      +days.map(function(x){var c=Number(x.credits)||0;return '<span title="'+esc(String(x.day))+": "+c+' cr" style="flex:1;min-width:2px;background:var(--fg);opacity:'+(c?".6":".12")+';height:'+Math.max(2,Math.round(c/max*46))+'px"></span>';}).join("")+"</div>":"";
+    var fails=(d.recentFailures||[]).map(function(f){
+      return '<div style="padding:6px 0;border-top:1px solid var(--border);font-size:12.5px"><b>'+esc(f.tool||"")+"</b> "
+        +'<span style="color:var(--muted)">'+esc(String(f.startedAt||"").slice(0,16).split("T").join(" "))+"</span>"
+        +(f.error?'<div style="color:var(--muted);word-break:break-word">'+esc(f.error)+"</div>":"")+"</div>";
+    }).join("");
+    return '<div class="fade-in">'
+      +'<div style="font-size:15px;font-weight:700">'+(d.scope==="workspace"?"Workspace usage":"Your usage")+"</div>"
+      +'<div style="font-size:12px;color:var(--muted);margin:2px 0 12px">'+esc(from)+" → "+esc(to)+"</div>"
+      +'<div style="display:flex;gap:8px;flex-wrap:wrap">'+tile("Credits",t.credits)+tile("Calls",t.calls)+tile("Failures",t.failures)
+      +(d.scope==="workspace"?tile("Seats",t.seats):"")+"</div>"
+      +table("By tool",["Tool","Calls","Failed","Credits"],(d.byTool||[]).map(function(r){return [r.tool,r.calls,r.failures,r.credits];}))
+      +table("By seat",["Member","Calls","Failed","Credits"],(d.bySeat||[]).map(function(r){return [r.name||r.email||String(r.userId||"").slice(0,8),r.calls,r.failures,r.credits];}))
+      +bars
+      +(fails?'<div class="sec-label" style="margin-top:14px">Recent failures</div>'+fails:"")
+      +"</div>";
+  }
+
   // ─── Vetting strip ───
   //
   // Only show_collab_shortlist sends these fields, so every other creator card
@@ -4850,6 +4894,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     // 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.report===true&&d.totals){app.innerHTML=renderUsageReport(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.46",
+  "version": "1.26.47",
   "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": {