fathom-mcp 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "MCP server for Fathom — vault operations, search, rooms, and cross-workspace communication",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -139,33 +139,16 @@ async function runInit() {
   // 2. Vault subdirectory
   const vault = await ask(rl, "  Vault subdirectory", "vault");
 
-  // 3. Server URL
+  // 3. Description (optional)
+  const description = await ask(rl, "  Workspace description (optional)", "");
+
+  // 4. Server URL
   const serverUrl = await ask(rl, "  Fathom server URL", "http://localhost:4243");
 
-  // 4. API key
-  let apiKey = "";
-  const tryFetch = await askYesNo(rl, "  Fetch API key from server?", true);
-  if (tryFetch) {
-    console.log("  Connecting to server...");
-    const tmpClient = createClient({ server: serverUrl, apiKey: "", workspace });
-    const isUp = await tmpClient.healthCheck();
-    if (isUp) {
-      const keyResp = await tmpClient.getApiKey();
-      if (keyResp.api_key) {
-        apiKey = keyResp.api_key;
-        console.log(`  Got API key: ${apiKey.slice(0, 7)}...${apiKey.slice(-4)}`);
-      } else {
-        console.log("  Could not fetch key (auth may not be configured yet).");
-      }
-    } else {
-      console.log("  Server not reachable. You can add the API key to .fathom.json later.");
-    }
-  }
-  if (!apiKey) {
-    apiKey = await ask(rl, "  API key (or leave blank)", "");
-  }
+  // 5. API key — user gets this from the dashboard or server first-run output
+  const apiKey = await ask(rl, "  API key (from dashboard or server first-run output)", "");
 
-  // 5. Hooks
+  // 6. Hooks
   const enableRecallHook = await askYesNo(rl, "  Enable vault recall on every message (UserPromptSubmit)?", true);
   const enablePrecompactHook = await askYesNo(rl, "  Enable PreCompact vault snapshot hook?", true);
 
@@ -181,6 +164,7 @@ async function runInit() {
     vault,
     server: serverUrl,
     apiKey,
+    description,
     hooks: {
       "vault-recall": { enabled: enableRecallHook },
       "precompact-snapshot": { enabled: enablePrecompactHook },
@@ -270,7 +254,7 @@ async function runInit() {
     const regClient = createClient({ server: serverUrl, apiKey, workspace });
     const isUp = await regClient.healthCheck();
     if (isUp) {
-      const regResult = await regClient.registerWorkspace(workspace, cwd);
+      const regResult = await regClient.registerWorkspace(workspace, cwd, { vault, description });
       if (regResult.ok) {
         console.log(`  ✓ Registered workspace "${workspace}" with server`);
       } else if (regResult.error) {

package/src/config.js

@@ -17,6 +17,7 @@ const DEFAULTS = {
   vault: "vault",
   server: "http://localhost:4243",
   apiKey: "",
+  description: "",
   hooks: {
     "context-inject": { enabled: true },
     "precompact-snapshot": { enabled: true },
@@ -65,6 +66,7 @@ export function resolveConfig(startDir = process.cwd()) {
     if (config.vault) result.vault = config.vault;
     if (config.server) result.server = config.server;
     if (config.apiKey) result.apiKey = config.apiKey;
+    if (config.description) result.description = config.description;
     if (config.hooks) {
       result.hooks = { ...result.hooks, ...config.hooks };
     }
@@ -81,6 +83,9 @@ export function resolveConfig(startDir = process.cwd()) {
     result.workspace = path.basename(projectDir);
   }
 
+  // Preserve raw vault name before resolving to absolute (for registration)
+  result._rawVault = result.vault;
+
   // Resolve vault to absolute path
   if (!path.isAbsolute(result.vault)) {
     result.vault = path.join(projectDir, result.vault);
@@ -105,6 +110,7 @@ export function writeConfig(dir, config) {
     vault: config.vault || "vault",
     server: config.server || DEFAULTS.server,
     apiKey: config.apiKey || "",
+    description: config.description || "",
     hooks: config.hooks || DEFAULTS.hooks,
   };
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");

package/src/index.js

@@ -453,6 +453,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 
 async function main() {
+  // Auto-register workspace with server (fire-and-forget)
+  if (config.server && config.workspace) {
+    client.registerWorkspace(config.workspace, config._projectDir, {
+      vault: config._rawVault,
+      description: config.description,
+    }).catch(() => {});
+  }
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/src/server-client.js

@@ -104,10 +104,11 @@ export function createClient(config) {
     return request("GET", "/api/workspaces/profiles");
   }
 
-  async function registerWorkspace(name, projectPath) {
-    return request("POST", "/api/workspaces", {
-      body: { name, path: projectPath },
-    });
+  async function registerWorkspace(name, projectPath, { vault, description } = {}) {
+    const body = { name, path: projectPath };
+    if (vault) body.vault = vault;
+    if (description) body.description = description;
+    return request("POST", "/api/workspaces", { body });
   }
 
   // --- Access tracking -------------------------------------------------------