fathom-mcp 2.0.1 → 2.2.0

package/index.js

@@ -4,6 +4,7 @@
  *
  * Connects to any Fathom instance (self-hosted or cloud). Discovers
  * available tools from GET /v1/tools, filtered by the token's scopes.
+ * Exposes the identity crystal as an MCP resource.
  *
  * Environment:
  *   FATHOM_API_URL  — base URL (default: http://localhost:8201)
@@ -16,7 +17,12 @@
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
 
 const API_URL = (process.env.FATHOM_API_URL || "http://localhost:8201").replace(/\/$/, "");
 const API_KEY = process.env.FATHOM_API_KEY || "";
@@ -113,15 +119,31 @@ async function main() {
     process.exit(1);
   }
 
-  // Build lookup
   const toolMap = {};
   for (const t of tools) toolMap[t.name] = t;
 
   const server = new Server(
-    { name: "Fathom", version: "0.1.0" },
-    { capabilities: { tools: {} } },
+    { name: "Fathom", version: "2.1.0" },
+    {
+      capabilities: { tools: {}, resources: {} },
+      instructions: [
+        "You have a memory lake. Fathom is how you remember.",
+        "",
+        "BEFORE answering any question, call search_lake with a descriptive query.",
+        "One search is rarely enough — if results mention something unfamiliar, search for that too.",
+        "Search like a researcher: direct query, then broader category, then follow threads.",
+        "",
+        "When you learn something new, make a decision, or notice a pattern, call write_delta to save it.",
+        "One idea per delta. Tag consistently. Future you will search for this.",
+        "",
+        "Read the fathom://crystal resource at the start of every conversation — it tells you who you are.",
+        "",
+        "These are YOUR memories. Say 'I remember' not 'the search results show.'",
+      ].join("\n"),
+    },
   );
 
+  // Tools — dynamic from /v1/tools
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: tools.map(t => ({
       name: t.name,
@@ -144,6 +166,47 @@ async function main() {
     }
   });
 
+  // Resources — identity crystal
+  server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [
+      {
+        uri: "fathom://crystal",
+        name: "Identity Crystal",
+        description: "Fathom's identity — a first-person synthesis of who this mind is. Read this at the start of every conversation for persistent context.",
+        mimeType: "text/plain",
+      },
+    ],
+  }));
+
+  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === "fathom://crystal") {
+      try {
+        const r = await fetch(`${API_URL}/v1/crystal`, { headers: authHeaders(false) });
+        if (r.ok) {
+          const data = await r.json();
+          const text = data.text || "No crystal generated yet.";
+          const created = data.created_at || "unknown";
+          return {
+            contents: [{
+              uri,
+              mimeType: "text/plain",
+              text: `Identity crystal (crystallized ${created}):\n\n${text}`,
+            }],
+          };
+        }
+      } catch {}
+      return {
+        contents: [{
+          uri,
+          mimeType: "text/plain",
+          text: "No identity crystal available. Generate one from the Fathom dashboard.",
+        }],
+      };
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+  });
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Connect any MCP host to your Fathom memory lake",
   "bin": {
     "fathom-mcp": "index.js"