genexus-mcp 2.1.7 → 2.3.0

package/publish/tool_definitions.json

@@ -1,1062 +1,31 @@
-[
-  {
-    "name": "genexus_whoami",
-    "description": "Returns the currently connected GeneXus context: active KB (name, path, validity), GeneXus installation (path, detected version, target major), MCP server version, and config source. Use this as your first call to confirm the AI is operating on the KB the user expects, especially when the user manages multiple KBs. Lightweight — does not require the worker.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {}
-    }
-  },
-  {
-    "name": "genexus_query",
-    "description": "Primary discovery tool. Start here to find objects and references before read/edit. Supports prefixes like 'usedby:Name', 'type:Type', 'description:Text', 'parent:FolderName', and 'parentPath:\"Module/Folder\"'. For token efficiency set limit and (optionally) fields/axiCompact. If it returns 'Index missing', run genexus_lifecycle(action='index') first.",
-    "inputSchema": {
-      "type": "object",
-        "properties": {
-          "query": {
-            "type": "string",
-            "description": "The search query."
-          },
-          "typeFilter": {
-            "type": "string",
-            "description": "Optional server-side type filter applied before ranking, such as 'Folder' or 'Module'."
-          },
-          "domainFilter": {
-            "type": "string",
-            "description": "Optional business domain filter applied before ranking."
-          },
-          "limit": {
-            "type": "integer",
-            "description": "Max results (default 50).",
-            "default": 50
-          }
-      },
-      "required": [
-        "query"
-      ]
-    }
-  },
-  {
-    "name": "genexus_list_objects",
-    "description": "Hierarchical object listing for navigation and pagination. Prefer parentPath over parent for disambiguation, and always pass limit/offset. Returns {count, total, offset, hasMore, nextOffset?, results[]}: feed `nextOffset` into the next call and stop when `hasMore` is false. Supports optional fields and axiCompact in MCP arguments.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "filter": {
-          "type": "string",
-          "description": "Optional partial name or comma-separated type filter."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "Max results (default 5000).",
-          "default": 5000
-        },
-        "offset": {
-          "type": "integer",
-          "description": "Pagination offset."
-        },
-        "parent": {
-          "type": "string",
-          "description": "Legacy immediate parent label filter."
-        },
-        "parentPath": {
-          "type": "string",
-          "description": "Canonical hierarchical parent path, for example 'ModuloA/Procs'."
-        },
-        "typeFilter": {
-          "type": "string",
-          "description": "Optional server-side type filter applied before returning results."
-        }
-      }
-    }
-  },
-  {
-    "name": "genexus_read",
-    "description": "Reads source/metadata parts. Use after discovery (query/list) and keep reads paginated with offset/limit. Supports parts like Source, Rules, Events, Layout, WebForm, PatternInstance, and PatternVirtual. Use 'name' for a single object, or 'targets' (plural) for batch reads. The two are mutually exclusive.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Single object name. Mutually exclusive with 'targets'."
-        },
-        "targets": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Plural form: list of object names for batch read. Mutually exclusive with 'name'."
-        },
-        "part": {
-          "type": "string",
-          "description": "Part (for example Source, Rules, Events, Layout, WebForm, PatternInstance).",
-          "default": "Source"
-        },
-        "offset": {
-          "type": "integer",
-          "description": "Start line for pagination."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "Lines to read."
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type (e.g., 'Procedure', 'File') to resolve name collisions."
-        }
-      }
-    }
-  },
-  {
-    "name": "genexus_edit",
-    "description": "Mutation tool for source/metadata. Prefer mode='patch' with dryRun=true + expectedCount before applying changes. Use mode='full' only for intentional full overwrite. Use mode='ops' to apply a list of structural semantic operations (set_attribute, add_attribute, remove_attribute, add_rule, remove_rule, set_property) against a single part XML. Use 'name' for a single edit, or 'targets' (plural) for batch edits across one or many objects. The two are mutually exclusive.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "part": {
-          "type": "string",
-          "description": "Part name (for example Source, Rules, Layout, WebForm, PatternInstance).",
-          "default": "Source"
-        },
-        "mode": {
-          "type": "string",
-          "enum": [
-            "full",
-            "patch",
-            "ops"
-          ],
-          "description": "Edit mode."
-        },
-        "content": {
-          "type": "string",
-          "description": "New code or patch content."
-        },
-        "ops": {
-          "type": "array",
-          "description": "For mode='ops': list of semantic operations applied to the resolved part XML.",
-          "items": {
-            "type": "object",
-            "properties": {
-              "op": {
-                "type": "string",
-                "description": "Operation name (set_attribute, add_attribute, remove_attribute, add_rule, remove_rule, set_property)."
-              }
-            },
-            "required": [
-              "op"
-            ]
-          }
-        },
-        "patch": {
-          "oneOf": [
-            { "type": "string", "description": "legacy text patch (passed to PatchService)" },
-            {
-              "type": "array",
-              "description": "JSON-Patch RFC 6902 ops applied over canonical JSON",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "op": { "type": "string", "description": "Operation name (add, remove, replace, test)." },
-                  "path": { "type": "string", "description": "JSON Pointer (RFC 6901) to the target location." },
-                  "value": { "description": "Value for add/replace/test ops." }
-                },
-                "required": ["op", "path"]
-              }
-            }
-          ],
-          "description": "string = legacy text patch; array = JSON-Patch (RFC 6902). Used when mode='patch'."
-        },
-        "context": {
-          "type": "string",
-          "description": "For patch mode: The exact text (old_string) to replace."
-        },
-        "operation": {
-          "type": "string",
-          "enum": [
-            "Replace",
-            "Insert_After",
-            "Append"
-          ],
-          "description": "For patch mode: Operation to perform."
-        },
-        "expectedCount": {
-          "type": "integer",
-          "description": "For patch mode: expected number of matching context blocks (default 1).",
-          "default": 1
-        },
-        "dryRun": {
-          "type": "boolean",
-          "description": "For patch mode: validates and computes patch result without persisting changes.",
-          "default": false
-        },
-        "verifyRollback": {
-          "type": "boolean",
-          "description": "For patch mode: applies the patch, verifies persisted content, then automatically restores the original content and verifies the rollback.",
-          "default": false
-        },
-        "targets": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "name": {
-                "type": "string",
-                "description": "Object name for this target."
-              },
-              "part": {
-                "type": "string"
-              },
-              "mode": {
-                "type": "string",
-                "enum": [
-                  "full",
-                  "patch"
-                ]
-              },
-              "content": {
-                "type": "string"
-              },
-              "context": {
-                "type": "string"
-              },
-              "operation": {
-                "type": "string",
-                "enum": [
-                  "Replace",
-                  "Insert_After",
-                  "Append"
-                ]
-              },
-              "expectedCount": {
-                "type": "integer",
-                "description": "For patch mode: expected number of matching context blocks.",
-                "default": 1
-              },
-              "dryRun": {
-                "type": "boolean",
-                "description": "For patch mode: validates patch without persisting.",
-                "default": false
-              },
-              "verifyRollback": {
-                "type": "boolean",
-                "description": "For patch mode: applies change, verifies persistence, and automatically rolls back to original content.",
-                "default": false
-              }
-            },
-            "required": [
-              "name",
-              "content"
-            ]
-          },
-          "description": "Plural form: list of edit requests across one or many objects. Mutually exclusive with 'name'."
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to resolve name collisions."
-        }
-      }
-    }
-  },
-  {
-    "name": "genexus_inspect",
-    "description": "One-call snapshot of an object: metadata + variables + structure + signature. Use when you need a quick overview of an object you already found (typical second call after genexus_query). DON'T use to get full source — use genexus_read('Source') instead. DON'T use to change properties — use genexus_properties or genexus_edit.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "include": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "enum": [
-              "metadata",
-              "variables",
-              "signature",
-              "structure",
-              "parts",
-              "controls",
-              "events_repertoire"
-            ]
-          },
-          "description": "Specific parts to include (defaults to all). Use 'controls' or 'events_repertoire' to list WebForm controls and the events each one accepts."
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to resolve name collisions."
-        }
-      },
-      "required": [
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_analyze",
-    "description": "Deep semantic analysis engines (impact analysis, dependencies, cyclomatic complexity, naming conventions, dead code). Use when the user asks 'what depends on X', 'is this safe to delete', 'show me complexity', or similar diagnostic questions across the KB. DON'T use to read source (genexus_read), to explain a single snippet (genexus_explain_code), or to summarize one object (genexus_summarize).",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "mode": {
-          "type": "string",
-          "enum": [
-            "linter",
-            "navigation",
-            "hierarchy",
-            "impact",
-            "data_context",
-            "ui_context",
-            "pattern_metadata"
-          ],
-          "description": "The type of analysis to perform."
-        }
-      },
-      "required": [
-        "name",
-        "mode"
-      ]
-    }
-  },
-  {
-    "name": "genexus_summarize",
-    "description": "Token-efficient natural-language summary of a single object (purpose, inputs, outputs, key logic). Use when the user needs a quick understanding without reading source, or before deciding whether to genexus_read the full source. DON'T use for KB-wide overviews (use genexus_query/genexus_analyze) or when the user explicitly asks for source code (use genexus_read).",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        }
-      },
-      "required": [
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_inject_context",
-    "description": "Automates dependency discovery. Injects SDT structures and Procedure signatures of called objects into context.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "recursive": {
-          "type": "boolean",
-          "description": "Whether to discover dependencies of dependencies (default: false).",
-          "default": false
-        }
-      },
-      "required": [
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_lifecycle",
-    "description": "Lifecycle and long-running operation control. Use for build/validate/index and for polling timed-out operations via action='status' or action='result' with target='op:<operationId>'.\n\nBATCH BUILD (\"Build With These Only\") — action='build' accepts MULTIPLE object names in 'target' as a comma- or semicolon-separated list (e.g. target='SalvarRegProfAluno,ListaAtiCPAlunoUniGra'). All listed objects are compiled inside a SINGLE MSBuild + OpenKnowledgeBase cycle, saving ~30s of KB-open overhead per object compared to N separate build calls. ALWAYS prefer the batch form when you have 2+ related objects to build (e.g. a Procedure plus its callers). The response includes 'targets' (the parsed list) and status reports 'TargetsTotal'/'TargetsDone'.\n\nPROGRESS — action='build' returns a taskId immediately; poll with action='status' target=<taskId> to see real-time phase ('OpeningKB' → 'Specifying' → 'Generating' → 'Compiling' → 'Done'), current object being processed, errorCount/warningCount, elapsed seconds, and last lines emitted. Use action='cancel' target=<taskId> to abort a runaway build.\n\nCALLERS — a single-object action='build' does NOT cascade to callers: when you build a Procedure (or any reusable object), the DLLs of WebPanels/Procedures/Transactions/DPs that CALL it are NOT regenerated, so the produced C# stays linked against the old version until you build the callers too. The build response includes a 'callersToAlsoBuild' list (when an index is available); pass them ALL plus the target itself as a comma-separated 'target' to the next build call (batch form) — never serialise them into separate build calls when you can batch.\n\nNEVER suggest action='rebuild' (Rebuild All) — full rebuilds take HOURS on real KBs and block the developer; only the user themselves should ever invoke 'rebuild'.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "build",
-            "cancel",
-            "rebuild",
-            "reorg",
-            "validate",
-            "validate-kb",
-            "sync",
-            "index",
-            "status",
-            "result",
-            "snapshots-list",
-            "snapshots-restore"
-          ],
-          "description": "Lifecycle action. 'validate-kb' scans PatternInstance conditions for unknown attribute references. 'snapshots-list'/'snapshots-restore' manage pre-write pattern snapshots."
-        },
-        "target": {
-          "type": "string",
-          "description": "Context depends on action. action='build': one object name, OR a comma/semicolon-separated list of object names for batch 'Build With These Only' in a single MSBuild cycle (e.g. 'ProcA,WebPanelB,TransactionC'). action='status'|'cancel': the taskId returned by a prior 'build' call. action='result' with op:<operationId>: gateway operation tracking. Other actions take a single environment/object name."
-        },
-        "code": {
-          "type": "string",
-          "description": "For validation: the code to check."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "For validate-kb: max objects to scan (0 = unlimited)."
-        },
-        "snapshotPath": {
-          "type": "string",
-          "description": "For snapshots-restore: full path returned by snapshots-list."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_open_kb",
-    "description": "Opens an existing GeneXus Knowledge Base for the active MCP session.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "path": {
-          "type": "string",
-          "description": "Absolute path to the GeneXus Knowledge Base directory."
-        }
-      },
-      "required": [
-        "path"
-      ]
-    }
-  },
-  {
-    "name": "genexus_forge",
-    "description": "Generation of new code and structures from templates or translations.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "scaffold",
-            "translate",
-            "sample"
-          ],
-          "description": "Generation action."
-        },
-        "type": {
-          "type": "string",
-          "description": "Object type (e.g. Prc, Trn)."
-        },
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "content": {
-          "type": "string",
-          "description": "Initial code or target language."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_test",
-    "description": "Execution of native GeneXus tests (GXtest).",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Test object name."
-        }
-      },
-      "required": [
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_get_sql",
-    "description": "Returns the SQL DDL (CREATE TABLE) for a specific Transaction or Table object. For Transactions with Levels, always lists subordinated tables; set includeSubordinated=true to also return their full DDL.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "The name of the Transaction or Table."
-        },
-        "includeSubordinated": {
-          "type": "boolean",
-          "description": "When true and the target is a Transaction with Levels, include full CREATE TABLE DDL for each subordinated physical table in subordinatedDDL. Defaults to false.",
-          "default": false
-        }
-      },
-      "required": [
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_create_object",
-    "description": "Creates a new GeneXus object in the active Knowledge Base.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "description": "Object type such as Procedure, Transaction, WebPanel, SDT, or DataProvider."
-        },
-        "name": {
-          "type": "string",
-          "description": "New object name."
-        }
-      },
-      "required": [
-        "type",
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_logs",
-    "description": "Reads the worker_debug.log file from the active worker. Useful for diagnosing 'Erro' responses, validating that fixes deployed, or correlating a specific call (correlationId) with internal logging. Default returns the last 50 lines.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "lines": {
-          "type": "integer",
-          "description": "Tail size (1-500). Default 50."
-        },
-        "filterCorrelation": {
-          "type": "string",
-          "description": "Optional substring (e.g. correlationId) to filter log lines."
-        },
-        "grep": {
-          "type": "string",
-          "description": "Optional regex (case-insensitive) applied before tailing."
-        }
-      }
-    }
-  },
-  {
-    "name": "genexus_worker_reload",
-    "description": "Hot-reloads the worker process: copies new binaries from sourceDir into the publish path (after worker exits) and triggers gateway respawn. Use after rebuilding GxMcp.Worker so subsequent MCP calls run the new code without closing Claude Code. Next call after reload may take a few seconds.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "sourceDir": {
-          "type": "string",
-          "description": "Absolute path to the freshly built bin/Release folder (e.g. C:/.../src/GxMcp.Worker/bin/Release)."
-        }
-      },
-      "required": [
-        "sourceDir"
-      ]
-    }
-  },
-  {
-    "name": "genexus_delete_object",
-    "description": "Deletes an object from the active Knowledge Base. Irreversible — requires confirm=true.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name to delete."
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to disambiguate (e.g., 'Procedure', 'SDT')."
-        },
-        "confirm": {
-          "type": "boolean",
-          "description": "Must be true to actually delete. Default false (returns error)."
-        }
-      },
-      "required": [
-        "name",
-        "confirm"
-      ]
-    }
-  },
-  {
-    "name": "genexus_export_object",
-    "description": "Exports a GeneXus object part to a text file on disk.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "outputPath": {
-          "type": "string",
-          "description": "Absolute or relative output file path."
-        },
-        "part": {
-          "type": "string",
-          "description": "Part to export, such as Source, Rules, Events, Structure, Layout, WebForm, or PatternInstance.",
-          "default": "Source"
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to resolve name collisions."
-        },
-        "overwrite": {
-          "type": "boolean",
-          "description": "Whether to overwrite an existing file.",
-          "default": false
-        }
-      },
-      "required": [
-        "name",
-        "outputPath"
-      ]
-    }
-  },
-  {
-    "name": "genexus_import_object",
-    "description": "Imports a text file from disk into a GeneXus object part.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "inputPath": {
-          "type": "string",
-          "description": "Absolute or relative input file path."
-        },
-        "part": {
-          "type": "string",
-          "description": "Part to import into, such as Source, Rules, Events, Structure, Layout, WebForm, or PatternInstance.",
-          "default": "Source"
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to resolve name collisions."
-        }
-      },
-      "required": [
-        "name",
-        "inputPath"
-      ]
-    }
-  },
-  {
-    "name": "genexus_refactor",
-    "description": "Runs supported GeneXus refactor operations such as renaming, procedure extraction, and WorkWithPlus condition setting.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "RenameAttribute",
-            "RenameVariable",
-            "RenameObject",
-            "ExtractProcedure",
-            "WWPSetCondition"
-          ],
-          "description": "Refactor action."
-        },
-        "target": {
-          "type": "string",
-          "description": "Primary target object or symbol."
-        },
-        "newName": {
-          "type": "string",
-          "description": "New name for rename actions."
-        },
-        "objectName": {
-          "type": "string",
-          "description": "Object name that owns the refactor operation. Required for variable rename and extraction."
-        },
-        "code": {
-          "type": "string",
-          "description": "Code block to extract for ExtractProcedure."
-        },
-        "procedureName": {
-          "type": "string",
-          "description": "New procedure name for ExtractProcedure."
-        },
-        "controlAttribute": {
-          "type": "string",
-          "description": "For WWPSetCondition: gridAttribute attribute local-name (e.g., 'DocCod')."
-        },
-        "value": {
-          "type": "string",
-          "description": "For WWPSetCondition: new conditions string (e.g., 'DocTipOri = 24;'). Empty clears."
-        },
-        "type": {
-          "type": "string",
-          "description": "Optional object type to disambiguate (e.g., 'Transaction')."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_add_variable",
-    "description": "Adds a variable to the Variables part of a GeneXus object.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "varName": {
-          "type": "string",
-          "description": "Variable name, with or without '&'."
-        },
-        "typeName": {
-          "type": "string",
-          "description": "Optional variable type or domain."
-        }
-      },
-      "required": [
-        "name",
-        "varName"
-      ]
-    }
-  },
-  {
-    "name": "genexus_explain_code",
-    "description": "Runs code explanation or auto-fix style analysis for a GeneXus object snippet.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "code": {
-          "type": "string",
-          "description": "Code snippet or serialized analysis payload."
-        }
-      },
-      "required": [
-        "name",
-        "code"
-      ]
-    }
-  },
-  {
-    "name": "genexus_format",
-    "description": "Formats a GeneXus code snippet using the worker formatting rules.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "code": {
-          "type": "string",
-          "description": "GeneXus code to format."
-        }
-      },
-      "required": [
-        "code"
-      ]
-    }
-  },
-  {
-    "name": "genexus_properties",
-    "description": "Reads or updates GeneXus object properties.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "get",
-            "set"
-          ],
-          "description": "Property operation."
-        },
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "control": {
-          "type": "string",
-          "description": "Optional control name for UI properties."
-        },
-        "propertyName": {
-          "type": "string",
-          "description": "Property name for set operations."
-        },
-        "value": {
-          "type": "string",
-          "description": "Property value for set operations."
-        }
-      },
-      "required": [
-        "action",
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_asset",
-    "description": "Finds, reads, or writes binary assets stored inside the active Knowledge Base, including report templates such as .xlsx files.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "find",
-            "read",
-            "write"
-          ],
-          "description": "Asset operation."
-        },
-        "path": {
-          "type": "string",
-          "description": "Relative or absolute path inside the KB for read/write operations."
-        },
-        "includeContent": {
-          "type": "boolean",
-          "description": "For read operations, include Base64 file content. Defaults to false so large binary payloads do not flood the MCP context."
-        },
-        "maxBytes": {
-          "type": "integer",
-          "description": "For read operations with includeContent=true, maximum file size allowed before the worker returns a size error.",
-          "default": 131072
-        },
-        "pattern": {
-          "type": "string",
-          "description": "File glob pattern for find operations, for example '*.xlsx'."
-        },
-        "relativeRoot": {
-          "type": "string",
-          "description": "Optional relative folder inside the KB to scope find operations."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "Maximum number of files returned by find.",
-          "default": 20
-        },
-        "contentBase64": {
-          "type": "string",
-          "description": "Base64-encoded asset content for write operations."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_history",
-    "description": "Lists, reads, saves, or restores GeneXus object history snapshots.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "list",
-            "get_source",
-            "save",
-            "restore"
-          ],
-          "description": "History operation."
-        },
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "versionId": {
-          "type": "integer",
-          "description": "Version identifier for get_source."
-        }
-      },
-      "required": [
-        "action",
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_structure",
-    "description": "Reads or updates visual and logical structure information for GeneXus objects.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "get_visual",
-            "update_visual",
-            "get_indexes",
-            "get_logic"
-          ],
-          "description": "Structure operation."
-        },
-        "name": {
-          "type": "string",
-          "description": "Object name."
-        },
-        "payload": {
-          "type": "object",
-          "description": "Payload for update_visual."
-        }
-      },
-      "required": [
-        "action",
-        "name"
-      ]
-    }
-  },
-  {
-    "name": "genexus_layout",
-    "description": "Native SDK layout/WebForm operations. Use get_tree for deterministic node discovery, set_property for direct visual metadata updates, inspect_surface for structural introspection, and scan_mutators for deep reflective discovery of persistent mutation endpoints.",
-    "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"
-          ],
-          "description": "Layout operation."
-        },
-        "name": {
-          "type": "string",
-          "description": "Object name. Preferred field."
-        },
-        "target": {
-          "type": "string",
-          "description": "Object name alias for backward compatibility with older prompts/clients."
-        },
-        "control": {
-          "type": "string",
-          "description": "Control identifier (ControlName/InternalName)."
-        },
-        "propertyName": {
-          "type": "string",
-          "description": "Visual property to mutate (for example Caption, Class, Visible, X, Y, Width, Height, ForeColor, BackColor, BorderColor)."
-        },
-        "value": {
-          "type": "string",
-          "description": "New value for set_property. For colors, prefer palette names (Black, Blue, Red, Transparent) or RGB token format (e.g. 0; 0; 0|)."
-        },
-        "query": {
-          "type": "string",
-          "description": "Search term for find_controls."
-        },
-        "changes": {
-          "type": "array",
-          "description": "Batch changes for set_properties.",
-          "items": {
-            "type": "object",
-            "properties": {
-              "control": {
-                "type": "string"
-              },
-              "propertyName": {
-                "type": "string"
-              },
-              "value": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "control",
-              "propertyName",
-              "value"
-            ]
-          }
-        },
-        "limit": {
-          "type": "integer",
-          "description": "Maximum nodes for get_tree/find_controls.",
-          "default": 500
-        },
-        "currentName": {
-          "type": "string",
-          "description": "Current print block name for rename_printblock."
-        },
-        "newName": {
-          "type": "string",
-          "description": "New print block name for rename_printblock."
-        },
-        "printBlockName": {
-          "type": "string",
-          "description": "Print block name for add_printblock."
-        },
-        "height": {
-          "type": "integer",
-          "description": "Optional band height for add_printblock."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_doc",
-    "description": "Generates structured documentation artifacts for objects or modules (markdown, sequence diagrams, API contracts) — meant to produce shareable docs. Use when the user asks 'document this', 'generate readme', or wants persistent documentation. DON'T use for ad-hoc explanations (use genexus_explain_code or genexus_summarize) or for raw source (use genexus_read).",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "wiki",
-            "visualize",
-            "health"
-          ],
-          "description": "Documentation action."
-        },
-        "target": {
-          "type": "string",
-          "description": "Object or domain name."
-        }
-      },
-      "required": [
-        "action"
-      ]
-    }
-  },
-  {
-    "name": "genexus_search_source",
-    "description": "Semantic and regex search across Procedure/DataProvider/WebPanel/Transaction source code. Provide 'callee' to match call expressions by name (qualified like 'DPParametros.Udp' or unqualified like 'Udp'), optionally 'argMatches' (positional, e.g. {\"0\":\"373\"}) to constrain by literal args. Or provide 'pattern' as a regex. Both can combine.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "callee": { "type": "string", "description": "Method/function name to match. Qualified ('DPParametros.Udp') matches exactly; unqualified ('Udp') matches the trailing segment of any qualified callee." },
-        "argMatches": { "type": "object", "description": "Map of positional arg index (as string) to expected literal text. Quotes are normalized." },
-        "pattern": { "type": "string", "description": "Regex applied to lines. If both callee and pattern are given, line must also match pattern." },
-        "typeFilter": { "type": "string", "description": "Procedure | DataProvider | WebPanel | Transaction (default: all four)." },
-        "scope": { "type": "array", "items": { "type": "string" }, "description": "Parts to search: 'source' (default), 'rules', 'conditions', 'events'." },
-        "maxResults": { "type": "integer", "description": "Cap (default 50).", "default": 50 },
-        "caseSensitive": { "type": "boolean", "description": "Apply regex case-sensitive (default false).", "default": false },
-        "includeComments": { "type": "boolean", "description": "Include calls/text inside comments (default false).", "default": false }
-      }
-    }
-  },
-  {
-    "name": "genexus_get_sql_for_navigation",
-    "description": "Generates SQL from a procedure/data-provider's resolved For Each navigation. Returns one SELECT per Level with bind-parameter placeholders (:VarName) where the source uses &Vars. Useful for cross-environment comparison (paste the SQL into a prod DBA console). Warnings field reports levels where OptimizedWhere couldn't be translated.",
-    "inputSchema": {
-      "type": "object",
-      "properties": {
-        "name": { "type": "string", "description": "Procedure or DataProvider name." },
-        "levelNumber": { "type": "integer", "description": "Optional: emit SQL only for the given Level number (1-based)." },
-        "type": { "type": "string", "description": "Optional type filter." }
-      },
-      "required": ["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:.","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"]}}
+]