fullcourtdefense-cli 1.14.12 → 1.14.14

package/dist/commands/discover.d.ts

@@ -12,6 +12,10 @@ export interface DiscoverArgs {
     agentCiGate?: AgentCiGateUpload;
     extraPath?: string;
     deep?: string;
+    /** Optional comma-separated dev roots (or "auto") to sweep for project MCP configs in OTHER repos. */
+    scanRoot?: string;
+    /** Allow deep stdio probing (process spawn) for servers found via --scan-root. Default: off. */
+    deepRoots?: string;
     silent?: string;
     userEmail?: string;
     schedule?: string;

package/dist/commands/discover.js

@@ -482,10 +482,18 @@ async function probeHttpMcpTools(url, timeoutMs = 8000) {
     }
     return [];
 }
-async function enrichWithDeepProbe(servers, silent) {
+async function enrichWithDeepProbe(servers, silent, options = {}) {
     for (const server of servers) {
         if (server.transport !== 'http' && server.transport !== 'sse') {
             if (server.transport === 'stdio' && server.command) {
+                // Safety: never auto-spawn stdio server processes discovered in OTHER
+                // projects via --scan-root; inventory them without live tools unless
+                // the user opts in with --deep-roots. (HTTP probing below is fine —
+                // it's a network call, not a process spawn.)
+                if (options.skipStdioForConfigPaths?.has(path.resolve(server.configPath).toLowerCase())) {
+                    server.warnings.push('Deep stdio probe skipped for config outside the current project (--scan-root). Pass --deep-roots true to probe these too.');
+                    continue;
+                }
                 const downstream = (0, discoverProxy_1.isFcdGatewayServer)(server) ? (0, discoverProxy_1.extractGatewayDownstream)(server) : null;
                 const command = downstream?.command || server.command;
                 const args = downstream?.args || server.args || [];
@@ -769,8 +777,30 @@ async function discoverCommand(args, config) {
     const scanned = [];
     let found = [];
     let clientCoverage = [];
+    const scanRootConfigPaths = new Set();
     if (runMcp) {
         const candidates = candidateConfigPaths(cwd, args.extraPath);
+        // Optional --scan-root sweep: find project-scoped MCP configs in OTHER repos
+        // under the given dev roots (bounded walk — see scanRootsForProjectConfigs).
+        // Without the flag, behavior is exactly the known-locations scan.
+        const scanRoots = (0, discoverPaths_1.resolveScanRoots)(args.scanRoot);
+        if (scanRoots.length > 0) {
+            const sweep = (0, discoverPaths_1.scanRootsForProjectConfigs)(scanRoots);
+            const known = new Set(candidates.map(c => path.resolve(c.path).toLowerCase()));
+            let added = 0;
+            for (const candidate of sweep.candidates) {
+                const key = path.resolve(candidate.path).toLowerCase();
+                if (known.has(key))
+                    continue;
+                known.add(key);
+                candidates.push(candidate);
+                scanRootConfigPaths.add(key);
+                added += 1;
+            }
+            if (!silent) {
+                console.log(`${COLOR.gray}Scan-root sweep: checked ${sweep.scannedDirs} folder(s) under ${scanRoots.length} root(s) — found ${added} additional project config(s).${COLOR.reset}`);
+            }
+        }
         // Self-heal BEFORE parsing: configs written by old CLI versions can carry a stale
         // generic `--agent-name` that breaks dashboard policy matching. Fix them in place so
         // every discovery run converges the fleet to the per-server identity contract.
@@ -793,7 +823,9 @@ async function discoverCommand(args, config) {
         if (deep && found.length > 0) {
             if (!silent)
                 console.log(`${COLOR.gray}Running deep probe (HTTP/SSE/stdio tools/list)…${COLOR.reset}`);
-            await enrichWithDeepProbe(found, silent);
+            await enrichWithDeepProbe(found, silent, {
+                skipStdioForConfigPaths: args.deepRoots === 'true' ? undefined : scanRootConfigPaths,
+            });
         }
     }
     const secrets = surfaces.has('secrets') || surfaces.has('posture')

package/dist/commands/discoverPaths.d.ts

@@ -14,5 +14,22 @@ export declare function claudeDesktopLikelyInstalled(): boolean;
 export declare function claudeDesktopInstallTargets(configPath?: string): ClaudeDesktopConfigCandidate[];
 /** All MCP client config locations discover / install should check. */
 export declare function candidateConfigPaths(cwd: string, extra?: string): ConfigPathCandidate[];
+/** Common places developers keep code, used by `--scan-root auto`. */
+export declare function defaultScanRoots(): string[];
+/**
+ * Bounded walk of developer folders looking for project-scoped MCP configs
+ * (`--scan-root`). Depth- and volume-capped so it stays fast and predictable —
+ * this is a repo-root sweep, not a disk scan. Hidden/dependency/build folders
+ * are pruned; only the known project config filenames are checked.
+ */
+export declare function scanRootsForProjectConfigs(roots: string[], options?: {
+    maxDepth?: number;
+    maxDirs?: number;
+}): {
+    candidates: ConfigPathCandidate[];
+    scannedDirs: number;
+};
+/** Resolve the --scan-root flag: comma-separated paths, or "auto" for common dev folders. */
+export declare function resolveScanRoots(flag: string | undefined): string[];
 /** Include config paths for apps that exist on disk even when the MCP file is not created yet. */
 export declare function discoverScanTargets(cwd: string, extra?: string): ConfigPathCandidate[];

package/dist/commands/discoverPaths.js

@@ -38,6 +38,9 @@ exports.claudeDesktopConfigCandidates = claudeDesktopConfigCandidates;
 exports.claudeDesktopLikelyInstalled = claudeDesktopLikelyInstalled;
 exports.claudeDesktopInstallTargets = claudeDesktopInstallTargets;
 exports.candidateConfigPaths = candidateConfigPaths;
+exports.defaultScanRoots = defaultScanRoots;
+exports.scanRootsForProjectConfigs = scanRootsForProjectConfigs;
+exports.resolveScanRoots = resolveScanRoots;
 exports.discoverScanTargets = discoverScanTargets;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
@@ -176,6 +179,122 @@ function candidateConfigPaths(cwd, extra) {
         return true;
     });
 }
+/** Project-scoped MCP config files that can sit at any repo root. */
+const PROJECT_CONFIG_FILES = [
+    { rel: path.join('.cursor', 'mcp.json'), source: 'Cursor (project)', clientKey: 'cursor' },
+    { rel: '.mcp.json', source: 'Claude Code (.mcp.json project)', clientKey: 'claude_code' },
+    { rel: path.join('.claude', 'settings.json'), source: 'Claude Code (project)', clientKey: 'claude_code' },
+    { rel: path.join('.vscode', 'mcp.json'), source: 'VS Code (project)', clientKey: 'vscode' },
+    { rel: path.join('.codex', 'config.toml'), source: 'Codex (project)', clientKey: 'codex' },
+    { rel: path.join('.gemini', 'settings.json'), source: 'Gemini CLI (project)', clientKey: 'gemini_cli' },
+    { rel: 'mcp.json', source: 'Repo (mcp.json)', clientKey: 'other' },
+];
+/** Dependency/build/VCS folders that never contain project MCP configs. */
+const SCAN_SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'build', 'out', 'vendor', 'venv', 'env', '__pycache__',
+    'target', 'coverage', 'tmp', 'temp', 'obj', 'bin', 'packages', 'bower_components',
+    'site-packages', 'deps', '.terraform',
+]);
+/** Common places developers keep code, used by `--scan-root auto`. */
+function defaultScanRoots() {
+    const home = os.homedir();
+    const roots = [
+        path.join(home, 'repos'),
+        path.join(home, 'projects'),
+        path.join(home, 'code'),
+        path.join(home, 'dev'),
+        path.join(home, 'src'),
+        path.join(home, 'work'),
+        path.join(home, 'Documents', 'GitHub'),
+        path.join(home, 'Documents', 'repos'),
+        path.join(home, 'Documents', 'projects'),
+    ];
+    if (process.platform === 'win32') {
+        const drive = (process.env.SystemDrive || 'C:') + path.sep;
+        for (const name of ['dev', 'src', 'repos', 'code', 'projects', 'work', 'git']) {
+            roots.push(path.join(drive, name));
+        }
+    }
+    return roots.filter(root => {
+        try {
+            return fs.statSync(root).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Bounded walk of developer folders looking for project-scoped MCP configs
+ * (`--scan-root`). Depth- and volume-capped so it stays fast and predictable —
+ * this is a repo-root sweep, not a disk scan. Hidden/dependency/build folders
+ * are pruned; only the known project config filenames are checked.
+ */
+function scanRootsForProjectConfigs(roots, options = {}) {
+    const maxDepth = options.maxDepth ?? 4;
+    const maxDirs = options.maxDirs ?? 25000;
+    const candidates = [];
+    const visited = new Set();
+    let scannedDirs = 0;
+    const queue = [];
+    for (const root of roots) {
+        try {
+            const resolved = path.resolve(root);
+            if (fs.statSync(resolved).isDirectory())
+                queue.push({ dir: resolved, depth: 0 });
+        }
+        catch { /* missing root — skip */ }
+    }
+    while (queue.length > 0 && scannedDirs < maxDirs) {
+        const { dir, depth } = queue.shift();
+        const key = dir.toLowerCase();
+        if (visited.has(key))
+            continue;
+        visited.add(key);
+        scannedDirs += 1;
+        for (const config of PROJECT_CONFIG_FILES) {
+            const file = path.join(dir, config.rel);
+            try {
+                if (fs.existsSync(file) && fs.statSync(file).isFile()) {
+                    candidates.push({ path: file, source: config.source, clientKey: config.clientKey });
+                }
+            }
+            catch { /* unreadable — skip */ }
+        }
+        if (depth >= maxDepth)
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue; // permission denied etc.
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const name = entry.name;
+            if (name.startsWith('.') || SCAN_SKIP_DIRS.has(name.toLowerCase()))
+                continue;
+            queue.push({ dir: path.join(dir, name), depth: depth + 1 });
+        }
+    }
+    return { candidates, scannedDirs };
+}
+/** Resolve the --scan-root flag: comma-separated paths, or "auto" for common dev folders. */
+function resolveScanRoots(flag) {
+    if (!flag?.trim())
+        return [];
+    const parts = flag.split(',').map(part => part.trim()).filter(Boolean);
+    const roots = [];
+    for (const part of parts) {
+        if (part.toLowerCase() === 'auto')
+            roots.push(...defaultScanRoots());
+        else
+            roots.push(path.resolve(part));
+    }
+    return [...new Set(roots.map(root => root))];
+}
 /** Include config paths for apps that exist on disk even when the MCP file is not created yet. */
 function discoverScanTargets(cwd, extra) {
     const candidates = candidateConfigPaths(cwd, extra);

package/dist/commands/discoverProxy.d.ts

@@ -25,6 +25,7 @@ export declare function isFcdGatewayServer(server: ProxyClassifiableServer): boo
 export declare function extractGatewayDownstream(server: ProxyClassifiableServer): {
     command?: string;
     args?: string[];
+    url?: string;
     label?: string;
 } | null;
 /** Per-client downstream targets wrapped by FCD gateway entries in the same config file. */

package/dist/commands/discoverProxy.js

@@ -64,6 +64,16 @@ function isFcdGatewayServer(server) {
 }
 function extractGatewayDownstream(server) {
     const args = server.args || [];
+    const urlIdx = args.indexOf('--mcp-url');
+    if (urlIdx >= 0 && args[urlIdx + 1]) {
+        const url = args[urlIdx + 1];
+        let label;
+        try {
+            label = new URL(url).hostname;
+        }
+        catch { /* leave undefined */ }
+        return { url, label };
+    }
     const cmdIdx = args.indexOf('--mcp-command');
     if (cmdIdx < 0 || !args[cmdIdx + 1])
         return null;
@@ -138,6 +148,8 @@ function buildGatewayWrapIndex(servers) {
                 wrapped.add(downstream.label.toLowerCase());
             if (downstream?.command)
                 wrapped.add(downstreamFingerprint(downstream.command, downstream.args));
+            if (downstream?.url)
+                wrapped.add(downstream.url.toLowerCase());
             wrapped.add(server.serverName.toLowerCase());
         }
         wrapsByConfig.set(configPath, wrapped);

package/dist/commands/mcpGateway.d.ts

@@ -5,6 +5,10 @@ export declare const ALL_GATEWAY_CLIENTS: GatewayClient[];
 export interface McpGatewayArgs {
     mcpCommand?: string;
     mcpArgs?: string;
+    /** Remote MCP server URL (Streamable HTTP / SSE) — alternative to --mcp-command. */
+    mcpUrl?: string;
+    /** Optional JSON object of extra HTTP headers for the remote MCP (e.g. auth). */
+    mcpHeaders?: string;
     agentName?: string;
     agentClient?: string;
     developerName?: string;
@@ -55,6 +59,20 @@ export interface InstallMcpGatewayArgs extends McpGatewayArgs {
     upload?: string;
     apiKey?: string;
 }
+/**
+ * How the gateway reaches the real MCP server: spawn a local process (stdio)
+ * or speak Streamable HTTP/SSE to a remote URL. Both flow through the exact
+ * same policy enforcement in McpGatewayServer.
+ */
+export type DownstreamSpec = {
+    kind: 'stdio';
+    command: string;
+    args: string[];
+} | {
+    kind: 'http';
+    url: string;
+    headers?: Record<string, string>;
+};
 export declare function mcpGatewayCommand(args: McpGatewayArgs, config: BotGuardConfig): Promise<void>;
 export declare function installCursorMcpGatewayCommand(args: InstallCursorMcpGatewayArgs, config: BotGuardConfig): Promise<void>;
 export declare function installMcpGatewayCommand(args: InstallMcpGatewayArgs, config: BotGuardConfig): Promise<void>;

package/dist/commands/mcpGateway.js

@@ -79,6 +79,18 @@ const CLIENT_LABELS = {
     windsurf: 'Windsurf',
     vscode: 'VS Code',
 };
+function parseHeadersFlag(value) {
+    if (!value?.trim())
+        return undefined;
+    try {
+        const parsed = JSON.parse(value);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return Object.fromEntries(Object.entries(parsed).map(([k, v]) => [k, String(v)]));
+        }
+    }
+    catch { /* fall through */ }
+    throw new Error('--mcp-headers must be a JSON object, e.g. {"Authorization":"Bearer ..."}');
+}
 function parseArgsList(value) {
     if (!value?.trim())
         return [];
@@ -399,6 +411,127 @@ class StdioMcpClient {
         this.pending.clear();
     }
 }
+/**
+ * Downstream client for remote HTTP/SSE MCP servers (MCP Streamable HTTP
+ * transport). JSON-RPC messages are POSTed to the server; responses may come
+ * back as plain JSON or as a text/event-stream body. Session continuity uses
+ * the Mcp-Session-Id header. Endpoint variants (base, /mcp, stripped /sse)
+ * are tried on initialize — the first one that answers wins.
+ */
+class HttpMcpClient {
+    url;
+    extraHeaders;
+    endpoint;
+    sessionId;
+    nextId = 1;
+    constructor(url, extraHeaders = {}) {
+        this.url = url;
+        this.extraHeaders = extraHeaders;
+        if (!url)
+            throw new Error('Missing downstream MCP URL. Pass --mcp-url.');
+    }
+    async initialize() {
+        const normalized = this.url.replace(/\/$/, '');
+        const candidates = [...new Set([
+                normalized,
+                normalized.replace(/\/sse(\?.*)?$/i, ''),
+                `${normalized}/mcp`,
+                normalized.replace(/\/sse(\?.*)?$/i, '/mcp'),
+            ])].filter(Boolean);
+        let lastError;
+        for (const endpoint of candidates) {
+            try {
+                const init = await this.post(endpoint, 'initialize', {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'agentguard-mcp-gateway', version: '0.1.0' },
+                }, 15000);
+                if (init?.error) {
+                    lastError = new Error(init.error.message || `MCP initialize failed at ${endpoint}`);
+                    continue;
+                }
+                this.endpoint = endpoint;
+                await this.post(endpoint, 'notifications/initialized', {}, 15000, true).catch(() => undefined);
+                return;
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+            }
+        }
+        throw lastError || new Error(`Could not initialize remote MCP server at ${this.url}`);
+    }
+    async listTools() {
+        const response = await this.request('tools/list', {});
+        const tools = response?.tools;
+        if (!Array.isArray(tools))
+            return [];
+        return tools
+            .filter(tool => typeof tool.name === 'string')
+            .map(tool => ({
+            name: String(tool.name),
+            description: typeof tool.description === 'string'
+                ? String(tool.description)
+                : undefined,
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    async callTool(name, args) {
+        return this.request('tools/call', { name, arguments: args });
+    }
+    close() {
+        // Stateless HTTP transport — nothing to tear down.
+    }
+    async request(method, params) {
+        if (!this.endpoint)
+            throw new Error('Remote MCP client not initialized.');
+        const message = await this.post(this.endpoint, method, params, 60000);
+        if (message?.error)
+            throw new Error(message.error.message || `MCP request failed: ${method}`);
+        return message?.result;
+    }
+    async post(endpoint, method, params, timeoutMs, isNotification = false) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json, text/event-stream',
+            ...this.extraHeaders,
+        };
+        if (this.sessionId)
+            headers['Mcp-Session-Id'] = this.sessionId;
+        const body = { jsonrpc: '2.0', method, params };
+        if (!isNotification)
+            body.id = this.nextId++;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const resp = await fetch(endpoint, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            const nextSession = resp.headers.get('mcp-session-id');
+            if (nextSession)
+                this.sessionId = nextSession;
+            if (isNotification)
+                return null;
+            if (!resp.ok && resp.status !== 202) {
+                throw new Error(`Remote MCP server returned HTTP ${resp.status} for ${method}`);
+            }
+            const contentType = resp.headers.get('content-type') || '';
+            if (contentType.includes('text/event-stream')) {
+                const text = await resp.text();
+                const dataLine = text.split('\n').find(line => line.startsWith('data: '));
+                if (!dataLine)
+                    throw new Error(`Remote MCP server sent an empty event stream for ${method}`);
+                return JSON.parse(dataLine.slice(6));
+            }
+            return await resp.json();
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
 class AgentGuardApi {
     config;
     constructor(config) {
@@ -515,16 +648,14 @@ class AgentGuardApi {
 }
 class McpGatewayServer {
     gatewayConfig;
-    downstreamCommand;
-    downstreamArgs;
+    downstreamSpec;
     downstream;
     downstreamReady;
     buffer = '';
     api;
-    constructor(gatewayConfig, downstreamCommand, downstreamArgs) {
+    constructor(gatewayConfig, downstreamSpec) {
         this.gatewayConfig = gatewayConfig;
-        this.downstreamCommand = downstreamCommand;
-        this.downstreamArgs = downstreamArgs;
+        this.downstreamSpec = downstreamSpec;
         this.api = new AgentGuardApi(gatewayConfig);
     }
     start() {
@@ -581,7 +712,9 @@ class McpGatewayServer {
     }
     async ensureDownstream() {
         if (!this.downstreamReady) {
-            this.downstream = new StdioMcpClient(this.downstreamCommand, this.downstreamArgs);
+            this.downstream = this.downstreamSpec.kind === 'http'
+                ? new HttpMcpClient(this.downstreamSpec.url, this.downstreamSpec.headers)
+                : new StdioMcpClient(this.downstreamSpec.command, this.downstreamSpec.args);
             this.downstreamReady = this.downstream.initialize();
         }
         await this.downstreamReady;
@@ -722,10 +855,17 @@ class McpGatewayServer {
 }
 async function mcpGatewayCommand(args, config) {
     const gatewayConfig = resolveGatewayConfig(args, config);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND || '';
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const server = new McpGatewayServer(gatewayConfig, downstreamCommand, downstreamArgs);
-    process.stderr.write(`AgentGuard MCP Gateway running for ${gatewayConfig.agentName}. Downstream: ${downstreamCommand} ${downstreamArgs.join(' ')}\n`);
+    const downstreamUrl = args.mcpUrl || process.env.FCD_MCP_URL || '';
+    const spec = downstreamUrl
+        ? { kind: 'http', url: downstreamUrl, headers: parseHeadersFlag(args.mcpHeaders || process.env.FCD_MCP_HEADERS) }
+        : {
+            kind: 'stdio',
+            command: args.mcpCommand || process.env.FCD_MCP_COMMAND || '',
+            args: parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS),
+        };
+    const server = new McpGatewayServer(gatewayConfig, spec);
+    const downstreamLabel = spec.kind === 'http' ? spec.url : `${spec.command} ${spec.args.join(' ')}`;
+    process.stderr.write(`AgentGuard MCP Gateway running for ${gatewayConfig.agentName}. Downstream: ${downstreamLabel}\n`);
     server.start();
 }
 function cursorMcpPath(projectScope) {
@@ -751,12 +891,38 @@ function readJson(file) {
 function gatewayScriptPath() {
     return path.resolve(process.argv[1] || path.join(__dirname, '..', 'index.js'));
 }
-function buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, options = {}) {
+/**
+ * Resolve which real MCP server an installer should protect: a local stdio
+ * command (--mcp-command/--mcp-args) or a remote HTTP/SSE URL (--mcp-url,
+ * optionally with --mcp-headers for auth).
+ */
+function resolveDownstreamSpec(args) {
+    const url = args.mcpUrl || process.env.FCD_MCP_URL;
+    if (url) {
+        return { kind: 'http', url, headers: parseHeadersFlag(args.mcpHeaders || process.env.FCD_MCP_HEADERS) };
+    }
+    const command = args.mcpCommand || process.env.FCD_MCP_COMMAND;
+    if (!command) {
+        throw new Error('Pass --mcp-command (local stdio MCP) or --mcp-url (remote HTTP/SSE MCP) for the server you want to protect.');
+    }
+    return { kind: 'stdio', command, args: parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS) };
+}
+function downstreamSpecLabel(spec) {
+    return spec.kind === 'http' ? spec.url : `${spec.command} ${spec.args.join(' ')}`.trim();
+}
+function buildGatewayCommandArgs(gatewayConfig, downstream, options = {}) {
+    const downstreamFlags = downstream.kind === 'http'
+        ? [
+            '--mcp-url', downstream.url,
+            ...(downstream.headers && Object.keys(downstream.headers).length > 0
+                ? ['--mcp-headers', JSON.stringify(downstream.headers)]
+                : []),
+        ]
+        : ['--mcp-command', downstream.command, '--mcp-args', JSON.stringify(downstream.args)];
     const commandArgs = [
         gatewayScriptPath(),
         'mcp-gateway',
-        '--mcp-command', downstreamCommand,
-        '--mcp-args', JSON.stringify(downstreamArgs),
+        ...downstreamFlags,
         '--agent-name', gatewayConfig.agentName,
         '--agent-client', gatewayConfig.agentClient,
         '--developer-name', gatewayConfig.developerName,
@@ -978,16 +1144,13 @@ async function installCursorMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     writeMcpServerConfig(file, serverName, nodeExe, commandArgs);
     console.log(`AgentGuard MCP Gateway installed for Cursor (${projectScope ? 'project' : 'global'}).`);
     console.log(`Config: ${file}`);
     console.log(`Server: ${serverName}`);
-    console.log(`Downstream: ${downstreamCommand} ${downstreamArgs.join(' ')}`);
+    console.log(`Downstream: ${downstreamSpecLabel(downstream)}`);
     console.log('Restart Cursor or reload MCP servers to use the protected tools.');
 }
 async function installMcpGatewayCommand(args, config) {
@@ -1092,9 +1255,21 @@ function wrappedEntryNeedsHeal(entry) {
     const args = Array.isArray(entry?.args) ? entry.args.map(String) : [];
     return args.includes('--shield-id') && !args.includes('--shield-key');
 }
-/** Recover the original downstream command+args from a wrapped entry's args. */
+/** Recover the original downstream server (stdio command or remote URL) from a wrapped entry's args. */
 function extractWrappedDownstream(entry) {
     const args = Array.isArray(entry?.args) ? entry.args.map(String) : [];
+    const ui = args.indexOf('--mcp-url');
+    if (ui !== -1 && args[ui + 1]) {
+        let headers;
+        const hi = args.indexOf('--mcp-headers');
+        if (hi !== -1 && args[hi + 1]) {
+            try {
+                headers = parseHeadersFlag(args[hi + 1]);
+            }
+            catch { /* leave undefined */ }
+        }
+        return { kind: 'http', url: args[ui + 1], headers };
+    }
     const ci = args.indexOf('--mcp-command');
     if (ci === -1 || ci + 1 >= args.length)
         return null;
@@ -1109,7 +1284,7 @@ function extractWrappedDownstream(entry) {
         }
         catch { /* leave empty */ }
     }
-    return { command, args: downstreamArgs };
+    return { kind: 'stdio', command, args: downstreamArgs };
 }
 /** All server maps inside a parsed JSON config, across every known client shape. */
 function collectJsonServerMaps(json) {
@@ -1314,7 +1489,7 @@ function wrapJsonConfigFile(file, gatewayConfig, agentClient, dryRun) {
                     if (downstream) {
                         const perServer = { ...gatewayConfig, agentClient, agentName: perServerAgentName(gatewayConfig.developerName, agentClient, name) };
                         entry.command = nodeExe;
-                        entry.args = buildGatewayCommandArgs(perServer, downstream.command, downstream.args, INSTALL_GATEWAY_ARGS);
+                        entry.args = buildGatewayCommandArgs(perServer, downstream, INSTALL_GATEWAY_ARGS);
                         stats.healed.push(name);
                         changed = true;
                         continue;
@@ -1323,14 +1498,35 @@ function wrapJsonConfigFile(file, gatewayConfig, agentClient, dryRun) {
                 stats.skippedManaged.push(name);
                 continue;
             }
+            const perServer = { ...gatewayConfig, agentClient, agentName: perServerAgentName(gatewayConfig.developerName, agentClient, name) };
             if (typeof entry.command !== 'string' || !entry.command) {
-                stats.skippedRemote.push(name);
+                // Remote HTTP/SSE MCP: wrap the URL behind a local stdio gateway that
+                // enforces policies, then forwards over Streamable HTTP. Original url,
+                // headers, and transport type are baked into the args for full unwrap.
+                const remoteUrl = typeof entry.url === 'string' && entry.url
+                    ? entry.url
+                    : (typeof entry.serverUrl === 'string' ? entry.serverUrl : '');
+                if (!remoteUrl || !/^https?:\/\//i.test(remoteUrl)) {
+                    stats.skippedRemote.push(name);
+                    continue;
+                }
+                const headers = entry.headers && typeof entry.headers === 'object' && !Array.isArray(entry.headers)
+                    ? Object.fromEntries(Object.entries(entry.headers).map(([k, v]) => [k, String(v)]))
+                    : undefined;
+                entry.command = nodeExe;
+                entry.args = buildGatewayCommandArgs(perServer, { kind: 'http', url: remoteUrl, headers }, INSTALL_GATEWAY_ARGS);
+                delete entry.url;
+                delete entry.serverUrl;
+                delete entry.headers;
+                if (typeof entry.type === 'string')
+                    entry.type = 'stdio'; // VS Code-style configs must match the new transport
+                stats.wrapped.push(name);
+                changed = true;
                 continue;
             }
             const downstreamCommand = entry.command;
             const downstreamArgs = Array.isArray(entry.args) ? entry.args.map(String) : [];
-            const perServer = { ...gatewayConfig, agentClient, agentName: perServerAgentName(gatewayConfig.developerName, agentClient, name) };
-            const wrappedArgs = buildGatewayCommandArgs(perServer, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+            const wrappedArgs = buildGatewayCommandArgs(perServer, { kind: 'stdio', command: downstreamCommand, args: downstreamArgs }, INSTALL_GATEWAY_ARGS);
             entry.command = nodeExe;
             entry.args = wrappedArgs;
             // entry.env and any other fields are preserved as-is.
@@ -1369,8 +1565,19 @@ function unwrapJsonConfigFile(file, dryRun) {
             const downstream = extractWrappedDownstream(entry);
             if (!downstream)
                 continue;
-            entry.command = downstream.command;
-            entry.args = downstream.args;
+            if (downstream.kind === 'http') {
+                delete entry.command;
+                delete entry.args;
+                entry.url = downstream.url;
+                if (downstream.headers && Object.keys(downstream.headers).length > 0)
+                    entry.headers = downstream.headers;
+                if (typeof entry.type === 'string')
+                    entry.type = /\/sse(\?|$)/i.test(downstream.url) ? 'sse' : 'http';
+            }
+            else {
+                entry.command = downstream.command;
+                entry.args = downstream.args;
+            }
             restored.push(name);
             changed = true;
         }
@@ -1481,7 +1688,7 @@ function transformCodexToml(file, mode, gatewayConfig, dryRun) {
                 continue;
             }
             const perServer = { ...gatewayConfig, agentClient: 'codex', agentName: perServerAgentName(gatewayConfig.developerName, 'codex', section.name) };
-            const wrappedArgs = buildGatewayCommandArgs(perServer, section.command, section.args || [], INSTALL_GATEWAY_ARGS);
+            const wrappedArgs = buildGatewayCommandArgs(perServer, { kind: 'stdio', command: section.command, args: section.args || [] }, INSTALL_GATEWAY_ARGS);
             const indent = lines[section.cmdLine].match(/^\s*/)?.[0] || '';
             lines[section.cmdLine] = `${indent}command = ${JSON.stringify(nodeExe)}`;
             const argsLineText = `${indent}args = ${tomlStringArrayLiteral(wrappedArgs)}`;
@@ -1496,7 +1703,8 @@ function transformCodexToml(file, mode, gatewayConfig, dryRun) {
             if (!wrappedAlready)
                 continue;
             const downstream = extractWrappedDownstream({ args: section.args });
-            if (!downstream)
+            // Codex TOML wraps are always stdio (remote URLs never get wrapped into TOML).
+            if (!downstream || downstream.kind !== 'stdio')
                 continue;
             const indent = lines[section.cmdLine].match(/^\s*/)?.[0] || '';
             lines[section.cmdLine] = `${indent}command = ${JSON.stringify(downstream.command)}`;
@@ -1656,12 +1864,9 @@ async function installClaudeCodeMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
+    const downstream = resolveDownstreamSpec(args);
     const includeShieldKey = false;
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, {
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, {
         ...INSTALL_GATEWAY_ARGS,
         includeShieldKey,
     });
@@ -1691,7 +1896,7 @@ async function installClaudeCodeMcpGatewayCommand(args, config) {
     if (result.status === 0) {
         console.log(`AgentGuard MCP Gateway installed for Claude Code (${scope}).`);
         console.log(`Server: ${serverName}`);
-        console.log(`Downstream: ${downstreamCommand} ${downstreamArgs.join(' ')}`);
+        console.log(`Downstream: ${downstreamSpecLabel(downstream)}`);
         if (!includeShieldKey && gatewayConfig.shieldKey) {
             console.log('Note: Shield key was loaded from local config/env and omitted from project .mcp.json. Runtime will use the developer machine config/env.');
         }
@@ -1704,7 +1909,7 @@ async function installClaudeCodeMcpGatewayCommand(args, config) {
         console.log('Claude Code CLI was not available, so project config was written directly.');
         console.log(`Config: ${file}`);
         console.log(`Server: ${serverName}`);
-        console.log(`Downstream: ${downstreamCommand} ${downstreamArgs.join(' ')}`);
+        console.log(`Downstream: ${downstreamSpecLabel(downstream)}`);
         if (!includeShieldKey && gatewayConfig.shieldKey) {
             console.log('Note: Shield key was loaded from local config/env and omitted from project .mcp.json. Runtime will use the developer machine config/env.');
         }
@@ -1723,11 +1928,8 @@ async function installClaudeDesktopMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     for (const target of targets) {
         writeMcpServerConfig(target.file, serverName, nodeExe, commandArgs);
     }
@@ -1736,7 +1938,7 @@ async function installClaudeDesktopMcpGatewayCommand(args, config) {
         console.log(`Config: ${target.file} (${target.source})`);
     }
     console.log(`Server: ${serverName}`);
-    console.log(`Downstream: ${downstreamCommand} ${downstreamArgs.join(' ')}`);
+    console.log(`Downstream: ${downstreamSpecLabel(downstream)}`);
     console.log('Restart Claude Desktop to load the protected tools.');
 }
 async function installCodexMcpGatewayCommand(args, config) {
@@ -1750,11 +1952,8 @@ async function installCodexMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     writeCodexMcpServer(file, serverName, nodeExe, commandArgs);
     console.log(`AgentGuard MCP Gateway installed for Codex (${projectScope ? 'project' : 'global'}).`);
     console.log(`Config: ${file}`);
@@ -1772,11 +1971,8 @@ async function installGeminiMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     writeJsonMcpServer(file, serverName, nodeExe, commandArgs);
     console.log(`AgentGuard MCP Gateway installed for Gemini CLI (${projectScope ? 'project' : 'user'}).`);
     console.log(`Config: ${file}`);
@@ -1793,11 +1989,8 @@ async function installWindsurfMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     writeJsonMcpServer(file, serverName, nodeExe, commandArgs);
     console.log('AgentGuard MCP Gateway installed for Windsurf.');
     console.log(`Config: ${file}`);
@@ -1814,11 +2007,8 @@ async function installVscodeMcpGatewayCommand(args, config) {
     const nodeExe = process.execPath;
     const serverName = args.serverName || MANAGED_SERVER_NAME;
     const gatewayConfig = applyPerServerAgentName(baseGatewayConfig, args, serverName);
-    const downstreamCommand = args.mcpCommand || process.env.FCD_MCP_COMMAND;
-    if (!downstreamCommand)
-        throw new Error('Pass --mcp-command for the real MCP server you want to protect.');
-    const downstreamArgs = parseArgsList(args.mcpArgs || process.env.FCD_MCP_ARGS);
-    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstreamCommand, downstreamArgs, INSTALL_GATEWAY_ARGS);
+    const downstream = resolveDownstreamSpec(args);
+    const commandArgs = buildGatewayCommandArgs(gatewayConfig, downstream, INSTALL_GATEWAY_ARGS);
     const targets = [];
     if (projectScope)
         targets.push(vscodeMcpPath(true));

package/dist/index.js

@@ -327,6 +327,8 @@ function printHelp() {
     $ fullcourtdefense discover --surface secrets
     $ fullcourtdefense discover --surface agent-files
     $ fullcourtdefense discover --deep --upload --silent --user-email you@company.com
+    $ fullcourtdefense discover --surface mcp --scan-root auto --upload
+    $ fullcourtdefense discover --surface mcp --scan-root "C:\dev,D:\work" --upload
     $ fullcourtdefense discover --type mcp --json
     $ fullcourtdefense install-cursor-hook
     $ fullcourtdefense install-cursor-hook --shadow true        # monitor only
@@ -342,7 +344,9 @@ function printHelp() {
     $ fullcourtdefense install-claude-code-mcp-gateway --scope local --mcp-command npm --mcp-args "run mcp"
     $ fullcourtdefense install-claude-code-mcp-gateway --scope project --mcp-command npm --mcp-args "run mcp"
     $ fullcourtdefense install-claude-desktop-mcp-gateway --mcp-command npm --mcp-args "run mcp"
+    $ fullcourtdefense install-cursor-mcp-gateway --server-name my-remote --mcp-url https://mcp.company.com/mcp
     $ fullcourtdefense mcp-gateway --mcp-command npm --mcp-args "run mcp"
+    $ fullcourtdefense mcp-gateway --mcp-url https://mcp.company.com/mcp --mcp-headers "{\"Authorization\":\"Bearer TOKEN\"}"
     $ fullcourtdefense login --token <fleet-enrollment-token>
     $ fullcourtdefense install-all
     $ fullcourtdefense install-all --auto-protect true --upload
@@ -366,6 +370,8 @@ async function main() {
         serverName: flags['server-name'],
         mcpCommand: flags['mcp-command'],
         mcpArgs: flags['mcp-args'],
+        mcpUrl: flags['mcp-url'],
+        mcpHeaders: flags['mcp-headers'],
         agentName: flags['agent-name'],
         developerName: flags['developer-name'],
         shieldId: flags['shield-id'],
@@ -385,6 +391,8 @@ async function main() {
     const buildGatewayArgs = () => ({
         mcpCommand: flags['mcp-command'],
         mcpArgs: flags['mcp-args'],
+        mcpUrl: flags['mcp-url'],
+        mcpHeaders: flags['mcp-headers'],
         agentName: flags['agent-name'],
         agentClient: flags['agent-client'],
         developerName: flags['developer-name'],
@@ -520,6 +528,8 @@ async function main() {
                 connectorName: flags['connector-name'],
                 extraPath: flags.path,
                 deep: flags.deep,
+                scanRoot: flags['scan-root'],
+                deepRoots: flags['deep-roots'],
                 silent: flags.silent,
                 userEmail: flags['user-email'],
                 schedule: flags.schedule,

package/dist/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "1.14.12"
+  "version": "1.14.14"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullcourtdefense-cli",
-  "version": "1.14.12",
+  "version": "1.14.14",
   "description": "Full Court Defense CLI — security scanning for AI agents from your terminal",
   "main": "dist/index.js",
   "bin": {
@@ -25,6 +25,7 @@
     "test:realworld-posture": "npm run build && node scripts/test-realworld-posture-fixtures.js",
     "test:discover-stdio-mcp": "npm run build && node scripts/test-discover-stdio-mcp-tools.js",
     "test:per-server-agent-name": "npm run build && node scripts/test-per-server-agent-name.js",
+    "test:remote-mcp-gateway": "npm run build && node scripts/test-remote-mcp-gateway.js",
     "test:posture-blast": "npm run build && node scripts/test-posture-blast-radius.js",
     "test:ping-e2e": "npm run build && node scripts/test-ping-e2e.js",
     "prepublishOnly": "npm run build"