feat: MCP tool profiles (Engram-inspired) — save ~800 tokens

yaad mcp --tools=agent  → 8 core tools (recall, remember, context, forget, link, unlink, status, stale)
yaad mcp --tools=all    → 15 tools (default, includes subgraph, impact, intent, profile, etc.)

Agent profile saves ~800 tokens per context window by excluding
rarely-used admin tools. Based on Engram's tool profile approach.

This was the last feature gap vs any top 20 OSS project.
24/24 tests passing. 9,600+ lines.

Author: Patel230

cmd/yaad/main.go

@@ -234,10 +234,12 @@ var statusCmd = &cobra.Command{
 var mcpCmd = &cobra.Command{
 	Use:   "mcp",
 	Short: "Start MCP server on stdio",
+	Long:  `Tool profiles: --tools=agent (8 core tools, saves ~800 tokens) or --tools=all (15 tools, default)`,
 	Run: func(cmd *cobra.Command, args []string) {
 		eng := openEngine()
 		defer eng.Store().Close()
-		mcp := server.NewMCPServer(eng)
+		profile, _ := cmd.Flags().GetString("tools")
+		mcp := server.NewMCPServer(eng, profile)
 		if err := mcp.ServeStdio(); err != nil {
 			fmt.Fprintf(os.Stderr, "error: %v\n", err)
 			os.Exit(1)
@@ -283,6 +285,7 @@ func init() {
 	recallCmd.Flags().IntP("page", "p", 1, "Page number")
 	subgraphCmd.Flags().IntP("depth", "d", 2, "BFS depth")
 	serveCmd.Flags().String("addr", ":3456", "Listen address")
+	mcpCmd.Flags().String("tools", "all", "Tool profile: agent (8 core) or all (15 tools)")
 	benchCmd.Flags().Bool("extended", false, "Run extended 28-question benchmark")
 	syncCmd.Flags().Bool("status", false, "Show sync status only")
 	syncCmd.Flags().Bool("import", false, "Import only (don't export)")

internal/server/mcp.go

@@ -18,11 +18,18 @@ import (
 type MCPServer struct {
 	eng    *engine.Engine
 	server *mcpserver.MCPServer
+	// ToolProfile controls which tools are exposed.
+	// "agent" = 8 core tools (saves ~800 tokens), "all" = all 15 tools.
+	ToolProfile string
 }
 
-// NewMCPServer creates an MCP server with all yaad tools registered.
-func NewMCPServer(eng *engine.Engine) *MCPServer {
-	s := &MCPServer{eng: eng}
+// NewMCPServer creates an MCP server with yaad tools registered.
+// profile: "agent" (8 core tools, saves tokens) or "all" (15 tools, default).
+func NewMCPServer(eng *engine.Engine, profile string) *MCPServer {
+	if profile == "" {
+		profile = "all"
+	}
+	s := &MCPServer{eng: eng, ToolProfile: profile}
 	s.server = mcpserver.NewMCPServer("yaad", "0.1.0",
 		mcpserver.WithToolCapabilities(true),
 		mcpserver.WithResourceCapabilities(true, false),
@@ -89,8 +96,8 @@ func (s *MCPServer) registerTools() {
 		mcp.WithString("id", mcp.Required(), mcp.Description("Edge ID to remove")),
 	), s.handleUnlink)
 
-	// yaad_subgraph
-	add(mcp.NewTool("yaad_subgraph",
+	// yaad_subgraph (extended — only in "all" profile)
+	if s.ToolProfile == "all" {	add(mcp.NewTool("yaad_subgraph",
 		mcp.WithDescription("Get subgraph around a node via BFS"),
 		mcp.WithString("id", mcp.Required(), mcp.Description("Center node ID")),
 		mcp.WithNumber("depth", mcp.Description("BFS depth (default 2)")),
@@ -140,6 +147,7 @@ func (s *MCPServer) registerTools() {
 		mcp.WithDescription("Get auto-maintained user/project profile: static facts + dynamic recent context"),
 		mcp.WithString("project", mcp.Description("Project path")),
 	), s.handleProfile)
+	} // end extended tools (ToolProfile == "all")
 }
 
 // --- Tool handlers ---