htmlhost-mcp 1.0.0 → 1.1.0

package/README.md

@@ -83,6 +83,8 @@ htmlhost-mcp
 | `pull_site` | Download a site's files to a local directory |
 | `delete_site` | Permanently delete a site |
 | `whoami` | Show the current authenticated user |
+| `list_versions` | List a site's published versions and what each changed |
+| `restore_version` | Make an earlier version live again (Pro) |
 
 ### `deploy`
 
@@ -138,6 +140,24 @@ confirm   (required)  Must be true — safety check
 
 Returns the authenticated user's email, name, handle, and plan.
 
+### `list_versions`
+
+```
+slug      (required)  The site slug
+```
+
+Returns the site's versions, newest first, with time, source, size, what changed, and which one is live. `usable: false` means the owner's plan can't restore them.
+
+### `restore_version`
+
+```
+slug      (required)  The site slug
+version   (required)  Version number from list_versions
+confirm   (required)  Must be true — safety check
+```
+
+Publishes that version again as a new version, so it can be undone the same way. Needs the site owner to be on Pro.
+
 ## Architecture
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "htmlhost-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for htmlhost.co — deploy, list, and manage sites from AI coding tools",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -48,7 +48,7 @@ class ApiError extends Error {
 function headers(extra = {}) {
   const token = getToken();
   if (!token) throw new ApiError("Not logged in. Run `htmlhost login` in a terminal first.", 0);
-  return { Authorization: `Bearer ${token}`, ...extra };
+  return { Authorization: `Bearer ${token}`, "X-HTMLHost-Client": "mcp", ...extra };
 }
 
 async function withRetry(fn, label = "request", retries = 3) {

package/src/server.mjs

@@ -26,7 +26,7 @@ import {
   mimeFromExt,
 } from "./api.mjs";
 
-const VERSION = "1.0.0";
+const VERSION = "1.1.0";
 
 /**
  * Helper: wraps a handler to return proper MCP content and catch errors.
@@ -314,5 +314,56 @@ export function createServer() {
     })
   );
 
+  // -------------------------------------------------------------------
+  // Tool: list_versions
+  // -------------------------------------------------------------------
+  server.registerTool(
+    "list_versions",
+    {
+      title: "List site versions",
+      description:
+        "List the published versions of a site, newest first, with what each one changed. " +
+        "`usable: false` means the owner's plan can't restore them (Pro feature).",
+      inputSchema: z.object({
+        slug: z.string().describe("The site slug"),
+      }),
+    },
+    wrap(async ({ slug }) => {
+      if (!isLoggedIn()) return "Not logged in. Run `htmlhost login` in a terminal first.";
+      const cleanSlug = slug.replace(/\.htmlhost\.co$/, "");
+      return apiGet(`/api/sites/${encodeURIComponent(cleanSlug)}/versions`);
+    })
+  );
+
+  // -------------------------------------------------------------------
+  // Tool: restore_version
+  // -------------------------------------------------------------------
+  server.registerTool(
+    "restore_version",
+    {
+      title: "Restore a site version",
+      description:
+        "Make an earlier version of a site live again. It's published as a new version " +
+        "(the current one stays in history), so this can be undone by restoring again. Needs Pro.",
+      inputSchema: z.object({
+        slug: z.string().describe("The site slug"),
+        version: z.number().int().positive().describe("The version number to restore (from list_versions)"),
+        confirm: z.boolean().describe("Must be true to confirm replacing the live site"),
+      }),
+    },
+    wrap(async ({ slug, version, confirm }) => {
+      if (!isLoggedIn()) return "Not logged in. Run `htmlhost login` in a terminal first.";
+      if (!confirm) return "Restore not confirmed. Set confirm to true to proceed.";
+      const cleanSlug = slug.replace(/\.htmlhost\.co$/, "");
+      const data = await apiPost(`/api/sites/${encodeURIComponent(cleanSlug)}/versions/${version}/restore`, {});
+      return {
+        message: `Restored v${version}; it's live as v${data.version}.`,
+        url: data.url ? (String(data.url).startsWith("http") ? data.url : `https://${data.url}`) : `https://${cleanSlug}.htmlhost.co`,
+        version: data.version,
+        restoredFrom: version,
+      };
+    })
+  );
+
   return server;
 }