@awesomate/hosting-mcp 0.38.0 → 0.39.0

package/dist/index.js

@@ -41179,7 +41179,9 @@ var TITLES = {
   awesomate_knowledge_collections: "Manage knowledge collections",
   awesomate_knowledge_faq: "Manage FAQs",
   awesomate_knowledge_people: "Manage knowledge entities",
-  awesomate_knowledge_data: "Query knowledge data warehouse"
+  awesomate_knowledge_data: "Query knowledge data warehouse",
+  awesomate_crm_metrics: "List contact list metrics",
+  awesomate_crm_query: "Query contact list metrics"
 };
 function annotate(name, kind) {
   const title = TITLES[name];
@@ -42629,6 +42631,59 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_crm_metrics",
+  {
+    annotations: annotate("awesomate_crm_metrics", READ_ONLY),
+    description: "What the client's own contact list (Contacts & email in the hub) can answer with numbers. action 'metrics' \u2014 the measures: people (a count) plus every number field the owner has named, with unit and synonyms. 'datasets' \u2014 the one dataset, 'contact', with its columns by kind: measures, dimensions (choice, yes/no and text fields to group by) and anchors (date fields a person can be counted by, plus created_at). Read this FIRST; awesomate_crm_query only accepts names listed here. Sensitive fields never appear. Read-only; counts and sums only, never a person's details.",
+    inputSchema: { action: external_exports.enum(["metrics", "datasets"]) }
+  },
+  async ({ action }) => {
+    try {
+      return textResult(await hubGet(requireConfig(), `/api/my-crm/v1/data/${action}`));
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
+server.registerTool(
+  "awesomate_crm_query",
+  {
+    annotations: annotate("awesomate_crm_query", READ_ONLY),
+    description: "Numbers from the client's contact list, read-only, never a row of personal details. action 'series' {metric, grain?, from?, to?, range?, compare?, anchor?, tz?} \u2014 one metric over time (people added per month, spend per quarter), with labels, points and a previous-period comparison when compare='previous'. action 'query' {measures:[{column, agg}], dimensions?, filters?, time?, order_by?, limit?} \u2014 grouped numbers (people by plan, sum of spend by suburb). Column names MUST come from awesomate_crm_metrics 'datasets'; an unknown name is refused, never guessed. Dates are YYYY-MM-DD; range presets: 7d, 30d, 90d, 12m, mtd, qtd, ytd, fytd, this_month, last_month, this_fy, last_fy (financial year starts 1 July). The response's applied.defaults says what was assumed; repeat those to the user.",
+    inputSchema: {
+      action: external_exports.enum(["series", "query"]),
+      metric: external_exports.string().max(80).optional().describe("series: 'people' or a measure key"),
+      agg: external_exports.enum(["sum", "avg", "min", "max", "count"]).optional().describe("series: how to aggregate a measure (default sum)"),
+      grain: external_exports.enum(["day", "week", "month", "quarter", "year", "fy"]).optional(),
+      from: external_exports.string().max(10).optional(),
+      to: external_exports.string().max(10).optional(),
+      range: external_exports.string().max(20).optional().describe("a preset instead of from/to"),
+      compare: external_exports.enum(["previous"]).optional(),
+      anchor: external_exports.string().max(80).optional().describe("the date a person counts by: created_at or a date field key"),
+      tz: external_exports.string().max(64).optional().describe("IANA time zone; default Australia/Sydney"),
+      measures: external_exports.array(external_exports.object({ column: external_exports.string().max(80), agg: external_exports.string().max(10).optional() })).max(8).optional(),
+      dimensions: external_exports.array(external_exports.string().max(80)).max(6).optional(),
+      filters: external_exports.array(external_exports.object({ column: external_exports.string().max(80), op: external_exports.string().max(5).optional(), value: external_exports.unknown() })).max(10).optional(),
+      time: external_exports.object({ grain: external_exports.string().max(10).optional(), preset: external_exports.string().max(20).optional(), from: external_exports.string().max(10).optional(), to: external_exports.string().max(10).optional(), anchor: external_exports.string().max(80).optional(), tz: external_exports.string().max(64).optional() }).optional(),
+      order_by: external_exports.array(external_exports.object({ field: external_exports.string().max(80), dir: external_exports.enum(["asc", "desc"]).optional() })).max(4).optional(),
+      limit: external_exports.number().int().min(1).max(2e3).optional()
+    }
+  },
+  async ({ action, metric, agg, grain, from, to, range, compare, anchor, tz, measures, dimensions, filters, time: time3, order_by, limit }) => {
+    try {
+      const cfg = requireConfig();
+      if (action === "series") {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries({ metric, agg, grain, from, to, range, compare, anchor, tz })) if (v) qs.set(k, String(v));
+        return textResult(await hubGet(cfg, `/api/my-crm/v1/data/series?${qs}`));
+      }
+      return textResult(await hubPost(cfg, "/api/my-crm/v1/data/query", { measures, dimensions, filters, time: time3, order_by, limit }));
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_n8n_kpis",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Awesomate MCP server — lets Claude manage your Awesomate WordPress hosting, plan, limits, n8n automations, and build Node/static apps + databases",
   "license": "UNLICENSED",
   "type": "module",

package/skill/CHANGELOG.json

@@ -1,5 +1,13 @@
 {
   "versions": [
+    {
+      "version": "0.39.0",
+      "highlights": [
+        "Ask Claude for numbers from your contact list: how many people joined each month, spend by plan, customers by suburb (awesomate_crm_metrics, awesomate_crm_query). It only ever gets counts and sums, never anyone's details",
+        "The fields you named on an import are what it can measure and group by; anything you marked sensitive is left out entirely",
+        "Every answer says what it assumed (the date range, the time zone, which date a person counts by) so you can check it"
+      ]
+    },
     {
       "version": "0.38.0",
       "highlights": [

package/skill/awesomate-n8n/references/n8n-agents.md

@@ -27,13 +27,18 @@ tool call at a time, so the key never reaches this machine.
 
 `awesomate_n8n_agents {action:"status"}` FIRST:
 
-- `keyConfigured: false` → walk them through `setup.steps` in plain words:
-  in their n8n, **Settings → Instance-level MCP** → switch on → copy the MCP
-  API key → paste it into **n8n Agents access** at
-  hub.awesomate.ai/n8n/settings → Test & Save. Owner or admin only. Then
-  re-check status. Never ask them to paste the key into this chat.
-- `code: mcp_disabled` → MCP was switched off again in their n8n.
-- `code: mcp_key_rejected` → the key was rotated; paste a fresh one.
+- `keyConfigured: false` → send them to **"Set it up for me"** under **n8n
+  Agents access** at hub.awesomate.ai/n8n/settings (`setup.steps`). One
+  click: the hub switches on their n8n's MCP (a restart of about 20 seconds
+  if it was off), connects their owner key and emails them. There is nothing
+  to copy. **You cannot do this step for them**: only that click may connect
+  a key, so never offer to. When they say it's done, re-check status. If the
+  button can't do it on their instance, its message gives the by-hand route
+  (`setup.manualSteps`). Never ask them to paste a key into this chat.
+- `code: mcp_disabled` → MCP was switched off in their n8n. "Set it up for
+  me" switches it back on.
+- `code: mcp_key_rejected` → the hub normally re-reads a regenerated key by
+  itself. If this still shows, send them to "Set it up for me" again.
 - `missingTools` present → their n8n has no Agents module. Do not try to
   work around it; that's an Awesomate support ask.
 - `ready: true` → go. Building, testing and publishing agents work on **every