htmlhost-mcp 1.0.0 → 1.2.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`
 
@@ -95,6 +97,11 @@ title     (optional)  Title for the site
 ttl       (optional)  Time-to-live: 1d, 7d, 30d, or never
 ```
 
+A `_redirects` file at the root of a deployed directory sets the site's redirects,
+one per line: `/old-page /new-page`, optionally followed by `301` (default) or `302`.
+It isn't published. Each deploy with the file replaces the redirects it set before;
+redirects added in the dashboard stay. `pull_site` writes the file back.
+
 ### `deploy_html`
 
 Deploy generated HTML directly — no files on disk needed. Perfect for when an AI assistant generates a webpage and wants to make it live immediately.
@@ -138,6 +145,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.2.0",
   "description": "MCP server for htmlhost.co — deploy, list, and manage sites from AI coding tools",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -4,7 +4,7 @@
  * Reuses the same ~/.htmlhostrc token and API base as the CLI,
  * so `htmlhost login` is the only setup step needed.
  */
-import { readFileSync, writeFileSync, statSync, readdirSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, statSync, readdirSync, mkdirSync, existsSync } from "node:fs";
 import { join, basename, dirname, resolve } from "node:path";
 import { homedir } from "node:os";
 import { createHash } from "node:crypto";
@@ -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) {
@@ -132,6 +132,8 @@ const DEFAULT_IGNORE = [
   ".gitignore", ".npmrc", "package-lock.json", "yarn.lock", "pnpm-lock.yaml",
   "AGENTS.md", "CLAUDE.md", "GEMINI.md", ".claude", ".cursor", ".cursorrules",
   ".windsurfrules", ".github",
+  // Redirect rules: sent with the deploy and applied by htmlhost, never published as a file.
+  "_redirects",
 ];
 
 function shouldIgnore(name) {
@@ -184,6 +186,8 @@ export async function deployDirectory(dirPath, { slug = null, title = null, ttl
 
   const htmlFiles = allFiles.filter((f) => f.relativePath.endsWith(".html"));
   const assetFiles = allFiles.filter((f) => !f.relativePath.endsWith(".html"));
+  // Decided before upload-url may hand back a generated slug for the new site.
+  const isNewSite = !slug;
 
   // Build page payloads
   const pagePayloads = [];
@@ -232,12 +236,15 @@ export async function deployDirectory(dirPath, { slug = null, title = null, ttl
     }
   }
 
-  // Final deploy
+  // Final deploy. A root `_redirects` file (Netlify style) replaces the site's
+  // redirects from this file; rules added in the dashboard stay. No file, no change.
   const body = { pages: pagePayloads, assets: assetPayloads };
+  const redirectsPath = join(resolvedDir, "_redirects");
+  if (existsSync(redirectsPath)) body.redirects = readFileSync(redirectsPath, "utf8");
   if (ttl) body.ttl = ttl;
   if (slug) body.slug = slug;
   if (title) body.title = title;
-  if (!slug) body.isNewSite = true;
+  if (isNewSite) body.isNewSite = true;
 
   return await apiPost("/api/sites", body);
 }

package/src/server.mjs

@@ -26,7 +26,7 @@ import {
   mimeFromExt,
 } from "./api.mjs";
 
-const VERSION = "1.0.0";
+const VERSION = "1.2.0";
 
 /**
  * Helper: wraps a handler to return proper MCP content and catch errors.
@@ -59,7 +59,8 @@ export function createServer() {
       description:
         "Deploy a file or directory to htmlhost.co. " +
         "Pass an absolute path to a directory (deploys all files) or a single HTML file. " +
-        "Optionally set slug (to update an existing site), title, and ttl.",
+        "Optionally set slug (to update an existing site), title, and ttl. " +
+        "A `_redirects` file at the directory's root (one `/old /new [301|302]` per line) sets the site's redirects and isn't published.",
       inputSchema: z.object({
         path: z.string().describe("Absolute path to the file or directory to deploy"),
         slug: z.string().optional().describe("Existing site slug to update (omit to create a new site)"),
@@ -92,6 +93,7 @@ export function createServer() {
         pages: pc,
         ttl: data.ttl,
         expiresAt: data.expiresAt || null,
+        ...(data.redirects ? { redirects: data.redirects } : {}),
       };
     })
   );
@@ -219,6 +221,12 @@ export function createServer() {
         written.push(asset.path);
       }
 
+      // Redirects that came from a deployed _redirects file
+      if (data.redirectsFile) {
+        writeFileSync(join(destDir, "_redirects"), data.redirectsFile, "utf8");
+        written.push("_redirects");
+      }
+
       return {
         message: `Pulled ${written.length} files from ${cleanSlug}.htmlhost.co`,
         directory: destDir,
@@ -314,5 +322,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;
 }