@awesomate/hosting-mcp 0.5.0 → 0.6.1

package/dist/index.js

@@ -21106,6 +21106,12 @@ var StdioServerTransport = class {
   }
 };
 
+// src/index.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join2, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
 // src/config.ts
 import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -21214,9 +21220,34 @@ function hubDelete(config3, path) {
 
 // src/index.ts
 var config2;
+var SERVER_VERSION = (() => {
+  try {
+    const pkg = JSON.parse(
+      readFileSync2(join2(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf8")
+    );
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+})();
+function skillUpdateInfo() {
+  let installedSkillVersion = null;
+  try {
+    installedSkillVersion = readFileSync2(
+      join2(homedir2(), ".claude", "skills", "awesomate-hosting", ".installed-version"),
+      "utf8"
+    ).trim() || null;
+  } catch {
+  }
+  return {
+    serverVersion: SERVER_VERSION,
+    installedSkillVersion,
+    updateAvailable: installedSkillVersion !== SERVER_VERSION
+  };
+}
 var server = new McpServer({
   name: "awesomate-hosting",
-  version: "0.1.0"
+  version: SERVER_VERSION
 });
 function textResult(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
@@ -21234,10 +21265,20 @@ function readTool(name, description, path) {
     }
   });
 }
-readTool(
+server.registerTool(
   "awesomate_get_context",
-  "Call this FIRST each session. Returns the connected Awesomate account: plan, capabilities (shell access), plan limits, scopes this token can exercise, token expiry (warn the user if within 7 days), and cPanel routing when provisioned.",
-  "/api/hosting-access/context"
+  {
+    description: "Call this FIRST each session. Returns the connected Awesomate account: plan, capabilities (shell access), plan limits, scopes this token can exercise, token expiry (warn the user if within 7 days), cPanel routing when provisioned, and skill.updateAvailable \u2014 if true, the local awesomate-hosting skill files are older than this server; tell the user to re-run Connect Claude Code from hub.awesomate.ai/sites to refresh them (this also renews the token).",
+    inputSchema: {}
+  },
+  async () => {
+    try {
+      const ctx = await hubGet(config2, "/api/hosting-access/context");
+      return textResult({ ...ctx, skill: skillUpdateInfo() });
+    } catch (err) {
+      return errorResult(err);
+    }
+  }
 );
 readTool(
   "awesomate_n8n_context",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awesomate/hosting-mcp",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Awesomate MCP server — lets Claude manage your Awesomate WordPress hosting, plan, limits, and n8n automations",
   "license": "UNLICENSED",
   "type": "module",

package/skill/awesomate-hosting/SKILL.md

@@ -32,11 +32,35 @@ context note three things and cache them for the session:
 - **`patExpiresAt`** — if it's within ~7 days, tell the user to open
   **hub.awesomate.ai/sites → Connect Claude Code** and re-run the setup prompt to
   refresh the token. If any tool returns a 401, do the same.
+- **`skill.updateAvailable`** — if true, this skill's local files are older than
+  the MCP server. Mention it once (don't nag): re-running Connect Claude Code
+  from **hub.awesomate.ai/sites** refreshes the skill and renews the token in
+  one go. Not urgent — finish the user's actual request first.
 - **`cpanel`** routing (host/user), present once hosting is provisioned.
 
 If `awesomate_get_context` fails with a connectivity error, it's the user's
 network or the API base — not an auth problem; say so.
 
+If this skill is loaded but **no `awesomate_*` tools exist in the session at
+all**, the MCP server was registered after Claude Code started (the bootstrap
+just ran). Don't investigate settings files or reinstall anything — and don't
+make a restart the precondition for showing the user their own data. The
+skill works right now over REST: read `apiBase` and `pat` from
+`~/.awesomate/credentials.json` (never echo the pat into the conversation)
+and GET with `Authorization: Bearer <pat>`:
+
+| MCP tool | REST equivalent |
+|---|---|
+| `awesomate_get_context` | `GET {apiBase}/api/hosting-access/context` |
+| `awesomate_get_hosting_status` | `GET {apiBase}/api/client-hosting/status` |
+| `awesomate_get_hosting_account` | `GET {apiBase}/api/client-hosting/account` |
+| `awesomate_list_sites` | `GET {apiBase}/api/client-hosting/sites` |
+| `awesomate_list_domains` | `GET {apiBase}/api/client-hosting/domains` |
+| `awesomate_get_limits` | `GET {apiBase}/api/client-hosting/limits` |
+
+Serve the request with these now, then suggest restarting Claude Code at a
+natural break so the richer MCP integration loads.
+
 ## 1. The plan model (so your nudges are accurate)
 
 | Plan | WP sites | Custom domains | Shell / Claude Code | Notes |

package/skill/awesomate-hosting/scripts/bootstrap.mjs

@@ -82,6 +82,15 @@ function installSkill() {
   const bundled = skillRoot.endsWith('/skill')
     ? readdirSync(skillRoot)
     : [hostingSkill.split('/').pop()];
+  // Package version, stamped into each installed skill as .installed-version.
+  // The MCP server (always latest via unpinned npx) compares it against its own
+  // version and reports skill.updateAvailable in awesomate_get_context.
+  let pkgVersion = null;
+  if (skillRoot.endsWith('/skill')) {
+    try {
+      pkgVersion = JSON.parse(readFileSync(join(dirname(skillRoot), 'package.json'), 'utf8')).version ?? null;
+    } catch { /* non-fatal — marker just won't be written */ }
+  }
   let installed = 0;
   for (const name of bundled) {
     const src = join(skillRoot, name);
@@ -97,6 +106,9 @@ function installSkill() {
         if (/\.(sh|mjs)$/.test(f)) { try { chmodSync(join(scriptsDir, f), 0o755); } catch { /* non-fatal */ } }
       }
     }
+    if (pkgVersion) {
+      try { writeFileSync(join(dest, '.installed-version'), `${pkgVersion}\n`); } catch { /* non-fatal */ }
+    }
     console.log(`✓ Installed the "${name}" skill to ${dest}.`);
     installed += 1;
   }
@@ -174,7 +186,7 @@ async function main() {
   }
 
   console.log('\nSetup complete. Next: ask me to read your plan, list your sites, and tell you what we can do.');
-  if (!registered) console.log('(Restart Claude Code first so it picks up the new MCP server.)');
+  if (!registered) console.log('(The skill works in your current Claude session right away via its REST fallback — restart Claude Code when convenient to load the MCP tools.)');
 }
 
 main().catch((err) => {