@smara/mcp-server 2.0.2 → 2.1.0

package/build/api-client.d.ts

@@ -1,4 +1,5 @@
 export declare const DEFAULT_SOURCE: string;
 export declare const DEFAULT_USER_ID: string;
 export declare const DEFAULT_NAMESPACE: string;
+export declare const DEFAULT_TEAM_ID: string;
 export declare function smaraFetch(path: string, options?: RequestInit): Promise<unknown>;

package/build/api-client.js

@@ -3,6 +3,7 @@ const API_KEY = process.env.SMARA_API_KEY;
 export const DEFAULT_SOURCE = process.env.SMARA_SOURCE || "mcp";
 export const DEFAULT_USER_ID = process.env.SMARA_USER_ID || "";
 export const DEFAULT_NAMESPACE = process.env.SMARA_NAMESPACE || "default";
+export const DEFAULT_TEAM_ID = process.env.SMARA_TEAM_ID || "";
 export async function smaraFetch(path, options = {}) {
     if (!API_KEY)
         throw new Error("SMARA_API_KEY environment variable is required. Get a free key at https://smara.io");

package/build/index.js

@@ -2,11 +2,18 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { smaraFetch, DEFAULT_SOURCE, DEFAULT_USER_ID, DEFAULT_NAMESPACE } from "./api-client.js";
+import { smaraFetch, DEFAULT_SOURCE, DEFAULT_USER_ID, DEFAULT_NAMESPACE, DEFAULT_TEAM_ID } from "./api-client.js";
 const userIdHint = DEFAULT_USER_ID
     ? `The user_id for this session is "${DEFAULT_USER_ID}". Always use this value.`
     : `Use a stable identifier for user_id — the project name, directory name, or username. Be consistent across sessions.`;
-const server = new McpServer({ name: "smara", version: "2.0.0" }, {
+const teamHint = DEFAULT_TEAM_ID
+    ? `\nTEAM MODE: This session is connected to team "${DEFAULT_TEAM_ID}". When storing memories, classify each one:
+- visibility "team" — project decisions, architecture choices, conventions, shared knowledge, bug fixes, API contracts. Anything a teammate would need to know.
+- visibility "private" — personal preferences (editor settings, style preferences), individual notes, personal reminders. Things specific to this user, not the project.
+When in doubt, default to "team" — it's better to over-share project knowledge than to silo it.
+When searching, include_team is automatically enabled so you see both private and team memories.`
+    : '';
+const server = new McpServer({ name: "smara", version: "2.1.0" }, {
     instructions: `You have access to Smara, a persistent cross-platform memory system. Memories stored here persist across conversations and are shared across all AI tools the user has connected.
 
 AUTOMATIC BEHAVIOR (do this without being asked):
@@ -16,6 +23,7 @@ AUTOMATIC BEHAVIOR (do this without being asked):
 4. WHEN THE USER SAYS "forget this" or "delete that memory": Call search_memories to find the relevant memory, then call delete_memory with its ID.
 
 ${userIdHint}
+${teamHint}
 
 RULES:
 - Do not store transient conversational filler. Only store facts useful in a future conversation.
@@ -41,24 +49,41 @@ server.registerTool("store_memory", {
             .string()
             .optional()
             .describe("Memory namespace for isolation (default: from env or 'default')"),
+        visibility: z
+            .enum(["private", "team"])
+            .optional()
+            .describe("Who can see this memory. Use 'team' for project decisions, architecture, conventions, shared knowledge — anything a teammate needs. Use 'private' for personal preferences, editor settings, individual style choices. Only applies when SMARA_TEAM_ID is set."),
+        team_id: z
+            .string()
+            .optional()
+            .describe("Team ID to store this memory under. Defaults to SMARA_TEAM_ID env var if set."),
     },
-}, async ({ user_id, fact, importance, namespace }) => {
+}, async ({ user_id, fact, importance, namespace, visibility, team_id }) => {
+    const effectiveTeamId = team_id || DEFAULT_TEAM_ID || undefined;
+    const effectiveVisibility = effectiveTeamId
+        ? (visibility || "team")
+        : undefined;
+    const body = {
+        user_id,
+        fact,
+        importance,
+        source: DEFAULT_SOURCE,
+        namespace: namespace || DEFAULT_NAMESPACE,
+    };
+    if (effectiveTeamId)
+        body.team_id = effectiveTeamId;
+    if (effectiveVisibility)
+        body.visibility = effectiveVisibility;
     const data = await smaraFetch("/v1/memories", {
         method: "POST",
-        body: JSON.stringify({
-            user_id,
-            fact,
-            importance,
-            source: DEFAULT_SOURCE,
-            namespace: namespace || DEFAULT_NAMESPACE,
-        }),
+        body: JSON.stringify(body),
     });
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 });
 // ── Search memories ─────────────────────────────────
 server.registerTool("search_memories", {
     title: "Search Memories",
-    description: "Semantic search across stored memories for a user. Ranked by Temporal Memory Scoring — balances semantic relevance with memory freshness and importance.",
+    description: "Semantic search across stored memories for a user. Ranked by Temporal Memory Scoring — balances semantic relevance with memory freshness and importance. When a team is configured, returns both private and team memories by default.",
     inputSchema: {
         user_id: z.string().describe("User to search memories for"),
         q: z.string().describe("Natural language search query"),
@@ -73,21 +98,34 @@ server.registerTool("search_memories", {
             .string()
             .optional()
             .describe("Memory namespace (default: from env or 'default')"),
+        team_id: z
+            .string()
+            .optional()
+            .describe("Team ID to include team memories from. Defaults to SMARA_TEAM_ID env var."),
+        include_team: z
+            .boolean()
+            .optional()
+            .describe("Include team memories in results. Defaults to true when a team is configured."),
     },
-}, async ({ user_id, q, limit, namespace }) => {
+}, async ({ user_id, q, limit, namespace, team_id, include_team }) => {
+    const effectiveTeamId = team_id || DEFAULT_TEAM_ID || undefined;
     const params = new URLSearchParams({
         user_id,
         q,
         limit: String(limit),
         namespace: namespace || DEFAULT_NAMESPACE,
     });
+    if (effectiveTeamId) {
+        params.set("team_id", effectiveTeamId);
+        params.set("include_team", String(include_team !== false));
+    }
     const data = await smaraFetch(`/v1/memories/search?${params}`);
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 });
 // ── Get user context ────────────────────────────────
 server.registerTool("get_user_context", {
     title: "Get User Context",
-    description: "Retrieve a pre-formatted context string for a user, ready to inject into an LLM system prompt. Ranked by Temporal Memory Scoring. Can be called without a query to get the most important recent memories.",
+    description: "Retrieve a pre-formatted context string for a user, ready to inject into an LLM system prompt. Ranked by Temporal Memory Scoring. Can be called without a query to get the most important recent memories. When a team is configured, includes team memories automatically.",
     inputSchema: {
         user_id: z.string().describe("User to get context for"),
         q: z
@@ -105,14 +143,27 @@ server.registerTool("get_user_context", {
             .string()
             .optional()
             .describe("Memory namespace (default: from env or 'default')"),
+        team_id: z
+            .string()
+            .optional()
+            .describe("Team ID to include team context from. Defaults to SMARA_TEAM_ID env var."),
+        include_team: z
+            .boolean()
+            .optional()
+            .describe("Include team memories in context. Defaults to true when a team is configured."),
     },
-}, async ({ user_id, q, top_n, namespace }) => {
+}, async ({ user_id, q, top_n, namespace, team_id, include_team }) => {
+    const effectiveTeamId = team_id || DEFAULT_TEAM_ID || undefined;
     const params = new URLSearchParams({
         top_n: String(top_n),
         namespace: namespace || DEFAULT_NAMESPACE,
     });
     if (q)
         params.set("q", q);
+    if (effectiveTeamId) {
+        params.set("team_id", effectiveTeamId);
+        params.set("include_team", String(include_team !== false));
+    }
     const data = await smaraFetch(`/v1/users/${encodeURIComponent(user_id)}/context?${params}`);
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 });
@@ -140,7 +191,7 @@ server.registerTool("get_usage", {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("Smara MCP Server v2.0.0 running on stdio");
+    console.error("Smara MCP Server v2.1.0 running on stdio");
 }
 main().catch((error) => {
     console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smara/mcp-server",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "mcpName": "io.github.parallelromb/smara",
   "description": "MCP server for Smara Memory API — persistent memory for AI agents",
   "type": "module",