genexus-mcp 2.3.3 → 2.3.4

package/cli/commands/axi.js

@@ -11,6 +11,9 @@ const {
     createConfigFile,
     patchClientConfig,
     unpatchClientConfig,
+    getClientConfigTargets,
+    filterClientTargets,
+    listSupportedClientIds,
     getLocalAppDataCacheDir,
     readGeneXusVersionFromInstall,
     discoverGeneXusInstallation,
@@ -21,6 +24,25 @@ const {
     switchActiveKb
 } = require('../lib/config');
 
+function resolveClientIds(options) {
+    if (!options || !options.clients) return null;
+    return String(options.clients)
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+
+function validateClientIds(ids) {
+    if (!ids) return { ok: true };
+    const supported = new Set(listSupportedClientIds());
+    const invalid = ids.filter((id) => !supported.has(id));
+    if (invalid.length === 0) return { ok: true };
+    return {
+        ok: false,
+        message: `Unknown client id(s): ${invalid.join(', ')}. Supported: ${[...supported].join(', ')}.`
+    };
+}
+
 function parseFieldSelection(raw) {
     if (!raw) return null;
     return raw.split(',').map((v) => v.trim()).filter(Boolean);
@@ -769,8 +791,24 @@ async function runInteractiveInit(ctx) {
         const gxAnswer = await question(`\n2) GeneXus installation path (default: ${defaultGx}):\n> `);
         const finalGx = String(gxAnswer || '').trim() || defaultGx;
 
+        const allTargets = getClientConfigTargets();
+        const platformTargets = filterClientTargets(allTargets, { platform: process.platform });
+        ctx.stderr.write('\n3) Select AI agents to register (y/N per agent; Enter accepts default):\n');
+        const selectedIds = [];
+        for (const target of platformTargets) {
+            const installed = fs.existsSync(target.path);
+            const defaultYes = installed;
+            const tag = installed ? 'detected' : 'not detected';
+            const prompt = `   - ${target.name} [${tag}] (${defaultYes ? 'Y/n' : 'y/N'}): `;
+            const ans = (await question(prompt)).trim().toLowerCase();
+            const yes = ans === '' ? defaultYes : (ans === 'y' || ans === 'yes');
+            if (yes) selectedIds.push(target.id);
+        }
+
         const created = createConfigFile(finalKb, finalGx);
-        const patchResult = patchClientConfig(created.targetConfigPath);
+        const patchResult = selectedIds.length
+            ? patchClientConfig(created.targetConfigPath, { ids: selectedIds, onlyExisting: false })
+            : { patched: [], failed: [], skipped: [] };
 
         return {
             exitCode: ctx.EXIT_CODES.OK,
@@ -785,7 +823,8 @@ async function runInteractiveInit(ctx) {
                 help: patchResult.patched.length === 0 ? ['Set `GX_CONFIG_PATH` in your MCP client env to the generated config path.'] : [],
                 meta: {
                     patchedClients: patchResult.patched,
-                    failedClients: patchResult.failed
+                    failedClients: patchResult.failed,
+                    skippedClients: patchResult.skipped || []
                 }
             }
         };
@@ -843,9 +882,20 @@ async function handleInit(options, ctx) {
         const kbName = path.basename(resolution.kb.value);
         addKbToConfig(created.targetConfigPath, kbName, resolution.kb.value);
 
-        let patchResult = { patched: [], failed: [] };
+        let patchResult = { patched: [], failed: [], skipped: [] };
         if (options.writeClients) {
-            patchResult = patchClientConfig(created.targetConfigPath);
+            const ids = resolveClientIds(options);
+            const validation = validateClientIds(ids);
+            if (!validation.ok) {
+                return {
+                    exitCode: ctx.EXIT_CODES.USAGE,
+                    envelope: usageEnvelope(validation.message, ctx.EXIT_CODES.USAGE)
+                };
+            }
+            patchResult = patchClientConfig(created.targetConfigPath, {
+                ids,
+                onlyExisting: !options.allClients
+            });
         }
 
         const verification = await runPostInitVerification({
@@ -894,6 +944,7 @@ async function handleInit(options, ctx) {
                 meta: {
                     patchedClients: patchResult.patched,
                     failedClients: patchResult.failed,
+                    skippedClients: patchResult.skipped || [],
                     smokeSkipped: !!options.noSmoke,
                     warmed: !!warm && warm.status === 'pass'
                 }
@@ -1229,11 +1280,12 @@ function commandHelpMap() {
             examples: ['genexus-mcp config show', 'genexus-mcp config show --full --format json']
         },
         init: {
-            usage: 'genexus-mcp init [--kb <path>] [--gx <path>] [--write-clients] [--no-smoke] [--warm] [--format ...] OR genexus-mcp init --interactive',
+            usage: 'genexus-mcp init [--kb <path>] [--gx <path>] [--write-clients] [--clients <csv>] [--all-clients] [--no-smoke] [--warm] [--format ...] OR genexus-mcp init --interactive',
             examples: [
                 'genexus-mcp init   # zero-config: auto-discovers GX from registry/Program Files and KB from cwd',
                 'genexus-mcp init --kb "C:\\KBs\\MyKB" --gx "C:\\Program Files (x86)\\GeneXus\\GeneXus18"',
-                'genexus-mcp init --interactive',
+                'genexus-mcp init --interactive   # prompts per detected agent (Claude Desktop/Code, Gemini CLI, Cursor, Codex CLI, OpenCode, ...)',
+                'genexus-mcp init --kb <path> --gx <path> --write-clients --clients claude-code,gemini-cli,cursor',
                 'genexus-mcp init --kb <path> --gx <path> --no-smoke'
             ]
         },

package/cli/index.js

@@ -39,6 +39,8 @@ const GLOBAL_DEFAULTS = {
     fields: null,
     interactive: false,
     writeClients: false,
+    clients: null,
+    allClients: false,
     mcpSmoke: false,
     noSmoke: false,
     warm: false,
@@ -186,6 +188,15 @@ function parseArgs(argv) {
                 else result.unknownFlags.push('--query requires a value');
                 break;
             }
+            case 'clients': {
+                const val = takeValue();
+                if (val) result.options.clients = val;
+                else result.unknownFlags.push('--clients requires a value');
+                break;
+            }
+            case 'all-clients':
+                result.options.allClients = true;
+                break;
             case 'action': {
                 const val = takeValue();
                 if (val) result.options.action = val;

package/cli/lib/config.js

@@ -58,23 +58,73 @@ function discoverGeneXusFromRegistry() {
 }
 
 function discoverGeneXusInstallation() {
-    const possible = [
-        'C:\\Program Files (x86)\\GeneXus\\GeneXus18',
-        'C:\\Program Files (x86)\\GeneXus\\GeneXus17',
-        'C:\\Program Files (x86)\\GeneXus\\GeneXus16',
-        'C:\\Program Files\\GeneXus\\GeneXus18',
-        'C:\\Program Files\\GeneXus\\GeneXus17'
-    ];
-
-    for (const candidate of possible) {
-        if (fs.existsSync(path.join(candidate, 'genexus.exe'))) {
-            return candidate;
-        }
+    if (process.env.GENEXUS_HOME) {
+        const candidate = process.env.GENEXUS_HOME.replace(/[\\/]+$/, '');
+        if (fs.existsSync(path.join(candidate, 'genexus.exe'))) return candidate;
     }
 
     const fromRegistry = discoverGeneXusFromRegistry();
     if (fromRegistry) return fromRegistry;
 
+    const programDirs = [];
+    if (process.env['ProgramFiles(x86)']) programDirs.push(process.env['ProgramFiles(x86)']);
+    if (process.env.ProgramFiles) programDirs.push(process.env.ProgramFiles);
+    // Cover non-default drives where IT often installs SDKs.
+    for (const drive of ['C', 'D', 'E']) {
+        programDirs.push(`${drive}:\\Program Files (x86)`);
+        programDirs.push(`${drive}:\\Program Files`);
+    }
+
+    const versions = ['GeneXus18', 'GeneXus17', 'GeneXus16'];
+    const seen = new Set();
+    for (const base of programDirs) {
+        const root = path.join(base, 'GeneXus');
+        const key = root.toLowerCase();
+        if (seen.has(key)) continue;
+        seen.add(key);
+        for (const ver of versions) {
+            const candidate = path.join(root, ver);
+            if (fs.existsSync(path.join(candidate, 'genexus.exe'))) {
+                return candidate;
+            }
+        }
+        // Also scan any GeneXus* sibling (e.g. custom-named "GeneXus18 U10").
+        try {
+            if (fs.existsSync(root)) {
+                for (const entry of fs.readdirSync(root)) {
+                    if (!/^GeneXus/i.test(entry)) continue;
+                    const candidate = path.join(root, entry);
+                    if (fs.existsSync(path.join(candidate, 'genexus.exe'))) {
+                        return candidate;
+                    }
+                }
+            }
+        } catch {
+        }
+    }
+
+    const fromPath = discoverGeneXusFromPath();
+    if (fromPath) return fromPath;
+
+    return null;
+}
+
+function discoverGeneXusFromPath() {
+    if (process.platform !== 'win32') return null;
+    try {
+        const { execFileSync } = require('child_process');
+        const out = execFileSync('where.exe', ['genexus.exe'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            windowsHide: true,
+            timeout: 3000
+        });
+        const first = out.split(/\r?\n/).map((s) => s.trim()).find(Boolean);
+        if (first && fs.existsSync(first)) {
+            return path.dirname(first);
+        }
+    } catch {
+    }
     return null;
 }
 
@@ -145,77 +195,132 @@ function createConfigFile(kbPath, gxPath) {
     };
 }
 
-function patchClientConfig(targetConfigPath) {
-    const clients = getClientConfigTargets();
-
+function getLauncher() {
     // Set by scripts/install.ps1 for fixed-path corporate installs — clients
     // launch the gateway exe directly instead of resolving via the npx cache.
     const directExe = process.env.GENEXUS_MCP_GATEWAY_EXE;
-    const launcher = directExe
+    return directExe
         ? { command: directExe, args: [] }
         : { command: process.platform === 'win32' ? 'npx.cmd' : 'npx', args: ['-y', 'genexus-mcp@latest'] };
+}
 
-    const patched = [];
-    const failed = [];
+function getClientConfigTargets() {
+    const home = os.homedir();
+    const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(home, '.config');
+    return [
+        {
+            id: 'claude-desktop-win',
+            name: 'Claude Desktop (Windows)',
+            format: 'mcpServers',
+            path: path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json'),
+            platforms: ['win32']
+        },
+        {
+            id: 'claude-desktop-mac',
+            name: 'Claude Desktop (macOS)',
+            format: 'mcpServers',
+            path: path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'),
+            platforms: ['darwin']
+        },
+        {
+            id: 'antigravity',
+            name: 'Antigravity',
+            format: 'mcpServers',
+            path: path.join(home, '.gemini', 'antigravity', 'mcp_config.json')
+        },
+        {
+            id: 'claude-code',
+            name: 'Claude Code',
+            format: 'mcpServers',
+            path: path.join(home, '.claude.json')
+        },
+        {
+            id: 'gemini-cli',
+            name: 'Gemini CLI',
+            format: 'mcpServers',
+            path: path.join(home, '.gemini', 'settings.json')
+        },
+        {
+            id: 'cursor',
+            name: 'Cursor',
+            format: 'mcpServers',
+            path: path.join(home, '.cursor', 'mcp.json')
+        },
+        {
+            id: 'opencode',
+            name: 'OpenCode',
+            format: 'opencode',
+            path: path.join(xdgConfig, 'opencode', 'opencode.json')
+        },
+        {
+            id: 'codex-cli',
+            name: 'Codex CLI',
+            format: 'codex-toml',
+            path: path.join(home, '.codex', 'config.toml')
+        }
+    ];
+}
+
+function listSupportedClientIds() {
+    return getClientConfigTargets().map((c) => c.id);
+}
 
-    for (const client of clients) {
-        if (!fs.existsSync(client.path)) continue;
+function filterClientTargets(targets, opts = {}) {
+    const { ids, onlyExisting, platform } = opts;
+    let out = targets;
+    if (platform) out = out.filter((c) => !c.platforms || c.platforms.includes(platform));
+    if (ids && ids.length) {
+        const set = new Set(ids);
+        out = out.filter((c) => set.has(c.id));
+    }
+    if (onlyExisting) out = out.filter((c) => fs.existsSync(c.path));
+    return out;
+}
 
-        try {
-            const parsed = readJsonFileSafe(client.path);
-            if (parsed === null) {
-                failed.push({ client: client.name, reason: 'Invalid JSON' });
-                continue;
-            }
+function patchClientConfig(targetConfigPath, opts = {}) {
+    const launcher = getLauncher();
+    const onlyExisting = opts.onlyExisting !== false;
+    const candidates = filterClientTargets(getClientConfigTargets(), {
+        ids: opts.ids,
+        platform: process.platform
+    });
 
-            const cfgObj = parsed || {};
-            cfgObj.mcpServers = cfgObj.mcpServers || {};
-            cfgObj.mcpServers.genexus = { ...launcher, env: { GX_CONFIG_PATH: targetConfigPath } };
+    const patched = [];
+    const failed = [];
+    const skipped = [];
 
-            fs.writeFileSync(client.path, JSON.stringify(cfgObj, null, 2));
+    for (const client of candidates) {
+        if (onlyExisting && !fs.existsSync(client.path)) {
+            skipped.push({ client: client.name, reason: 'not installed' });
+            continue;
+        }
+        try {
+            fs.mkdirSync(path.dirname(client.path), { recursive: true });
+            applyClientEntry(client, launcher, targetConfigPath);
             patched.push(client.name);
         } catch (err) {
             failed.push({ client: client.name, reason: err && err.message ? err.message : 'Unknown error' });
         }
     }
 
-    return { patched, failed };
-}
-
-function getClientConfigTargets() {
-    return [
-        { path: path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json'), name: 'Claude Desktop (Windows)' },
-        { path: path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json'), name: 'Claude Desktop (macOS)' },
-        { path: path.join(os.homedir(), '.gemini', 'antigravity', 'mcp_config.json'), name: 'Antigravity' },
-        { path: path.join(os.homedir(), '.claude.json'), name: 'Claude Code' }
-    ];
+    return { patched, failed, skipped };
 }
 
-function unpatchClientConfig() {
-    const clients = getClientConfigTargets();
+function unpatchClientConfig(opts = {}) {
+    const targets = filterClientTargets(getClientConfigTargets(), {
+        ids: opts.ids,
+        onlyExisting: true,
+        platform: process.platform
+    });
     const removed = [];
     const skipped = [];
     const failed = [];
 
-    for (const client of clients) {
-        if (!fs.existsSync(client.path)) continue;
-
+    for (const client of targets) {
         try {
-            const parsed = readJsonFileSafe(client.path);
-            if (parsed === null) {
-                failed.push({ client: client.name, reason: 'Invalid JSON' });
-                continue;
-            }
-
-            const cfgObj = parsed || {};
-            if (!cfgObj.mcpServers || !cfgObj.mcpServers.genexus) {
-                skipped.push({ client: client.name, reason: 'no genexus entry' });
-                continue;
-            }
-
-            delete cfgObj.mcpServers.genexus;
-            fs.writeFileSync(client.path, JSON.stringify(cfgObj, null, 2));
-            removed.push(client.name);
+            const wasRemoved = removeClientEntry(client);
+            if (wasRemoved) removed.push(client.name);
+            else skipped.push({ client: client.name, reason: 'no genexus entry' });
         } catch (err) {
             failed.push({ client: client.name, reason: err && err.message ? err.message : 'Unknown error' });
         }
@@ -224,6 +329,133 @@ function unpatchClientConfig() {
     return { removed, skipped, failed };
 }
 
+function applyClientEntry(client, launcher, targetConfigPath) {
+    switch (client.format) {
+        case 'mcpServers':
+            return applyMcpServersJson(client.path, launcher, targetConfigPath);
+        case 'opencode':
+            return applyOpenCodeJson(client.path, launcher, targetConfigPath);
+        case 'codex-toml':
+            return applyCodexToml(client.path, launcher, targetConfigPath);
+        default:
+            throw new Error(`Unknown client format: ${client.format}`);
+    }
+}
+
+function removeClientEntry(client) {
+    switch (client.format) {
+        case 'mcpServers':
+            return removeMcpServersJson(client.path);
+        case 'opencode':
+            return removeOpenCodeJson(client.path);
+        case 'codex-toml':
+            return removeCodexToml(client.path);
+        default:
+            throw new Error(`Unknown client format: ${client.format}`);
+    }
+}
+
+function applyMcpServersJson(filePath, launcher, targetConfigPath) {
+    const parsed = fs.existsSync(filePath) ? readJsonFileSafe(filePath) : {};
+    if (parsed === null) throw new Error('Invalid JSON');
+    const cfgObj = parsed || {};
+    cfgObj.mcpServers = cfgObj.mcpServers || {};
+    cfgObj.mcpServers.genexus = { ...launcher, env: { GX_CONFIG_PATH: targetConfigPath } };
+    fs.writeFileSync(filePath, JSON.stringify(cfgObj, null, 2));
+}
+
+function removeMcpServersJson(filePath) {
+    const parsed = readJsonFileSafe(filePath);
+    if (parsed === null) throw new Error('Invalid JSON');
+    const cfgObj = parsed || {};
+    if (!cfgObj.mcpServers || !cfgObj.mcpServers.genexus) return false;
+    delete cfgObj.mcpServers.genexus;
+    fs.writeFileSync(filePath, JSON.stringify(cfgObj, null, 2));
+    return true;
+}
+
+// OpenCode (sst/opencode) uses `mcp.<name>` with `type: 'local'` and `command: string[]`.
+function applyOpenCodeJson(filePath, launcher, targetConfigPath) {
+    const parsed = fs.existsSync(filePath) ? readJsonFileSafe(filePath) : {};
+    if (parsed === null) throw new Error('Invalid JSON');
+    const cfgObj = parsed || {};
+    cfgObj.mcp = cfgObj.mcp || {};
+    cfgObj.mcp.genexus = {
+        type: 'local',
+        command: [launcher.command, ...(launcher.args || [])],
+        environment: { GX_CONFIG_PATH: targetConfigPath },
+        enabled: true
+    };
+    fs.writeFileSync(filePath, JSON.stringify(cfgObj, null, 2));
+}
+
+function removeOpenCodeJson(filePath) {
+    const parsed = readJsonFileSafe(filePath);
+    if (parsed === null) throw new Error('Invalid JSON');
+    const cfgObj = parsed || {};
+    if (!cfgObj.mcp || !cfgObj.mcp.genexus) return false;
+    delete cfgObj.mcp.genexus;
+    fs.writeFileSync(filePath, JSON.stringify(cfgObj, null, 2));
+    return true;
+}
+
+// Codex CLI uses TOML. We do a minimal text-merge: strip any existing
+// [mcp_servers.genexus*] blocks and append fresh ones. Brittle on hand-edited
+// files that put other keys after our blocks without a blank line, but
+// adequate for the typical machine-managed config.
+function applyCodexToml(filePath, launcher, targetConfigPath) {
+    let existing = '';
+    if (fs.existsSync(filePath)) existing = fs.readFileSync(filePath, 'utf8');
+    const stripped = stripCodexGenexusBlocks(existing);
+    const args = launcher.args || [];
+    const lines = [];
+    if (stripped.length && !stripped.endsWith('\n')) lines.push('');
+    if (stripped.length) lines.push('');
+    lines.push('[mcp_servers.genexus]');
+    lines.push(`command = ${tomlString(launcher.command)}`);
+    lines.push(`args = [${args.map(tomlString).join(', ')}]`);
+    lines.push('');
+    lines.push('[mcp_servers.genexus.env]');
+    lines.push(`GX_CONFIG_PATH = ${tomlString(targetConfigPath)}`);
+    lines.push('');
+    fs.writeFileSync(filePath, stripped + lines.join('\n'));
+}
+
+function removeCodexToml(filePath) {
+    if (!fs.existsSync(filePath)) return false;
+    const existing = fs.readFileSync(filePath, 'utf8');
+    const stripped = stripCodexGenexusBlocks(existing);
+    if (stripped === existing) return false;
+    fs.writeFileSync(filePath, stripped);
+    return true;
+}
+
+function stripCodexGenexusBlocks(content) {
+    // Walk line-by-line so values like `args = []` don't confuse the parser.
+    // A section ends at the next line that starts a [section] header (top-level
+    // tables and arrays of tables only — must begin at column 0).
+    const lines = content.split('\n');
+    const out = [];
+    const headerRe = /^\[\[?[A-Za-z0-9_."'-]+/;
+    const ourRe = /^\[\[?mcp_servers\.genexus(\.[A-Za-z0-9_."'-]+)?\]\]?\s*$/;
+    let inOurs = false;
+    for (const line of lines) {
+        if (headerRe.test(line)) {
+            inOurs = ourRe.test(line);
+            if (inOurs) continue;
+        }
+        if (inOurs) continue;
+        out.push(line);
+    }
+    // Collapse 3+ trailing blank lines we may have left behind.
+    return out.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+
+function tomlString(value) {
+    const s = String(value);
+    return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+
 function getLocalAppDataCacheDir() {
     if (process.platform !== 'win32') return null;
     const base = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
@@ -388,6 +620,8 @@ module.exports = {
     patchClientConfig,
     unpatchClientConfig,
     getClientConfigTargets,
+    listSupportedClientIds,
+    filterClientTargets,
     getLocalAppDataCacheDir,
     readGeneXusVersionFromInstall,
     readKbCatalog,

package/cli/run.test.js

@@ -400,7 +400,7 @@ test('tool_definitions.json is valid and disambiguation tools have use-when guid
     assert.ok(Array.isArray(defs) && defs.length > 0, 'tool defs should be a non-empty array');
 
     const byName = Object.fromEntries(defs.map((t) => [t.name, t]));
-    const disambiguationTools = ['genexus_inspect', 'genexus_analyze', 'genexus_summarize', 'genexus_doc'];
+    const disambiguationTools = ['genexus_inspect', 'genexus_analyze', 'genexus_doc'];
     for (const name of disambiguationTools) {
         assert.ok(byName[name], `${name} should exist`);
         const desc = byName[name].description || '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "2.3.3",
+  "version": "2.3.4",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 18 MCP server — read, edit, and analyze GeneXus knowledge base objects (transactions, web panels, procedures, SDTs) directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [

package/publish/GxMcp.Gateway.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v8.0": {
-      "GxMcp.Gateway/2.3.3": {
+      "GxMcp.Gateway/2.3.4": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -81,7 +81,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/2.3.3": {
+    "GxMcp.Gateway/2.3.4": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/publish/tool_definitions.json

@@ -1,31 +1,31 @@
-[
-  {"name":"genexus_whoami","description":"Return current KB context, GeneXus install, and MCP version.","inputSchema":{"type":"object","properties":{}}},
-  {"name":"genexus_query","description":"Search objects. Prefixes: usedby:, type:, description:, parent:, parentPath:. Triggers KB index build on first call against a fresh install — _meta.partial=true means more results will appear as indexing continues (watch notifications/progress). Literal-name queries skip the index via direct SDK lookup. genexus_read / genexus_edit / genexus_list_objects / genexus_lifecycle are index-independent and always return immediately.","inputSchema":{"type":"object","properties":{"query":{"type":"string"},"typeFilter":{"type":"string"},"domainFilter":{"type":"string"},"limit":{"type":"integer"},"inline_read_top":{"type":"integer","description":"0-3. When >0, response includes inline_reads array with full content of the top N matches. Capped at 3."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["query"]}},
-  {"name":"genexus_list_objects","description":"List objects with pagination. Feed nextOffset until hasMore=false. Returns minimal shape by default (name, type, path, parent); verbose=true for full shape.","inputSchema":{"type":"object","properties":{"filter":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"parent":{"type":"string"},"parentPath":{"type":"string"},"typeFilter":{"type":"string"},"verbose":{"type":"boolean","description":"When true, returns full item shape (default false)."},"inline_read_top":{"type":"integer","description":"0-3. When >0, response includes inline_reads array with full content of the top N matches. Capped at 3."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
-  {"name":"genexus_read","description":"Read source/metadata parts. name or targets (mutually exclusive). Paginate with offset/limit. Use parts=[\"Source\",\"Variables\",...] to select specific parts and skip the rest.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"targets":{"type":"array","items":{"type":"string"}},"part":{"type":"string"},"parts":{"type":"array","items":{"type":"string"},"description":"When set, only the listed parts are returned in a combined response. Mutually exclusive with part/offset/limit."},"offset":{"type":"integer"},"limit":{"type":"integer"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
-  {"name":"genexus_edit","description":"Edit source/metadata. name or targets (mutually exclusive). Use dryRun=true with mode=patch first. Returns post_state.diff (unified diff) by default; verbose=true adds slices (±15 lines); return_post_state=false opts out.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"part":{"type":"string"},"mode":{"type":"string","enum":["full","patch","ops"]},"content":{"type":"string"},"ops":{"type":"array","items":{"type":"object","properties":{"op":{"type":"string"}},"required":["op"]}},"patch":{},"context":{"type":"string"},"operation":{"type":"string","enum":["Replace","Insert_After","Append"]},"expectedCount":{"type":"integer"},"dryRun":{"type":"boolean"},"verifyRollback":{"type":"boolean"},"targets":{"type":"array","items":{"type":"object","required":["name","content"]}},"type":{"type":"string"},"return_post_state":{"type":"boolean","description":"Set false to omit post_state.diff from the response (default true)."},"verbose":{"type":"boolean","description":"When true, adds slices (±15 lines around each hunk) to post_state (default false)."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
-  {"name":"genexus_inspect","description":"Snapshot of an object: metadata, variables, structure, signature.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"include":{"type":"array","items":{"type":"string","enum":["metadata","variables","signature","structure","parts","controls","events_repertoire"]}},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
-  {"name":"genexus_analyze","description":"Semantic analysis: impact, dependencies, complexity, naming, summary, explain.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"mode":{"type":"string","enum":["linter","navigation","hierarchy","impact","data_context","ui_context","pattern_metadata","summary","explain"]},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."},"code":{"type":"string","description":"Required when mode=explain."}},"required":["name","mode"]}},
-  {"name":"genexus_inject_context","description":"Inject SDT structures and Procedure signatures of called objects.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"recursive":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
-  {"name":"genexus_lifecycle","description":"Build/validate/index/poll. action=build is non-blocking when estimated_seconds>=20 — returns {job_id, status:running} and surfaces _meta.background_jobs on the next call. action=status accepts taskId OR job_id via target; wait_seconds>0 long-polls up to 25s.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["build","cancel","rebuild","reorg","validate","validate-kb","sync","index","status","result","snapshots-list","snapshots-restore"]},"target":{"type":"string","description":"Object name(s), taskId, job_id, or op:<operationId>."},"code":{"type":"string"},"limit":{"type":"integer"},"snapshotPath":{"type":"string"},"estimated_seconds":{"type":"integer","description":"Build: <20 forces sync fast-path (one turn); >=20 (default 60) goes async."},"wait_seconds":{"type":"integer","description":"Status: 0-25. >0 long-polls server-side until terminal or timeout."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
-  {"name":"genexus_forge","description":"Generate new code or structures from templates or translations.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["scaffold","translate","sample"]},"type":{"type":"string"},"name":{"type":"string"},"content":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
-  {"name":"genexus_test","description":"Execute native GeneXus tests (GXtest).","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
-  {"name":"genexus_create_object","description":"Create a new GeneXus object in the active KB.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"e.g. Procedure, Transaction, WebPanel, SDT."},"name":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["type","name"]}},
-  {"name":"genexus_logs","description":"Read worker_debug.log tail for error diagnosis or correlation.","inputSchema":{"type":"object","properties":{"lines":{"type":"integer"},"filterCorrelation":{"type":"string"},"grep":{"type":"string"}}}},
-  {"name":"genexus_worker_reload","description":"Hot-reload worker: copy new binaries and respawn.","inputSchema":{"type":"object","properties":{"sourceDir":{"type":"string","description":"Absolute path to freshly built bin/Release."}},"required":["sourceDir"]}},
-  {"name":"genexus_delete_object","description":"Delete an object from the KB. Irreversible — confirm=true required.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"confirm":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","confirm"]}},
-  {"name":"genexus_export_object","description":"Export a GeneXus object part to a text file on disk.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"outputPath":{"type":"string"},"part":{"type":"string"},"type":{"type":"string"},"overwrite":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","outputPath"]}},
-  {"name":"genexus_import_object","description":"Import a text file from disk into a GeneXus object part.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"inputPath":{"type":"string"},"part":{"type":"string"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","inputPath"]}},
-  {"name":"genexus_refactor","description":"Run GeneXus refactor: rename, extract procedure, or WWP condition set.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["RenameAttribute","RenameVariable","RenameObject","ExtractProcedure","WWPSetCondition"]},"target":{"type":"string","description":"Primary object or symbol to refactor."},"newName":{"type":"string"},"objectName":{"type":"string"},"code":{"type":"string"},"procedureName":{"type":"string"},"controlAttribute":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
-  {"name":"genexus_add_variable","description":"Add a variable to the Variables part of a GeneXus object.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"varName":{"type":"string"},"typeName":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","varName"]}},
-  {"name":"genexus_format","description":"Format a GeneXus code snippet using worker rules.","inputSchema":{"type":"object","properties":{"code":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["code"]}},
-  {"name":"genexus_properties","description":"Read or update GeneXus object properties.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get","set"]},"name":{"type":"string"},"control":{"type":"string"},"propertyName":{"type":"string"},"value":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
-  {"name":"genexus_asset","description":"Find, read, or write binary assets inside the active KB.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["find","read","write"]},"path":{"type":"string"},"includeContent":{"type":"boolean"},"maxBytes":{"type":"integer"},"pattern":{"type":"string"},"relativeRoot":{"type":"string"},"limit":{"type":"integer"},"contentBase64":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
-  {"name":"genexus_history","description":"List, read, save, or restore GeneXus object history snapshots.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get_source","save","restore"]},"name":{"type":"string"},"versionId":{"type":"integer"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
-  {"name":"genexus_structure","description":"Read or update visual and logical structure of GeneXus objects.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get_visual","update_visual","get_indexes","get_logic"]},"name":{"type":"string"},"payload":{"type":"object","description":"Update payload for update_visual."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
-  {"name":"genexus_layout","description":"Native SDK layout/WebForm operations: get_tree, set_property, find_controls, inspect_surface, scan_mutators.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get_tree","set_property","find_controls","set_properties","inspect_surface","get_preview","scan_mutators","rename_printblock","add_printblock"]},"name":{"type":"string"},"target":{"type":"string","description":"Object name alias for backward compatibility."},"control":{"type":"string"},"propertyName":{"type":"string"},"value":{"type":"string"},"query":{"type":"string"},"changes":{"type":"array","items":{"type":"object","required":["control","propertyName","value"]}},"limit":{"type":"integer"},"currentName":{"type":"string"},"newName":{"type":"string"},"printBlockName":{"type":"string"},"height":{"type":"integer"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
-  {"name":"genexus_doc","description":"Generate structured docs (markdown, sequence diagrams, API contracts).","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["wiki","visualize","health"]},"target":{"type":"string","description":"Object or domain name."}},"required":["action"]}},
-  {"name":"genexus_search_source","description":"Regex/semantic search across Procedure/DataProvider/WebPanel/Transaction source.","inputSchema":{"type":"object","properties":{"callee":{"type":"string","description":"Method/function name (qualified or unqualified)."},"argMatches":{"type":"object","description":"Positional arg index to expected literal text."},"pattern":{"type":"string"},"typeFilter":{"type":"string"},"scope":{"type":"array","items":{"type":"string"}},"maxResults":{"type":"integer"},"caseSensitive":{"type":"boolean"},"includeComments":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
-  {"name":"genexus_kb","description":"Manage open KBs: list (with PID/RSS/idle), open (acquire Worker), close (release), set_default (persist alias to config.json).","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","open","close","set_default"]},"alias":{"type":"string","description":"KB alias (for open/close). For open, auto-generated from path basename if omitted."},"path":{"type":"string","description":"Absolute path to the KB (required for action=open if alias is not declared in config)."}},"required":["action"]}},
-  {"name":"genexus_sql","description":"SQL for a Transaction/Table (DDL) or a procedure For Each navigation.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["ddl","navigation"]},"name":{"type":"string"},"includeSubordinated":{"type":"boolean","description":"action=ddl only."},"levelNumber":{"type":"integer","description":"action=navigation only."},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}}
-]
+[
+  {"name":"genexus_whoami","description":"Return current KB context, GeneXus install, and MCP version.","inputSchema":{"type":"object","properties":{}}},
+  {"name":"genexus_query","description":"Search objects. Prefixes: usedby:, type:, description:, parent:, parentPath:. Triggers KB index build on first call against a fresh install — _meta.partial=true means more results will appear as indexing continues (watch notifications/progress). Literal-name queries skip the index via direct SDK lookup. genexus_read / genexus_edit / genexus_list_objects / genexus_lifecycle are index-independent and always return immediately.","inputSchema":{"type":"object","properties":{"query":{"type":"string"},"typeFilter":{"type":"string"},"domainFilter":{"type":"string"},"limit":{"type":"integer"},"inline_read_top":{"type":"integer","description":"0-3. When >0, response includes inline_reads array with full content of the top N matches. Capped at 3."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["query"]}},
+  {"name":"genexus_list_objects","description":"List objects with pagination. Feed nextOffset until hasMore=false. Returns minimal shape by default (name, type, path, parent); verbose=true for full shape.","inputSchema":{"type":"object","properties":{"filter":{"type":"string"},"limit":{"type":"integer"},"offset":{"type":"integer"},"parent":{"type":"string"},"parentPath":{"type":"string"},"typeFilter":{"type":"string"},"verbose":{"type":"boolean","description":"When true, returns full item shape (default false)."},"inline_read_top":{"type":"integer","description":"0-3. When >0, response includes inline_reads array with full content of the top N matches. Capped at 3."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
+  {"name":"genexus_read","description":"Read source/metadata parts. name or targets (mutually exclusive). Paginate with offset/limit. Use parts=[\"Source\",\"Variables\",...] to select specific parts and skip the rest.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"targets":{"type":"array","items":{"type":"string"}},"part":{"type":"string"},"parts":{"type":"array","items":{"type":"string"},"description":"When set, only the listed parts are returned in a combined response. Mutually exclusive with part/offset/limit."},"offset":{"type":"integer"},"limit":{"type":"integer"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
+  {"name":"genexus_edit","description":"Edit source/metadata. name or targets (mutually exclusive). Use dryRun=true with mode=patch first. Returns post_state.diff (unified diff) by default; verbose=true adds slices (±15 lines); return_post_state=false opts out.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"part":{"type":"string"},"mode":{"type":"string","enum":["full","patch","ops"]},"content":{"type":"string"},"ops":{"type":"array","items":{"type":"object","properties":{"op":{"type":"string"}},"required":["op"]}},"patch":{"description":"RFC 6902 JSON-Patch array, or legacy string replacement text.","anyOf":[{"type":"string"},{"type":"array","items":{"type":"object"}}]},"context":{"type":"string"},"operation":{"type":"string","enum":["Replace","Insert_After","Append"]},"expectedCount":{"type":"integer"},"dryRun":{"type":"boolean"},"verifyRollback":{"type":"boolean"},"targets":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"content":{"type":"string"}},"required":["name","content"]}},"type":{"type":"string"},"return_post_state":{"type":"boolean","description":"Set false to omit post_state.diff from the response (default true)."},"verbose":{"type":"boolean","description":"When true, adds slices (±15 lines around each hunk) to post_state (default false)."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
+  {"name":"genexus_inspect","description":"Snapshot of an object: metadata, variables, structure, signature. Use when you need raw object shape (parts, controls, events repertoire) without source text — for source/code use genexus_read instead.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"include":{"type":"array","items":{"type":"string","enum":["metadata","variables","signature","structure","parts","controls","events_repertoire"]}},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
+  {"name":"genexus_analyze","description":"Semantic analysis: impact, dependencies, complexity, naming, summary, explain. Use when you need cross-object reasoning (callers/callees, impact of a change, navigation paths) — don't use for raw source or single-object metadata (see genexus_read / genexus_inspect).","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"mode":{"type":"string","enum":["linter","navigation","hierarchy","impact","data_context","ui_context","pattern_metadata","summary","explain"]},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."},"code":{"type":"string","description":"Required when mode=explain."}},"required":["name","mode"]}},
+  {"name":"genexus_inject_context","description":"Inject SDT structures and Procedure signatures of called objects.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"recursive":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
+  {"name":"genexus_lifecycle","description":"Build/validate/index/poll. action=build is non-blocking when estimated_seconds>=20 — returns {job_id, status:running} and surfaces _meta.background_jobs on the next call. action=status accepts taskId OR job_id via target; wait_seconds>0 long-polls up to 25s.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["build","cancel","rebuild","reorg","validate","validate-kb","sync","index","status","result","snapshots-list","snapshots-restore"]},"target":{"type":"string","description":"Object name(s), taskId, job_id, or op:<operationId>."},"code":{"type":"string"},"limit":{"type":"integer"},"snapshotPath":{"type":"string"},"estimated_seconds":{"type":"integer","description":"Build: <20 forces sync fast-path (one turn); >=20 (default 60) goes async."},"wait_seconds":{"type":"integer","description":"Status: 0-25. >0 long-polls server-side until terminal or timeout."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
+  {"name":"genexus_forge","description":"Generate new code or structures from templates or translations.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["scaffold","translate","sample"]},"type":{"type":"string"},"name":{"type":"string"},"content":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
+  {"name":"genexus_test","description":"Execute native GeneXus tests (GXtest).","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name"]}},
+  {"name":"genexus_create_object","description":"Create a new GeneXus object in the active KB.","inputSchema":{"type":"object","properties":{"type":{"type":"string","description":"e.g. Procedure, Transaction, WebPanel, SDT."},"name":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["type","name"]}},
+  {"name":"genexus_logs","description":"Read worker_debug.log tail for error diagnosis or correlation.","inputSchema":{"type":"object","properties":{"lines":{"type":"integer"},"filterCorrelation":{"type":"string"},"grep":{"type":"string"}}}},
+  {"name":"genexus_worker_reload","description":"Hot-reload worker: copy new binaries and respawn.","inputSchema":{"type":"object","properties":{"sourceDir":{"type":"string","description":"Absolute path to freshly built bin/Release."}},"required":["sourceDir"]}},
+  {"name":"genexus_delete_object","description":"Delete an object from the KB. Irreversible — confirm=true required.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"},"confirm":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","confirm"]}},
+  {"name":"genexus_export_object","description":"Export a GeneXus object part to a text file on disk.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"outputPath":{"type":"string"},"part":{"type":"string"},"type":{"type":"string"},"overwrite":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","outputPath"]}},
+  {"name":"genexus_import_object","description":"Import a text file from disk into a GeneXus object part.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"inputPath":{"type":"string"},"part":{"type":"string"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","inputPath"]}},
+  {"name":"genexus_refactor","description":"Run GeneXus refactor: rename, extract procedure, or WWP condition set.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["RenameAttribute","RenameVariable","RenameObject","ExtractProcedure","WWPSetCondition"]},"target":{"type":"string","description":"Primary object or symbol to refactor."},"newName":{"type":"string"},"objectName":{"type":"string"},"code":{"type":"string"},"procedureName":{"type":"string"},"controlAttribute":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
+  {"name":"genexus_add_variable","description":"Add a variable to the Variables part of a GeneXus object.","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"varName":{"type":"string"},"typeName":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["name","varName"]}},
+  {"name":"genexus_format","description":"Format a GeneXus code snippet using worker rules.","inputSchema":{"type":"object","properties":{"code":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["code"]}},
+  {"name":"genexus_properties","description":"Read or update GeneXus object properties.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get","set"]},"name":{"type":"string"},"control":{"type":"string"},"propertyName":{"type":"string"},"value":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
+  {"name":"genexus_asset","description":"Find, read, or write binary assets inside the active KB.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["find","read","write"]},"path":{"type":"string"},"includeContent":{"type":"boolean"},"maxBytes":{"type":"integer"},"pattern":{"type":"string"},"relativeRoot":{"type":"string"},"limit":{"type":"integer"},"contentBase64":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
+  {"name":"genexus_history","description":"List, read, save, or restore GeneXus object history snapshots.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","get_source","save","restore"]},"name":{"type":"string"},"versionId":{"type":"integer"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
+  {"name":"genexus_structure","description":"Read or update visual and logical structure of GeneXus objects.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get_visual","update_visual","get_indexes","get_logic"]},"name":{"type":"string"},"payload":{"type":"object","description":"Update payload for update_visual."},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}},
+  {"name":"genexus_layout","description":"Native SDK layout/WebForm operations: get_tree, set_property, find_controls, inspect_surface, scan_mutators.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["get_tree","set_property","find_controls","set_properties","inspect_surface","get_preview","scan_mutators","rename_printblock","add_printblock"]},"name":{"type":"string"},"target":{"type":"string","description":"Object name alias for backward compatibility."},"control":{"type":"string"},"propertyName":{"type":"string"},"value":{"type":"string"},"query":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"control":{"type":"string"},"propertyName":{"type":"string"},"value":{"type":"string"}},"required":["control","propertyName","value"]}},"limit":{"type":"integer"},"currentName":{"type":"string"},"newName":{"type":"string"},"printBlockName":{"type":"string"},"height":{"type":"integer"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action"]}},
+  {"name":"genexus_doc","description":"Generate structured docs (markdown wiki, sequence diagrams, health reports). Use when producing human-readable artifacts about an object or domain — don't use for programmatic analysis (see genexus_analyze) or source reading (see genexus_read).","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["wiki","visualize","health"]},"target":{"type":"string","description":"Object or domain name."}},"required":["action"]}},
+  {"name":"genexus_search_source","description":"Regex/semantic search across Procedure/DataProvider/WebPanel/Transaction source.","inputSchema":{"type":"object","properties":{"callee":{"type":"string","description":"Method/function name (qualified or unqualified)."},"argMatches":{"type":"object","description":"Positional arg index to expected literal text."},"pattern":{"type":"string"},"typeFilter":{"type":"string"},"scope":{"type":"array","items":{"type":"string"}},"maxResults":{"type":"integer"},"caseSensitive":{"type":"boolean"},"includeComments":{"type":"boolean"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}}}},
+  {"name":"genexus_kb","description":"Manage open KBs: list (with PID/RSS/idle), open (acquire Worker), close (release), set_default (persist alias to config.json).","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","open","close","set_default"]},"alias":{"type":"string","description":"KB alias (for open/close). For open, auto-generated from path basename if omitted."},"path":{"type":"string","description":"Absolute path to the KB (required for action=open if alias is not declared in config)."}},"required":["action"]}},
+  {"name":"genexus_sql","description":"SQL for a Transaction/Table (DDL) or a procedure For Each navigation.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["ddl","navigation"]},"name":{"type":"string"},"includeSubordinated":{"type":"boolean","description":"action=ddl only."},"levelNumber":{"type":"integer","description":"action=navigation only."},"type":{"type":"string"},"kb":{"type":"string","description":"Target KB (alias or path). Required when 2+ KBs are open."}},"required":["action","name"]}}
+]