Central Intelligence

Instructions

Implementation Reference

• packages/mcp-server/src/index.ts:51-101 (handler)

  The 'remember' tool implementation, defining the schema and the async handler that calls the external API.

  server.tool(
    "remember",
    "Store information in persistent memory for later recall. Use when you learn something that should be remembered across sessions — user preferences, project decisions, important facts, or anything you might need later.",
    {
      content: z
        .string()
        .describe(
          "The information to remember. Be specific and include context so it's useful when recalled later.",
        ),
      agent_id: z
        .string()
        .default("default")
        .describe("Identifier for this agent instance"),
      user_id: z
        .string()
        .optional()
        .describe("User identifier for user-scoped memories"),
      tags: z
        .array(z.string())
        .default([])
        .describe(
          "Tags for categorizing the memory (e.g., 'preference', 'decision', 'fact')",
        ),
      scope: z
        .enum(["agent", "user", "org"])
        .default("agent")
        .describe(
          "Visibility scope: agent (only this agent), user (all agents for this user), org (all agents in the organization)",
        ),
    },
    async ({ content, agent_id, user_id, tags, scope }) => {
      const result = await apiCall("/memories/remember", "POST", {
        agent_id,
        user_id,
        content,
        tags,
        scope,
      });
  
      const memory = (result as { memory: { id: string; created_at: string } })
        .memory;
      return {
        content: [
          {
            type: "text" as const,
            text: `Remembered (id: ${memory.id}, stored at: ${memory.created_at}). This memory will be available in future sessions.`,
          },
        ],
      };
    },
  );