@awesomate/hosting-mcp 0.43.0 → 0.44.0

package/dist/index.js

@@ -41187,7 +41187,8 @@ var TITLES = {
   awesomate_crm_rows: "Look up people in the contact list",
   awesomate_crm_types: "Generate TypeScript types for contact data",
   awesomate_crm_kinds: "Define app data kinds",
-  awesomate_crm_write: "Write app data records"
+  awesomate_crm_write: "Write app data records",
+  awesomate_crm_email: "Draft an email to a contact list"
 };
 function annotate(name, kind) {
   const title = TITLES[name];
@@ -42845,6 +42846,38 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_crm_email",
+  {
+    annotations: annotate("awesomate_crm_email", MUTATING),
+    description: "Write an email DRAFT to one of the client's contact lists, for the owner to review and approve in the hub. Claude never sends: a draft reaches nobody until a person opens reviewUrl, sends themselves a test and approves the exact version they saw. Always give the user reviewUrl. action 'lists': the lists an email can go to, with how many people each would reach right now and why others are left out (counts only). action 'draft' {topic, doc}: a new draft to list `topic` (a key from 'lists'). action 'update' {id, topic, doc}: replace a draft (refused once someone approved it; they change it in the hub). action 'get' {id}: its status, the checks, the audience, what happened after sending. action 'list': recent emails. doc is a block document, never HTML: {kind: 'marketing'|'transactional' (marketing if ANY part promotes), voice: 'brand'|'personal' (whose name is on the From line), subject (max 150), preheader (the inbox preview line, max 200), reason (marketing: one line finishing \"You're getting this because...\"), blocks: [...]}. Blocks: {type:'eyebrow', text, tone?:'info'|'action'} \xB7 {type:'heading', text, level?:1|2} \xB7 {type:'paragraph', text} \xB7 {type:'list', items:[...], ordered?} \xB7 {type:'panel', tone?:'info'|'neutral'|'success'|'warm'|'alert', label?, text} \xB7 {type:'button', label (max 40), url} \xB7 {type:'image', src, alt, href?, width?} \xB7 {type:'divider'} \xB7 {type:'signoff', lines:[...]}. Inside text: **bold**, [label](https://url), and {{first_name|there}}, {{last_name}}, {{email}} (the part after | is the fallback when the field is empty). The footer, unsubscribe link, business details and dark mode are added by the hub: do not write them. The response's checks.blockers must be empty before the owner can approve; fix them and update. Warnings are for the owner to weigh. Write in plain Australian English, short paragraphs, one clear button.",
+    inputSchema: {
+      action: external_exports.enum(["lists", "draft", "update", "get", "list"]),
+      id: external_exports.string().max(64).optional().describe("update/get: the email id from a draft or list"),
+      topic: external_exports.string().max(63).optional().describe("draft/update: the list's key, from action 'lists'"),
+      doc: external_exports.record(external_exports.unknown()).optional().describe("draft/update: the email document (see the description)")
+    }
+  },
+  async ({ action, id, topic, doc }) => {
+    try {
+      const cfg = requireConfig();
+      if (action === "lists") return textResult(await hubGet(cfg, "/api/my-crm/v1/emails/lists"));
+      if (action === "list") return textResult(await hubGet(cfg, "/api/my-crm/v1/emails"));
+      if (action === "get") {
+        if (!id) return errorResult(new Error("get needs the email's id."));
+        return textResult(await hubGet(cfg, `/api/my-crm/v1/emails/${encodeURIComponent(id)}`));
+      }
+      if (!topic || !doc) return errorResult(new Error(`${action} needs topic (a list key from action 'lists') and doc.`));
+      if (action === "update") {
+        if (!id) return errorResult(new Error("update needs the id of the draft to replace."));
+        return textResult(await hubPatch(cfg, `/api/my-crm/v1/emails/${encodeURIComponent(id)}`, { topic, doc }));
+      }
+      return textResult(await hubPost(cfg, "/api/my-crm/v1/emails", { topic, doc }));
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_n8n_kpis",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.43.0",
+  "version": "0.44.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.44.0",
+      "highlights": [
+        "Claude can now write an email to one of your contact lists (awesomate_crm_email). It shows you which lists you have and how many people each would reach",
+        "It only ever writes a draft. You open the link it gives you, see the email on desktop, phone and dark mode, send yourself a test, and approve it in the hub. Nothing is sent until you do",
+        "Once you approve an email, Claude can't change it. Any edit after that is yours, in the hub"
+      ]
+    },
     {
       "version": "0.43.0",
       "highlights": [