fix(mcp): adapt community fixes to v5

Restricts add_memory metadata to the flat value types v5 accepts, points the pagination hint at list_memories, and documents MCP_RESOURCE in .dev.vars.example now that OAuth metadata is advertised from it.

apps/mcp/.dev.vars.example

@@ -3,6 +3,8 @@
 
 API_URL=
 MCP_URL=
+# OAuth metadata is advertised from this, so set it to your local MCP URL + /mcp (defaults to prod).
+MCP_RESOURCE=
 
 #(optional)
 POSTHOG_API_KEY=

apps/mcp/src/server/client/index.ts

@@ -196,7 +196,7 @@ export class SupermemoryClient {
 
 	async createMemory(
 		content: string,
-		metadata?: Record<string, unknown>,
+		metadata?: Record<string, string | number | boolean | string[]>,
 	): Promise<{ id: string; status: string; namespace: string }> {
 		try {
 			const result = await this.client.add(this.namespace, {

apps/mcp/src/server/format.test.ts

@@ -65,7 +65,7 @@ describe("formatMemoryEntriesList", () => {
 		)
 
 		expect(firstPage).toBe(
-			"No active memories on page 1 (2 pages total).\n\nMore available - call listMemories with page: 2.",
+			"No active memories on page 1 (2 pages total).\n\nMore available - call list_memories with page: 2.",
 		)
 		expect(secondPage).toContain("[still-active] Current fact")
 	})

apps/mcp/src/server/format.ts

@@ -91,7 +91,7 @@ export function formatMemoryEntriesList(
 		if (pagination.currentPage < pagination.totalPages) {
 			parts.push(
 				"",
-				`More available - call listMemories with page: ${pagination.currentPage + 1}.`,
+				`More available - call list_memories with page: ${pagination.currentPage + 1}.`,
 			)
 		}
 		return parts.join("\n")

apps/mcp/src/server/tools/add-memory.ts

@@ -25,7 +25,14 @@ export function register(deps: ToolDeps) {
 			),
 		namespace: optionalNamespaceSchema,
 		...legacyNamespaceInput,
-		metadata: z.record(z.string(), z.unknown()).optional().describe("Optional metadata to attach to the saved memory"),
+		// v5 metadata values are flat: string, number, boolean or string list.
+		metadata: z
+			.record(
+				z.string(),
+				z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]),
+			)
+			.optional()
+			.describe("Optional metadata to attach to the saved memory"),
 	})
 
 	deps.server.registerTool(