activate_cluster
Enable a memory cluster by providing its UUID and optional context, allowing AI systems to access associated memories for continuity across interactions with the AGI MCP Server.
Instructions
Activate a memory cluster and get its associated memories
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cluster_id | Yes | UUID of the cluster to activate | |
| context | No | Context description for this activation |
Implementation Reference
- src/memory-manager.js:315-343 (handler)Core handler function that executes the activate_cluster tool logic: updates cluster activation count and last activated time, records activation history, and returns associated memories via getClusterMemories.async activateCluster(clusterId, context = null) { try { const result = await this.db.transaction(async (tx) => { // Update cluster activation await tx .update(schema.memoryClusters) .set({ activationCount: sql`${schema.memoryClusters.activationCount} + 1`, lastActivated: new Date() }) .where(eq(schema.memoryClusters.id, clusterId)); // Record activation history await tx.insert(schema.clusterActivationHistory).values({ clusterId, activationContext: context, activationStrength: 1.0 }); return true; }); // Return cluster with recent memories return await this.getClusterMemories(clusterId); } catch (error) { console.error('Error activating cluster:', error); throw error; } }
- src/tools/memory-tools.js:108-126 (schema)Input schema definition for the activate_cluster tool, defining parameters cluster_id (required) and optional context.{ name: "activate_cluster", description: "Activate a memory cluster and get its associated memories", inputSchema: { type: "object", properties: { cluster_id: { type: "string", description: "UUID of the cluster to activate" }, context: { type: "string", description: "Context description for this activation", default: null } }, required: ["cluster_id"] } },
- mcp.js:569-574 (registration)MCP server request handler registration for activate_cluster tool, dispatching to memoryManager.activateCluster and formatting response.case "activate_cluster": const clusterMemories = await memoryManager.activateCluster( args.cluster_id, args.context || null ); return { content: [{ type: "text", text: JSON.stringify(clusterMemories, null, 2) }] };
- mcp.js:135-152 (schema)Tool schema registration in MCP server's tools list (possibly duplicated or inline).name: "activate_cluster", description: "Activate a memory cluster and get its associated memories", inputSchema: { type: "object", properties: { cluster_id: { type: "string", description: "UUID of the cluster to activate" }, context: { type: "string", description: "Context description for this activation", default: null } }, required: ["cluster_id"] } },
- mcp.js:527-527 (handler)Overall MCP tool request handler switch statement that routes to specific tool implementations including activate_cluster.server.setRequestHandler(CallToolRequestSchema, async (request) => {