@mcp-rating/gateway 0.2.0

package/dist/meta-tools/health.js

@@ -0,0 +1,76 @@
+import { TRUST_LABELS } from "../permissions/trust-tiers.js";
+const GATEWAY_VERSION = "0.1.0";
+export function registerHealth(server, connectionManager, registryClient) {
+    server.tool("mcp_gateway_health", "Get gateway diagnostics: version, uptime, connection status, registry reachability, and per-server health.", {}, async () => {
+        const connections = connectionManager.listConnections();
+        const registryStatus = registryClient.getStatus();
+        const uptimeMs = Date.now() - connectionManager.startedAt.getTime();
+        const lines = [
+            `## MCP Gateway Health`,
+            "",
+            `**Version:** ${GATEWAY_VERSION}`,
+            `**Uptime:** ${formatDuration(uptimeMs)}`,
+            `**Connections:** ${connections.length}`,
+            "",
+        ];
+        // Registry status
+        lines.push("### Registry");
+        if (registryStatus.lastSuccessfulCall) {
+            const ago = formatDuration(Date.now() - registryStatus.lastSuccessfulCall.getTime());
+            lines.push(`**Status:** Reachable (last success ${ago} ago)`);
+        }
+        else if (registryStatus.lastError) {
+            lines.push(`**Status:** Unreachable`);
+            lines.push(`**Last Error:** ${registryStatus.lastError}`);
+        }
+        else {
+            lines.push(`**Status:** No calls made yet`);
+        }
+        lines.push(`**Cache Entries:** ${registryStatus.cacheSize}`, "");
+        // Per-connection details
+        if (connections.length > 0) {
+            lines.push("### Connections", "");
+            for (const conn of connections) {
+                const tierLabel = TRUST_LABELS[conn.trustTier];
+                const duration = formatDuration(Date.now() - conn.connectedAt.getTime());
+                const serverVer = conn.serverInfo
+                    ? `${conn.serverInfo.name} v${conn.serverInfo.version}`
+                    : "unknown";
+                lines.push(`**${conn.displayName}** (\`${conn.slug}\`)`);
+                lines.push(`  State: ${conn.state} · Trust: [${tierLabel}] · Tools: ${conn.toolCount}`);
+                lines.push(`  Server: ${serverVer} · Connected: ${duration}`);
+                if (conn.reconnectAttempts && conn.reconnectAttempts > 0) {
+                    lines.push(`  Reconnect attempts: ${conn.reconnectAttempts}`);
+                }
+                if (conn.failedPings && conn.failedPings > 0) {
+                    lines.push(`  Failed pings: ${conn.failedPings}`);
+                }
+                if (conn.lastPingAt) {
+                    const pingAgo = formatDuration(Date.now() - conn.lastPingAt.getTime());
+                    lines.push(`  Last ping: ${pingAgo} ago`);
+                }
+                lines.push("");
+            }
+        }
+        else {
+            lines.push("### Connections", "", "No servers connected.", "");
+        }
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    });
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ${seconds % 60}s`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ${minutes % 60}m`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ${hours % 24}h`;
+}
+//# sourceMappingURL=health.js.map

package/dist/meta-tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/meta-tools/health.ts"],"names":[],"mappings":"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"}

package/dist/meta-tools/index.d.ts

@@ -0,0 +1,28 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectionManager } from "../connection/connection-manager.js";
+import type { RegistryClient } from "../registry/registry-client.js";
+import type { AdTracker } from "../ads/ad-tracker.js";
+import type { UsageTracker } from "../analytics/usage-tracker.js";
+import type { AutoRecommender } from "../discovery/auto-recommender.js";
+import type { AuditLog } from "../audit/audit-log.js";
+export interface MetaToolOptions {
+    /** Ad tracker for ad-related meta-tool */
+    adTracker?: AdTracker | null;
+    /** Usage tracker for analytics meta-tool */
+    usageTracker?: UsageTracker | null;
+    /** Auto-recommender for recommendation meta-tool */
+    autoRecommender?: AutoRecommender | null;
+    /** Path to profiles file (for profiles meta-tool) */
+    profilesPath?: string;
+    /** Path to groups file (for groups meta-tool) */
+    groupsPath?: string;
+    /** Safety audit log (for the audit forensics meta-tool) */
+    auditLog?: AuditLog | null;
+}
+/**
+ * Register all gateway meta-tools on the MCP server.
+ *
+ * These are the tools users interact with to discover, connect,
+ * and manage downstream MCP servers.
+ */
+export declare function registerMetaTools(server: McpServer, connectionManager: ConnectionManager, registryClient: RegistryClient, options?: MetaToolOptions): void;

package/dist/meta-tools/index.js

@@ -0,0 +1,56 @@
+import { registerDiscover } from "./discover.js";
+import { registerConnect } from "./connect.js";
+import { registerDisconnect } from "./disconnect.js";
+import { registerListActive } from "./list-active.js";
+import { registerServerInfo } from "./server-info.js";
+import { registerCallTool } from "./call-tool.js";
+import { registerHealth } from "./health.js";
+import { registerAdStatus } from "./ad-status.js";
+import { registerProfiles } from "./profiles.js";
+import { registerGroups } from "./groups.js";
+import { registerUsage } from "./usage.js";
+import { registerRecommend } from "./recommend.js";
+import { registerSandbox } from "./sandbox.js";
+import { registerAudit } from "./audit.js";
+/**
+ * Register all gateway meta-tools on the MCP server.
+ *
+ * These are the tools users interact with to discover, connect,
+ * and manage downstream MCP servers.
+ */
+export function registerMetaTools(server, connectionManager, registryClient, options = {}) {
+    // Core meta-tools
+    registerDiscover(server, registryClient);
+    registerConnect(server, connectionManager);
+    registerDisconnect(server, connectionManager);
+    registerListActive(server, connectionManager);
+    registerServerInfo(server, connectionManager, registryClient);
+    registerCallTool(server, connectionManager);
+    registerHealth(server, connectionManager, registryClient);
+    registerSandbox(server, connectionManager);
+    // Safety audit forensics meta-tool
+    if (options.auditLog) {
+        registerAudit(server, options.auditLog);
+    }
+    // Ad tracking meta-tool (if partner key configured)
+    if (options.adTracker) {
+        registerAdStatus(server, connectionManager, options.adTracker);
+    }
+    // Profile management meta-tool
+    if (options.profilesPath) {
+        registerProfiles(server, connectionManager, options.profilesPath);
+    }
+    // Group management meta-tool
+    if (options.groupsPath) {
+        registerGroups(server, connectionManager, options.groupsPath);
+    }
+    // Usage analytics meta-tool
+    if (options.usageTracker) {
+        registerUsage(server, options.usageTracker);
+    }
+    // Auto-recommendation meta-tool
+    if (options.usageTracker && options.autoRecommender) {
+        registerRecommend(server, options.autoRecommender, options.usageTracker);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/meta-tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/meta-tools/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkB3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAiB,EACjB,iBAAoC,EACpC,cAA8B,EAC9B,UAA2B,EAAE;IAE7B,kBAAkB;IAClB,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAC9D,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAC1D,eAAe,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE3C,mCAAmC;IACnC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,4BAA4B;IAC5B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QACpD,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/meta-tools/list-active.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectionManager } from "../connection/connection-manager.js";
+export declare function registerListActive(server: McpServer, connectionManager: ConnectionManager): void;

package/dist/meta-tools/list-active.js

@@ -0,0 +1,50 @@
+import { TRUST_LABELS } from "../permissions/trust-tiers.js";
+export function registerListActive(server, connectionManager) {
+    server.tool("mcp_list_active", "List all currently connected MCP servers and their tools.", {}, async () => {
+        const connections = connectionManager.listConnections();
+        if (connections.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No MCP servers are currently connected.\n\nUse `mcp_discover` to find servers, then `mcp_connect` to connect.",
+                    },
+                ],
+            };
+        }
+        const lines = [
+            `## Active MCP Connections (${connections.length})`,
+            "",
+        ];
+        for (const conn of connections) {
+            const tierLabel = TRUST_LABELS[conn.trustTier];
+            const duration = formatDuration(Date.now() - conn.connectedAt.getTime());
+            const serverVer = conn.serverInfo
+                ? `${conn.serverInfo.name} v${conn.serverInfo.version}`
+                : "unknown";
+            lines.push(`### ${conn.displayName}`, `**Slug:** \`${conn.slug}\` · **Trust:** [${tierLabel}] · **State:** ${conn.state}`, `**Server:** ${serverVer} · **Tools:** ${conn.toolCount} · **Connected:** ${duration}`);
+            if (conn.state === "reconnecting" && conn.reconnectAttempts) {
+                lines.push(`⚠️ Reconnecting (attempt ${conn.reconnectAttempts})...`);
+            }
+            if (conn.state === "failed") {
+                lines.push(`❌ Connection failed — use \`mcp_connect\` to retry manually.`);
+            }
+            lines.push("");
+        }
+        lines.push("---", `Use \`mcp_disconnect({slug: "..."})\` to disconnect a server.`);
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    });
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ${seconds % 60}s`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h ${minutes % 60}m`;
+}
+//# sourceMappingURL=list-active.js.map

package/dist/meta-tools/list-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-active.js","sourceRoot":"","sources":["../../src/meta-tools/list-active.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,iBAAoC;IAEpC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2DAA2D,EAC3D,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,WAAW,GAAG,iBAAiB,CAAC,eAAe,EAAE,CAAC;QAExD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,+GAA+G;qBACtH;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAa;YACtB,8BAA8B,WAAW,CAAC,MAAM,GAAG;YACnD,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,cAAc,CAC7B,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CACxC,CAAC;YACF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU;gBAC/B,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;gBACvD,CAAC,CAAC,SAAS,CAAC;YAEd,KAAK,CAAC,IAAI,CACR,OAAO,IAAI,CAAC,WAAW,EAAE,EACzB,eAAe,IAAI,CAAC,IAAI,oBAAoB,SAAS,kBAAkB,IAAI,CAAC,KAAK,EAAE,EACnF,eAAe,SAAS,iBAAiB,IAAI,CAAC,SAAS,qBAAqB,QAAQ,EAAE,CACvF,CAAC;YACF,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,iBAAiB,MAAM,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;YAC7E,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CACR,KAAK,EACL,+DAA+D,CAChE,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC7D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;AACtC,CAAC"}

package/dist/meta-tools/profiles.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectionManager } from "../connection/connection-manager.js";
+/**
+ * Register the `mcp_profiles` meta-tool for managing named connection profiles.
+ */
+export declare function registerProfiles(server: McpServer, connectionManager: ConnectionManager, profilesPath: string): void;

package/dist/meta-tools/profiles.js

@@ -0,0 +1,197 @@
+import { z } from "zod";
+import { listNamedProfiles, createNamedProfile, deleteNamedProfile, addToNamedProfile, removeFromNamedProfile, getActiveProfileName, setActiveProfile, getProfileConnections, } from "../config/profiles.js";
+import { toolError } from "../utils/errors.js";
+/**
+ * Register the `mcp_profiles` meta-tool for managing named connection profiles.
+ */
+export function registerProfiles(server, connectionManager, profilesPath) {
+    server.tool("mcp_profiles", "Manage named connection profiles. Profiles are presets of server connections that can be switched between (e.g., 'work', 'personal').", {
+        action: z
+            .enum(["list", "create", "delete", "add_server", "remove_server", "switch", "show"])
+            .describe("Action: list (all profiles), create (new profile), delete, add_server (add a server to profile), remove_server, switch (activate profile), show (details of a profile)"),
+        name: z
+            .string()
+            .optional()
+            .describe("Profile name (required for create, delete, add_server, remove_server, switch, show)"),
+        description: z
+            .string()
+            .optional()
+            .describe("Profile description (optional, for create)"),
+        slug: z
+            .string()
+            .optional()
+            .describe("Server slug to add/remove from a profile"),
+        command: z
+            .string()
+            .optional()
+            .describe("Explicit command for the server (for add_server with stdio)"),
+        args: z
+            .array(z.string())
+            .optional()
+            .describe("Command arguments (for add_server with stdio)"),
+        url: z
+            .string()
+            .optional()
+            .describe("Server URL (for add_server with SSE/WS/HTTP)"),
+        transportType: z
+            .enum(["stdio", "sse", "websocket", "streamable-http"])
+            .optional()
+            .describe("Transport type (for add_server)"),
+    }, async ({ action, name, description, slug, command, args, url, transportType }) => {
+        try {
+            switch (action) {
+                case "list": {
+                    const profiles = listNamedProfiles(profilesPath);
+                    const active = getActiveProfileName(profilesPath);
+                    if (profiles.length === 0) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "No named profiles exist yet.\n\nUse `mcp_profiles({action: \"create\", name: \"work\"})` to create one.",
+                                },
+                            ],
+                        };
+                    }
+                    const lines = [
+                        `## Connection Profiles (${profiles.length})`,
+                        "",
+                    ];
+                    for (const p of profiles) {
+                        const isActive = p.name === active ? " ⭐ **active**" : "";
+                        lines.push(`### ${p.name}${isActive}`, p.description ? `_${p.description}_` : "", `**Servers:** ${p.connections.length}`, "");
+                    }
+                    return {
+                        content: [{ type: "text", text: lines.filter(Boolean).join("\n") }],
+                    };
+                }
+                case "create": {
+                    if (!name)
+                        return toolError("Profile name is required for 'create'.");
+                    createNamedProfile(profilesPath, name, description);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Profile **"${name}"** created.${description ? ` (${description})` : ""}\n\nAdd servers with \`mcp_profiles({action: "add_server", name: "${name}", slug: "..."})\``,
+                            },
+                        ],
+                    };
+                }
+                case "delete": {
+                    if (!name)
+                        return toolError("Profile name is required for 'delete'.");
+                    const deleted = deleteNamedProfile(profilesPath, name);
+                    if (!deleted)
+                        return toolError(`Profile "${name}" not found.`);
+                    return {
+                        content: [
+                            { type: "text", text: `✅ Profile **"${name}"** deleted.` },
+                        ],
+                    };
+                }
+                case "add_server": {
+                    if (!name)
+                        return toolError("Profile name is required for 'add_server'.");
+                    if (!slug && !command && !url) {
+                        return toolError("Either 'slug', 'command', or 'url' is required to add a server.");
+                    }
+                    addToNamedProfile(profilesPath, name, {
+                        slug,
+                        command,
+                        args,
+                        url,
+                        transportType: transportType,
+                        confirmed: true,
+                    });
+                    const identifier = slug || command || url;
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Server **${identifier}** added to profile **"${name}"**.`,
+                            },
+                        ],
+                    };
+                }
+                case "remove_server": {
+                    if (!name)
+                        return toolError("Profile name is required for 'remove_server'.");
+                    if (!slug)
+                        return toolError("Server slug is required to remove a server.");
+                    removeFromNamedProfile(profilesPath, name, slug);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `✅ Server **${slug}** removed from profile **"${name}"**.`,
+                            },
+                        ],
+                    };
+                }
+                case "switch": {
+                    if (!name)
+                        return toolError("Profile name is required for 'switch'.");
+                    // Disconnect all current connections
+                    await connectionManager.disconnectAll();
+                    // Set the active profile
+                    setActiveProfile(profilesPath, name);
+                    // Connect all servers in the profile
+                    const connections = getProfileConnections(profilesPath, name);
+                    const results = [];
+                    for (const profile of connections) {
+                        try {
+                            await connectionManager.connect({ ...profile, confirmed: true });
+                            results.push(`✅ ${profile.slug || profile.command || profile.url}`);
+                        }
+                        catch (err) {
+                            results.push(`❌ ${profile.slug || profile.command || profile.url}: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                    }
+                    const lines = [
+                        `## Switched to profile **"${name}"**`,
+                        "",
+                        `**Servers:** ${connections.length}`,
+                        "",
+                        ...results,
+                        "",
+                        `**Active connections:** ${connectionManager.connectionCount}`,
+                    ];
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                    };
+                }
+                case "show": {
+                    if (!name)
+                        return toolError("Profile name is required for 'show'.");
+                    const conns = getProfileConnections(profilesPath, name);
+                    const active = getActiveProfileName(profilesPath);
+                    const isActive = name === active;
+                    const lines = [
+                        `## Profile: ${name}${isActive ? " ⭐ active" : ""}`,
+                        "",
+                        `**Servers:** ${conns.length}`,
+                        "",
+                    ];
+                    for (const c of conns) {
+                        const transport = c.transportType || "stdio";
+                        const target = c.slug || c.command || c.url || "unknown";
+                        lines.push(`- \`${target}\` (${transport})`);
+                    }
+                    if (conns.length === 0) {
+                        lines.push("_No servers in this profile yet._");
+                    }
+                    return {
+                        content: [{ type: "text", text: lines.join("\n") }],
+                    };
+                }
+                default:
+                    return toolError(`Unknown action: ${action}`);
+            }
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=profiles.js.map

package/dist/meta-tools/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/meta-tools/profiles.ts"],"names":[],"mappings":"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"}

package/dist/meta-tools/recommend.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AutoRecommender } from "../discovery/auto-recommender.js";
+import type { UsageTracker } from "../analytics/usage-tracker.js";
+/**
+ * Register the `mcp_recommend` meta-tool.
+ *
+ * Two modes:
+ *  - **Intent mode** (`query` provided): searches the registry for servers
+ *    matching the goal, with server-side intent expansion (cloud storage →
+ *    dropbox/gdrive/onedrive/...).
+ *  - **Usage mode** (no `query`): analyzes recent tool-call patterns and
+ *    suggests servers that complement the workflow.
+ */
+export declare function registerRecommend(server: McpServer, autoRecommender: AutoRecommender, usageTracker: UsageTracker): void;

package/dist/meta-tools/recommend.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { toolError } from "../utils/errors.js";
+/**
+ * Register the `mcp_recommend` meta-tool.
+ *
+ * Two modes:
+ *  - **Intent mode** (`query` provided): searches the registry for servers
+ *    matching the goal, with server-side intent expansion (cloud storage →
+ *    dropbox/gdrive/onedrive/...).
+ *  - **Usage mode** (no `query`): analyzes recent tool-call patterns and
+ *    suggests servers that complement the workflow.
+ */
+export function registerRecommend(server, autoRecommender, usageTracker) {
+    server.tool("mcp_recommend", "Get MCP server recommendations. Pass `query` to describe a goal or task (e.g. \"file sync with cloud storage\", \"manage GitHub issues\"). Omit `query` to get suggestions based on your recent tool-call patterns.", {
+        query: z
+            .string()
+            .optional()
+            .describe("Free-text goal or task. When provided, recommends servers that match this intent using semantic/keyword/expansion search. When omitted, recommends based on usage history."),
+        category: z
+            .string()
+            .optional()
+            .describe("Optional category slug to filter (e.g. 'developer-tools', 'data-databases'). Only used with `query`."),
+        limit: z
+            .number()
+            .min(1)
+            .max(20)
+            .optional()
+            .describe("Maximum number of recommendations (default 5, max 20)"),
+    }, async ({ query, category, limit = 5 }) => {
+        try {
+            const isIntentMode = typeof query === "string" && query.trim().length > 0;
+            const recommendations = isIntentMode
+                ? await autoRecommender.recommendByQuery(query.trim(), {
+                    limit,
+                    category,
+                })
+                : await autoRecommender.recommend(usageTracker.getRecentCalls(50), usageTracker);
+            const limited = recommendations.slice(0, limit);
+            if (limited.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: isIntentMode
+                                ? `No MCP servers found for "${query}". Try a broader description, or use \`mcp_discover\` to search by keyword.`
+                                : "No recommendations available right now. Use more tools to build usage patterns, pass a `query` to describe a goal, or try `mcp_discover` to search the registry directly.",
+                        },
+                    ],
+                };
+            }
+            const header = isIntentMode
+                ? `## Recommended for "${query}" (${limited.length})`
+                : `## Recommended Servers (${limited.length})`;
+            const subHeader = isIntentMode
+                ? `_Best matches in the registry for your goal:_`
+                : `_Based on your recent tool usage patterns:_`;
+            const lines = [header, "", subHeader, ""];
+            for (const rec of limited) {
+                // qualityScore is 0-100 from the registry; display as /100.
+                const quality = rec.qualityScore > 0
+                    ? ` · Quality: ${rec.qualityScore.toFixed(0)}/100`
+                    : "";
+                lines.push(`### ${rec.name}`, `**Slug:** \`${rec.slug}\`${quality}`, `**Why:** ${rec.reason}`, `→ Connect: \`mcp_connect({slug: "${rec.slug}"})\``, "");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    });
+}
+//# sourceMappingURL=recommend.js.map

package/dist/meta-tools/recommend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommend.js","sourceRoot":"","sources":["../../src/meta-tools/recommend.ts"],"names":[],"mappings":"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"}

package/dist/meta-tools/sandbox.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConnectionManager } from "../connection/connection-manager.js";
+/**
+ * Register the `mcp_sandbox` meta-tool — view and customize per-server
+ * capability manifests (the sandbox security contract).
+ *
+ *  - view:  show the effective/saved manifest + a human-readable summary
+ *  - set:   override fields (network, env, filesystem, subprocess, enforcement)
+ *           — takes effect on the next connection to that server
+ *  - reset: clear the override, reverting to trust-tier defaults
+ */
+export declare function registerSandbox(server: McpServer, connectionManager: ConnectionManager): void;