@awesomate/hosting-mcp 0.32.0 → 0.33.0

package/dist/index.js

@@ -40993,6 +40993,7 @@ var TITLES = {
   awesomate_n8n_node_docs: "Get n8n node docs",
   awesomate_n8n_deploy: "Deploy n8n workflow",
   awesomate_n8n_library: "Install Awesomate templates",
+  awesomate_book_session: "Book a session with Awesomate",
   awesomate_n8n_test: "Test-fire n8n workflow",
   awesomate_n8n_datatable_write: "Write to n8n data table",
   awesomate_n8n_attach_to_app: "Attach n8n to app",
@@ -41163,6 +41164,44 @@ server.registerTool(
     }
   }
 );
+server.registerTool(
+  "awesomate_book_session",
+  {
+    annotations: annotate("awesomate_book_session", MUTATING),
+    description: "Book a session with the Awesomate team on the client's behalf, from their credits. Use it when a template needs a credential or setup the client would rather not do alone (the install_plan help card names it), or when three test-and-fix rounds have failed. Actions: 'session_types' (what can be booked, credit cost, whether bookable on their plan, and the intake questions each asks; call FIRST), 'slots' (session_type, optional from/to ISO dates: open times with host_team_member_id), 'book' (session_type, starts_at ISO, host_team_member_id, client_name, optional timezone and intake answers; spends the credits shown; get an explicit yes first and tell them the time in THEIR timezone), 'mine' (their upcoming and past sessions). 404 not_live means bookings are not switched on for clients yet: say so and offer a support ticket instead. 402 insufficient_credits: relay it honestly and link https://hub.awesomate.ai/billing.",
+    inputSchema: {
+      action: external_exports.enum(["session_types", "slots", "book", "mine"]),
+      session_type: external_exports.string().optional().describe("slots and book: the session type key from session_types"),
+      from: external_exports.string().optional().describe("slots: ISO date to search from (default now)"),
+      to: external_exports.string().optional().describe("slots: ISO date to search to (default from + 14 days)"),
+      starts_at: external_exports.string().optional().describe("book: the slot start, ISO timestamp exactly as returned by slots"),
+      host_team_member_id: external_exports.number().optional().describe("book: the host id from the chosen slot"),
+      client_name: external_exports.string().optional().describe("book: the name the host will greet"),
+      timezone: external_exports.string().optional().describe("book: IANA timezone, e.g. Australia/Brisbane"),
+      intake: external_exports.record(external_exports.unknown()).optional().describe("book: answers to the session type's intake questions")
+    }
+  },
+  async ({ action, session_type, from, to, starts_at, host_team_member_id, client_name, timezone, intake }) => {
+    try {
+      const cfg = requireConfig();
+      if (action === "session_types") return textResult(await hubGet(cfg, "/api/bookings/session-types"));
+      if (action === "mine") return textResult(await hubGet(cfg, "/api/bookings"));
+      if (!session_type) return errorResult(new Error(`session_type is required for ${action}`));
+      if (action === "slots") {
+        const q = new URLSearchParams({ session_type });
+        if (from) q.set("from", String(Date.parse(from)));
+        if (to) q.set("to", String(Date.parse(to)));
+        return textResult(await hubGet(cfg, `/api/bookings/slots?${q.toString()}`));
+      }
+      if (!starts_at || !host_team_member_id) return errorResult(new Error("starts_at and host_team_member_id are required for book"));
+      return textResult(
+        await hubPost(cfg, "/api/bookings", { session_type, starts_at, host_team_member_id, client_name: client_name ?? "", timezone, intake: intake ?? {} })
+      );
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
+);
 server.registerTool(
   "awesomate_n8n_test",
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.32.0",
+  "version": "0.33.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.33.0",
+      "highlights": [
+        "When a template needs a credential you would rather not set up alone, Claude can book a session with the Awesomate team for you: awesomate_book_session shows what can be booked, the open times and the credit cost, and books with your yes",
+        "Stuck after three test-and-fix rounds on one template? Claude now suggests a support ticket, and if you say yes it sends one carrying the template, the failing execution and your own note",
+        "A missing credential's help card names what the template expects (Kie, not HTTP Bearer Auth), taken from the template's own markers"
+      ]
+    },
     {
       "version": "0.32.0",
       "highlights": [

package/skill/awesomate-n8n/SKILL.md

@@ -94,6 +94,7 @@ the named node actually exists in the workflow before editing anything.
 | Validate / create draft / update draft / activate / promote / rollback / delete draft | `awesomate_n8n_deploy` |
 | Fire a test payload at an active workflow | `awesomate_n8n_test` |
 | Awesomate's template library: list, detail, install_plan (pauses on a missing credential), install, redeem, installs, activate, test, rollback | `awesomate_n8n_library` |
+| Book a session with the Awesomate team from their credits (session_types, slots, book, mine) | `awesomate_book_session` |
 | Create/alter data tables, write rows | `awesomate_n8n_datatable_write` |
 | Provision a Postgres DB + n8n credential | `awesomate_n8n_provision_pg` |
 | Wire a tested webhook workflow into one of their hosted apps (stores URL + secret on the app; returns the secret ONCE for the workflow's header check) | `awesomate_n8n_attach_to_app` |
@@ -209,8 +210,17 @@ loop: nothing is designed, the bundle is installed as curated.
    (`/home/credentials`), then activate again. Agents are live on install.
 6. `test`. Each template reports `passed`, `failed` (read the execution with
    `awesomate_n8n_executions` debug, fix configuration, re-run) or `untested` (no recipe:
-   ask them to try it once). Real side effects run; say so before testing. After THREE
-   failed rounds on one template, stop and SUGGEST a support ticket; never send one unasked.
+   ask them to try it once). Real side effects run; say so before testing.
+
+**The stuck ladder** (a credential they cannot set up, or three failed test-and-fix rounds
+on ONE template): (1) `awesomate_support ask` and the help card's articles; (2) offer a
+session with the Awesomate team through `awesomate_book_session` (session_types first; it
+costs the credits shown; book only on their yes; 404 not_live means bookings are not open
+yet, go to 3); (3) SUGGEST a support ticket. Never send one unasked. If they say yes, ask
+for a sentence in their own words, then `awesomate_support create_ticket` with category
+'Workflow error', subject `<bundle>: <template> fails after install`, and a message that
+carries the bundle and template slugs, the execution id and failing node from the last
+test, what you tried, and their sentence verbatim. Never paste workflow JSON into a ticket.
 7. `rollback` removes what their install created (never a reused workflow), with their OK.
 8. A 403 whose `missingScopes` contains `n8n:deploy` means Essentials. Show the catalog,
    say installing needs Support Plus, link `https://hub.awesomate.ai/billing`, and stop.