spacepal-mcp 0.1.0 → 0.3.0

package/README.md

@@ -4,6 +4,8 @@ Lets Claude, Cursor and other MCP clients work with your macOS Spaces through
 [Spacepal](https://getspacepal.com): "switch to my Mail Space", "what's on Desktop 3?",
 "name this desktop Research".
 
+![An agent lists Spaces, switches to Research and names a desktop through the Spacepal MCP server (illustration)](https://getspacepal.com/media/mcp-agent.gif)
+
 It runs locally over stdio. It reads the Space list Spacepal writes to
 `~/Library/Application Support/Spacepal/state.json` and sends commands through the
 `spacepal://` URL scheme. It makes no network calls.
@@ -17,17 +19,35 @@ It runs locally over stdio. It reads the Space list Spacepal writes to
 
 | Tool | What it does |
 |---|---|
-| `list_spaces` | Every Space with its number, name, display, apps, and which one is active |
+| `list_spaces` | Every Space with its number, name, display, apps, note, and which one is active |
 | `current_space` | The Space you are on |
 | `switch_space` | Switch by number or name, or step with `next`, `previous`, `back` |
 | `move_window_to_space` | Send the frontmost window to a Space by number or name, or to `next` or `previous` |
 | `rename_space` | Name a Space; an empty name restores "Desktop N" |
-| `open_overview` | Open Spacepal's overview grid |
 | `set_space_note` | Attach a short note to a Space |
-| `apply_profile` | Apply a saved Spacepal profile |
+| `open_overview` | Open Spacepal's overview grid |
+| `list_profiles` | Names of your saved profiles |
+| `apply_profile` | Apply a saved profile (names, colours, notes and automations) |
+| `apply_template` | Name the Spaces from a starter template: Developer, Designer, Freelancer, Student, Streamer |
+| `set_up_space` | Switch to a Space and run its automations: open its apps, URLs and files |
+| `save_window_layout` | Save which Space and position every window is in |
+| `restore_window_layout` | Put windows back from the last saved layout |
+| `save_sessions` | Save terminal sessions and Chrome windows on one Space or all of them |
+| `restore_sessions` | Reopen saved sessions on their Spaces |
+| `add_desktop` | Add a desktop on the current display |
+| `remove_desktop` | Remove a desktop; its windows move to another one |
+
+Every tool is marked with MCP hints, so clients can tell the read-only tools apart and ask
+before `remove_desktop` or `apply_template`, which change your setup.
 
 `move_window_to_space` acts on the frontmost window. In Claude Desktop that is usually
-Claude's own window. Moving the frontmost window works on every supported macOS version.
+Claude's own window. It moves the window directly on macOS 14.0–14.4 and 26.4+, and by
+dragging it on other versions. `restore_window_layout` can only move windows between
+Spaces on 14.0–14.4 and 26.4+.
+
+The MCP server is free. The tools follow the app's own limits: after Spacepal's 14-day
+trial, names and notes stay free, while the overview, sessions and other Pro features need a
+license.
 
 ## Install
 

package/index.js

@@ -13,13 +13,17 @@ import { join } from "node:path";
 import { promisify } from "node:util";
 
 const run = promisify(execFile);
-const VERSION = "0.1.0";
+const VERSION = "0.3.0";
 
 // Direct build writes to Application Support; the App Store build is sandboxed.
-const STATE_FILES = [
-  join(homedir(), "Library/Application Support/Spacepal/state.json"),
-  join(homedir(), "Library/Containers/com.halberd.spacepal/Data/Library/Application Support/Spacepal/state.json"),
+const SUPPORT_DIRS = [
+  join(homedir(), "Library/Application Support/Spacepal"),
+  join(homedir(), "Library/Containers/com.halberd.spacepal/Data/Library/Application Support/Spacepal"),
 ];
+const STATE_FILES = SUPPORT_DIRS.map((d) => join(d, "state.json"));
+const PROFILE_FILES = SUPPORT_DIRS.map((d) => join(d, "profiles.json"));
+// Built into the app (Profiles.swift, SpaceTemplate.all()).
+const TEMPLATES = ["Developer", "Designer", "Freelancer", "Student", "Streamer"];
 
 const NOT_RUNNING = "Spacepal is not running. Open Spacepal (getspacepal.com) and try again.";
 
@@ -32,16 +36,30 @@ async function isRunning() {
   }
 }
 
-async function readState() {
+async function newestFile(paths) {
   let newest = null;
-  for (const path of STATE_FILES) {
+  for (const path of paths) {
     try {
       const { mtimeMs } = await stat(path);
       if (!newest || mtimeMs > newest.mtimeMs) newest = { path, mtimeMs };
     } catch {}
   }
-  if (!newest) return null;
-  return JSON.parse(await readFile(newest.path, "utf8"));
+  return newest?.path ?? null;
+}
+
+async function readState() {
+  const path = await newestFile(STATE_FILES);
+  return path ? JSON.parse(await readFile(path, "utf8")) : null;
+}
+
+async function readProfiles() {
+  const path = await newestFile(PROFILE_FILES);
+  if (!path) return [];
+  try {
+    return JSON.parse(await readFile(path, "utf8")).map((p) => p.name);
+  } catch {
+    return [];
+  }
 }
 
 async function send(path, query = {}) {
@@ -95,18 +113,53 @@ function guarded(fn) {
   };
 }
 
-const server = new McpServer({ name: "spacepal", version: VERSION });
+const INSTRUCTIONS = `Spacepal MCP server: work with macOS Spaces (desktops) through the Spacepal app on this Mac.
+
+Start with list_spaces to learn the Spaces, their numbers, names, notes and the apps on each; most tools take a Space by desktop number or by name from that list. Use current_space when you only need the active one.
+
+Tools that only read: list_spaces, current_space, list_profiles. Tools that change the user's screen or setup: everything else. Ask the user before remove_desktop, apply_template and apply_profile, which replace or remove things; rename_space and set_space_note are easy to undo by calling them again.
+
+Every action goes through Spacepal, so it must be running (macOS 14 or later). Nothing is sent over the network. If a tool says Spacepal is not running, tell the user to open it. The overview and sessions need Spacepal's trial or a license; names, notes and switching work in the free version.`;
+
+const server = new McpServer({ name: "spacepal", version: VERSION }, { instructions: INSTRUCTIONS });
+
 const spaceArg = z
   .union([z.number().int().positive(), z.string().min(1)])
-  .describe("Desktop number (1, 2, ...) or Space name, e.g. \"Mail\".");
+  .describe(
+    'Which Space: its desktop number (1 = leftmost on the display) or its name as list_spaces shows it, e.g. "Mail". Names match without regard to case.',
+  );
+const optionalSpaceArg = spaceArg.optional().describe(
+  'Which Space: desktop number or name from list_spaces. Leave it out for the Space the user is on now.',
+);
+
+const spaceEntry = z
+  .object({
+    id: z.string().describe("Stable id of the Space"),
+    name: z.string().describe("Name shown in Spacepal, or \"Desktop N\" if unnamed"),
+    number: z.number().int().optional().describe("Desktop number on its display; absent for full-screen Spaces"),
+    display: z.string().describe("Id of the display the Space is on"),
+    isActive: z.boolean().describe("True for the Space currently shown on its display"),
+    isFullscreen: z.boolean().describe("True for an app's full-screen Space"),
+    apps: z.array(z.string()).describe("Apps with a window on this Space"),
+    note: z.string().optional().describe("The user's note about what the Space is for"),
+    color: z.string().optional().describe("Colour as #RRGGBB"),
+  })
+  .passthrough();
+
+const RO = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+const CHANGE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 
 server.registerTool(
   "list_spaces",
   {
     title: "List Spaces",
-    description: "List every macOS Space (desktop) with its number, name, display, apps and which one is active.",
+    description:
+      "List every macOS Space (desktop) on every display: desktop number, name, note, the apps with windows on it, and which one is active. " +
+      "Read-only. Call this first to get valid Space numbers and names for the other tools. " +
+      "Fails if Spacepal is not running or has not written its list yet.",
     inputSchema: {},
-    annotations: { readOnlyHint: true },
+    outputSchema: { current: z.string().describe("Name of the active Space"), spaces: z.array(spaceEntry) },
+    annotations: { title: "List Spaces", ...RO },
   },
   guarded(async () => {
     if (!(await isRunning())) return fail(NOT_RUNNING);
@@ -115,14 +168,15 @@ server.registerTool(
     const lines = state.spaces.map((s) => {
       const label = s.isFullscreen ? "full screen" : `Desktop ${s.number ?? "?"}`;
       const apps = s.apps?.length ? ` — ${s.apps.join(", ")}` : "";
-      return `${s.isActive ? "*" : " "} ${label}: ${s.name}${apps}`;
+      const note = s.note ? ` (note: ${s.note})` : "";
+      return `${s.isActive ? "*" : " "} ${label}: ${s.name}${apps}${note}`;
     });
     const displays = new Set(state.spaces.map((s) => s.display)).size;
     return {
       content: [
         { type: "text", text: `Current: ${state.current}\n${displays} display(s), ${state.spaces.length} Spaces (* = active)\n${lines.join("\n")}` },
       ],
-      structuredContent: state,
+      structuredContent: { current: state.current ?? "", spaces: state.spaces },
     };
   }),
 );
@@ -131,16 +185,22 @@ server.registerTool(
   "current_space",
   {
     title: "Current Space",
-    description: "Name and number of the Space you are on.",
+    description:
+      "Return the Space the user is on now: its name and desktop number (one per display). " +
+      "Read-only and cheaper than list_spaces when you only need the active Space.",
     inputSchema: {},
-    annotations: { readOnlyHint: true },
+    outputSchema: { spaces: z.array(spaceEntry).describe("The active Space on each display") },
+    annotations: { title: "Current Space", ...RO },
   },
   guarded(async () => {
     if (!(await isRunning())) return fail(NOT_RUNNING);
     const state = await readState();
-    const active = state?.spaces.filter((s) => s.isActive) ?? [];
-    if (!active.length) return text(state?.current ? `Current: ${state.current}` : "Unknown");
-    return text(active.map((s) => `${s.name} (Desktop ${s.number ?? "full screen"})`).join("\n"));
+    if (!state) return fail("Spacepal has not written its Space list yet. Open the Spacepal menu once and try again.");
+    const active = state.spaces.filter((s) => s.isActive);
+    const t = active.length
+      ? active.map((s) => `${s.name} (Desktop ${s.number ?? "full screen"})`).join("\n")
+      : `Current: ${state.current || "unknown"}`;
+    return { content: [{ type: "text", text: t }], structuredContent: { spaces: active } };
   }),
 );
 
@@ -148,8 +208,16 @@ server.registerTool(
   "switch_space",
   {
     title: "Switch Space",
-    description: "Switch to a Space by desktop number or name. Use \"next\", \"previous\" or \"back\" to step.",
-    inputSchema: { space: spaceArg },
+    description:
+      "Show another Space on the user's screen, instantly and without the slide animation. " +
+      'Give a desktop number or name from list_spaces, or "next", "previous" (neighbouring desktop) or "back" (the Space shown before). ' +
+      "Changes only what is visible; no windows move. Undo with space=\"back\". Returns the Space now shown; fails if no Space has that name.",
+    inputSchema: {
+      space: spaceArg.describe(
+        'Desktop number or name from list_spaces, or one of "next", "previous", "back".',
+      ),
+    },
+    annotations: { title: "Switch Space", ...CHANGE, idempotentHint: true },
   },
   guarded(async ({ space }) => {
     const before = (await readState())?.current;
@@ -174,9 +242,16 @@ server.registerTool(
   {
     title: "Move window to Space",
     description:
-      "Send the frontmost window to another Space (by number or name, or \"next\"/\"previous\"). " +
-      "Note: moving windows needs macOS 14.0-14.4 or 26.4+, a macOS limit.",
-    inputSchema: { space: spaceArg },
+      "Move the user's frontmost window to another Space; the window keeps its size and position. " +
+      'Target is a desktop number or name from list_spaces, or "next"/"previous". ' +
+      "The frontmost window is the one the user last focused: from a terminal client that is usually the window they worked in, " +
+      "from Claude Desktop it is Claude's own window. On macOS 14.0-14.4 and 26.4+ the window moves directly; on other versions " +
+      "Spacepal drags it, which takes a moment. Depending on the user's settings the screen may follow the window. " +
+      "Undo by moving it back. Fails if no Space has that name.",
+    inputSchema: {
+      space: spaceArg.describe('Target desktop number or name from list_spaces, or "next" / "previous".'),
+    },
+    annotations: { title: "Move window to Space", ...CHANGE },
   },
   guarded(async ({ space }) => {
     const s = String(space).toLowerCase();
@@ -194,11 +269,15 @@ server.registerTool(
   "rename_space",
   {
     title: "Rename Space",
-    description: "Give a Space a name. Leave space empty for the current one; an empty name restores the default.",
+    description:
+      "Set the name Spacepal shows for a Space in its menu bar, overview and Mission Control. " +
+      "Replaces the old name; an empty name goes back to \"Desktop N\". The name stays with the Space even if desktops are reordered. " +
+      "Reversible: call again with the old name (get it from list_spaces first). Fails if the Space does not exist.",
     inputSchema: {
-      space: spaceArg.optional(),
-      name: z.string().max(60).describe("New name. Empty text restores \"Desktop N\"."),
+      space: optionalSpaceArg,
+      name: z.string().max(60).describe('New name, up to 60 characters. Empty text ("") restores the default "Desktop N".'),
     },
+    annotations: { title: "Rename Space", ...CHANGE, idempotentHint: true },
   },
   guarded(async ({ space, name }) => {
     if (space !== undefined && !(await findSpace(space))) return fail(`No Space called "${space}".`);
@@ -208,29 +287,61 @@ server.registerTool(
   }),
 );
 
+server.registerTool(
+  "set_space_note",
+  {
+    title: "Set Space note",
+    description:
+      "Set the short note that says what a Space is for, e.g. \"Client B invoices\"; list_spaces returns it and Spacepal shows it in its overview. " +
+      "Replaces any existing note; empty text removes the note. Reversible by setting the old note again (read it from list_spaces first). " +
+      "Fails if the Space does not exist.",
+    inputSchema: {
+      space: optionalSpaceArg,
+      text: z.string().max(500).describe('The note, up to 500 characters. Empty text ("") removes the note.'),
+    },
+    annotations: { title: "Set Space note", ...CHANGE, idempotentHint: true },
+  },
+  guarded(async ({ space, text: note }) => {
+    if (space !== undefined && !(await findSpace(space))) return fail(`No Space called "${space}".`);
+    await send(`note/${ref(space)}`, { text: note });
+    return text(note ? "Note saved." : "Note removed.");
+  }),
+);
+
 server.registerTool(
   "open_overview",
   {
     title: "Open overview",
-    description: "Open Spacepal's overview grid of all Spaces on screen.",
+    description:
+      "Show Spacepal's full-screen overview of every Space with live previews, for the user to look at and pick from. " +
+      "It is a toggle: calling it while the overview is open closes it. Changes nothing else. " +
+      "Needs Spacepal's trial or a license; without one Spacepal shows its license window instead. To get the Space list as data, use list_spaces.",
     inputSchema: {},
+    annotations: { title: "Open overview", ...CHANGE },
   },
   guarded(async () => {
     await send("overview");
-    return text("Overview opened.");
+    return text("Asked Spacepal to open the overview. It opens if the trial is running or Spacepal is licensed; otherwise Spacepal shows its license window.");
   }),
 );
 
 server.registerTool(
-  "set_space_note",
+  "list_profiles",
   {
-    title: "Set Space note",
-    description: "Attach a short note to a Space (what it is for).",
-    inputSchema: { space: spaceArg.optional(), text: z.string().max(500) },
+    title: "List profiles",
+    description:
+      "List the names of the user's saved Spacepal profiles. A profile is a saved set of Space names, colours, notes and automations, such as \"Work\" and \"Home\". " +
+      "Read-only. Use it to get a valid name for apply_profile.",
+    inputSchema: {},
+    outputSchema: { profiles: z.array(z.string()).describe("Saved profile names") },
+    annotations: { title: "List profiles", ...RO },
   },
-  guarded(async ({ space, text: note }) => {
-    await send(`note/${ref(space)}`, { text: note });
-    return text("Note saved.");
+  guarded(async () => {
+    const names = await readProfiles();
+    return {
+      content: [{ type: "text", text: names.length ? names.join("\n") : "No saved profiles yet." }],
+      structuredContent: { profiles: names },
+    };
   }),
 );
 
@@ -238,12 +349,187 @@ server.registerTool(
   "apply_profile",
   {
     title: "Apply profile",
-    description: "Apply a saved Spacepal profile by name (names, layouts and rules).",
-    inputSchema: { name: z.string().min(1) },
+    description:
+      "Switch to one of the user's saved profiles, replacing the names, colours, notes and automations of every Space with the profile's. " +
+      "If a profile was active, Spacepal first saves the current set under it, so the user can switch back. If none was active, the current names are not saved anywhere and are lost, so ask the user to save them as a profile first. " +
+      "Windows and desktops are not changed. Unlike apply_template, which uses built-in starter names, this uses the user's own saved sets. " +
+      "Get valid names from list_profiles; fails with the list of names if the profile does not exist. Ask the user first.",
+    inputSchema: {
+      name: z.string().min(1).describe("Profile name from list_profiles. Matching ignores case."),
+    },
+    annotations: { title: "Apply profile", ...CHANGE, destructiveHint: true, idempotentHint: true },
+  },
+  guarded(async ({ name }) => {
+    const names = await readProfiles();
+    const match = names.find((n) => n.toLowerCase() === name.toLowerCase());
+    if (!match) {
+      return fail(names.length ? `No profile called "${name}". Profiles: ${names.join(", ")}.` : "No saved profiles yet. Save one in Spacepal Settings, Profiles.");
+    }
+    await send(`profile/${encodeURIComponent(match)}`);
+    return text(`Applied profile "${match}".`);
+  }),
+);
+
+server.registerTool(
+  "apply_template",
+  {
+    title: "Apply template",
+    description:
+      `Name and colour the user's desktops from one of Spacepal's built-in starter templates: ${TEMPLATES.join(", ")}. ` +
+      "Overwrites the names, colours and notes of the desktops it covers, so ask the user first; to keep the current names they can save them as a profile in Spacepal. " +
+      "If the template needs more desktops than exist, Spacepal shows a dialog on screen asking the user whether to add them. " +
+      "For the user's own saved sets use apply_profile instead.",
+    inputSchema: { name: z.enum(TEMPLATES).describe("Template name, exactly as listed") },
+    annotations: { title: "Apply template", ...CHANGE, destructiveHint: true, idempotentHint: true },
   },
   guarded(async ({ name }) => {
-    await send(`profile/${encodeURIComponent(name)}`);
-    return text(`Applied profile "${name}".`);
+    await send(`template/${encodeURIComponent(name)}`);
+    await settle();
+    return text(`Applied the ${name} template.`);
+  }),
+);
+
+server.registerTool(
+  "set_up_space",
+  {
+    title: "Set up Space",
+    description:
+      "Switch to a Space and open the apps, URLs and files its Spacepal automation lists, even if they were opened before. " +
+      "Entering the Space also runs its usual on-enter actions, such as a Shortcut. Use it to prepare a workspace; to only change the visible Space use switch_space. " +
+      "Opens apps on the user's Mac, so it cannot be undone automatically. Does nothing beyond switching if the Space has no automation. Fails if the Space does not exist.",
+    inputSchema: { space: optionalSpaceArg },
+    annotations: { title: "Set up Space", ...CHANGE },
+  },
+  guarded(async ({ space }) => {
+    const target = space === undefined ? null : await findSpace(space);
+    if (space !== undefined && !target) return fail(`No Space called "${space}".`);
+    await send(`setup/${ref(space)}`);
+    return text(`Setting up ${target?.name ?? "the current Space"}.`);
+  }),
+);
+
+server.registerTool(
+  "save_window_layout",
+  {
+    title: "Save window layout",
+    description:
+      "Record which Space and screen position every open window has, for the current display setup, so restore_window_layout can put them back. " +
+      "Overwrites the previous manual save for these displays (Spacepal also saves automatically in the background). Moves nothing.",
+    inputSchema: {},
+    annotations: { title: "Save window layout", ...CHANGE, idempotentHint: true },
+  },
+  guarded(async () => {
+    await send("save-layout");
+    return text("Saved the window layout.");
+  }),
+);
+
+server.registerTool(
+  "restore_window_layout",
+  {
+    title: "Restore window layout",
+    description:
+      "Move open windows back to the Spaces and positions recorded by save_window_layout (or Spacepal's automatic save) for the current display setup. " +
+      "Moving windows between Spaces only works on macOS 14.0-14.4 and 26.4+; on other versions positions are restored but windows stay on their Space. " +
+      "Windows of apps that are not open are skipped; to reopen terminals and Chrome windows use restore_sessions. Spacepal shows how many windows it moved.",
+    inputSchema: {},
+    annotations: { title: "Restore window layout", ...CHANGE, idempotentHint: true },
+  },
+  guarded(async () => {
+    await send("restore-layout");
+    return text("Asked Spacepal to restore the saved layout. It shows how many windows it moved.");
+  }),
+);
+
+server.registerTool(
+  "save_sessions",
+  {
+    title: "Save sessions",
+    description:
+      "Save the terminal windows (with their folders) and Chrome windows (with their tabs) on one Space, or on every Space with all=true, " +
+      "so restore_sessions can reopen them on the right Space after a restart. Replaces the earlier save for those Spaces and drops windows that were closed. " +
+      "Needs Spacepal's trial or a license; without one nothing is saved.",
+    inputSchema: {
+      space: optionalSpaceArg,
+      all: z.boolean().optional().describe("true to save every Space; then space is ignored. Default false."),
+    },
+    annotations: { title: "Save sessions", ...CHANGE, idempotentHint: true },
+  },
+  guarded(async ({ space, all }) => {
+    if (all) {
+      await send("session-save/all");
+      return text("Asked Spacepal to save sessions on every Space. It shows how many windows it saved.");
+    }
+    if (space !== undefined && !(await findSpace(space))) return fail(`No Space called "${space}".`);
+    await send(`session-save/${ref(space)}`);
+    return text("Asked Spacepal to save the sessions. It shows how many windows it saved.");
+  }),
+);
+
+server.registerTool(
+  "restore_sessions",
+  {
+    title: "Restore sessions",
+    description:
+      "Reopen the terminal and Chrome windows saved by save_sessions, each on the Space it was saved from. " +
+      "Opens new windows, so calling it twice can open duplicates. Needs Spacepal's trial or a license. " +
+      "To move windows that are already open, use restore_window_layout instead.",
+    inputSchema: {},
+    annotations: { title: "Restore sessions", ...CHANGE },
+  },
+  guarded(async () => {
+    await send("session-restore");
+    return text("Asked Spacepal to reopen the saved sessions.");
+  }),
+);
+
+server.registerTool(
+  "add_desktop",
+  {
+    title: "Add desktop",
+    description:
+      "Create a new empty desktop at the end of the display the pointer is on. Mission Control opens for a moment while Spacepal adds it. " +
+      "Undo with remove_desktop. Returns the new number of Spaces once Spacepal confirms it.",
+    inputSchema: {},
+    annotations: { title: "Add desktop", ...CHANGE },
+  },
+  guarded(async () => {
+    const before = (await readState())?.spaces.length ?? 0;
+    await send("add-desktop");
+    const end = Date.now() + 4000;
+    while (Date.now() < end) {
+      await new Promise((r) => setTimeout(r, 250));
+      const after = (await readState())?.spaces.length ?? 0;
+      if (after > before) return text(`Added a desktop. ${after} Spaces now.`);
+    }
+    return text("Asked Spacepal to add a desktop; it has not confirmed it yet.");
+  }),
+);
+
+server.registerTool(
+  "remove_desktop",
+  {
+    title: "Remove desktop",
+    description:
+      "Close a desktop, as with its close button in Mission Control. Its windows move to another desktop and are not closed, " +
+      "but its Spacepal name, note and automation are lost and cannot be restored automatically. Full-screen Spaces cannot be removed this way. " +
+      "Always ask the user before calling this. Fails if the Space does not exist.",
+    inputSchema: { space: spaceArg.describe("Desktop number or name from list_spaces") },
+    annotations: { title: "Remove desktop", ...CHANGE, destructiveHint: true },
+  },
+  guarded(async ({ space }) => {
+    const target = await findSpace(space);
+    if (!target) return fail(`No Space called "${space}". Call list_spaces to see the names.`);
+    if (target.isFullscreen) return fail(`${target.name} is a full-screen Space. Leave full screen in that app instead.`);
+    const before = (await readState())?.spaces.length ?? 0;
+    await send(`remove-desktop/${ref(space)}`);
+    const end = Date.now() + 4000;
+    while (Date.now() < end) {
+      await new Promise((r) => setTimeout(r, 250));
+      const after = (await readState())?.spaces.length ?? 0;
+      if (after < before) return text(`Removed ${target.name}. ${after} Spaces now.`);
+    }
+    return text(`Asked Spacepal to remove ${target.name}; it has not confirmed it yet.`);
   }),
 );
 

package/package.json

@@ -1,19 +1,45 @@
 {
   "name": "spacepal-mcp",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server for Spacepal: list, switch, rename macOS Spaces and move windows between them from Claude, Cursor or any MCP client.",
   "mcpName": "com.getspacepal/spacepal",
   "type": "module",
-  "bin": { "spacepal-mcp": "index.js" },
-  "files": ["index.js", "README.md", "LICENSE", "server.json"],
-  "engines": { "node": ">=18" },
-  "os": ["darwin"],
-  "keywords": ["mcp", "model-context-protocol", "macos", "spaces", "mission-control", "spacepal", "claude"],
+  "bin": {
+    "spacepal-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE",
+    "server.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "macos",
+    "spaces",
+    "mission-control",
+    "spacepal",
+    "claude"
+  ],
   "homepage": "https://getspacepal.com/integrations/mcp/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanKucukhas/spacepal-mcp.git"
+  },
   "author": "Halberd LLC",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.0",
-    "zod": "^3.23.8"
+    "zod": "^4.6.7"
+  },
+  "scripts": {
+    "test": "node test/smoke.mjs"
   }
 }

package/server.json

@@ -3,14 +3,16 @@
   "name": "com.getspacepal/spacepal",
   "title": "Spacepal",
   "description": "List, switch and rename macOS Spaces and move windows between them. Needs the Spacepal app.",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "websiteUrl": "https://getspacepal.com/integrations/mcp/",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "spacepal-mcp",
-      "version": "0.1.0",
-      "transport": { "type": "stdio" }
+      "version": "0.3.0",
+      "transport": {
+        "type": "stdio"
+      }
     }
   ]
 }