genexus-mcp 1.1.0

package/publish/tool_definitions.json

@@ -0,0 +1,899 @@
+[
+  {
+    "name": "genexus_query",
+    "description": "Semantic search for objects, references, and snippets. Supports prefixes like 'usedby:Name', 'type:Type', 'description:Text', 'parent:FolderName', and 'parentPath:\"Module/Folder\"'. NOTE: If this tool returns 'Index missing', you MUST run genexus_lifecycle(action='index') before searching again.",
+    "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": "Lists objects and structural containers from the KB. Supports legacy parent-name filtering and canonical hierarchical filtering with 'parentPath' for module/folder disambiguation.",
+    "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 code or editable metadata from object parts such as Source, Rules, Events, Layout, WebForm, and WorkWithPlus PatternInstance. Source-first for MCP usage and supports pagination.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Object 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."
+        }
+      },
+      "required": [
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "genexus_batch_read",
+    "description": "Reads source code from multiple objects in a single call. Drastically improves context-gathering speed.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Object name."
+              },
+              "part": {
+                "type": "string",
+                "description": "Part (Source, Rules, Events).",
+                "default": "Source"
+              }
+            },
+            "required": [
+              "name"
+            ]
+          }
+        }
+      },
+      "required": [
+        "items"
+      ]
+    }
+  },
+  {
+    "name": "genexus_edit",
+    "description": "Updates object source code or editable metadata parts. Use 'mode=full' for complete overwrite or 'mode=patch' for surgical changes.",
+    "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"
+          ],
+          "description": "Edit mode."
+        },
+        "content": {
+          "type": "string",
+          "description": "New code or patch content."
+        },
+        "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
+        },
+        "changes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "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
+              }
+            },
+            "required": [
+              "content"
+            ]
+          },
+          "description": "Batch of changes to apply to this object."
+        },
+        "type": {
+          "type": "string",
+          "description": "Optional object type to resolve name collisions."
+        }
+      },
+      "required": [
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "genexus_batch_edit",
+    "description": "Applies edits across multiple objects in a single call. Each item specifies a target object and an array of changes (patch or full). More efficient than multiple genexus_edit calls.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Target object name."
+              },
+              "changes": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "part": {
+                      "type": "string",
+                      "description": "Part name (Source, Rules, Events).",
+                      "default": "Source"
+                    },
+                    "mode": {
+                      "type": "string",
+                      "enum": [
+                        "full",
+                        "patch"
+                      ],
+                      "description": "Edit mode.",
+                      "default": "patch"
+                    },
+                    "content": {
+                      "type": "string",
+                      "description": "New code or patch content."
+                    },
+                    "context": {
+                      "type": "string",
+                      "description": "For patch mode: exact text to replace."
+                    },
+                    "operation": {
+                      "type": "string",
+                      "enum": [
+                        "Replace",
+                        "Insert_After",
+                        "Append"
+                      ],
+                      "description": "Patch operation.",
+                      "default": "Replace"
+                    },
+                    "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
+                    }
+                  },
+                  "required": [
+                    "content"
+                  ]
+                },
+                "description": "Changes to apply to this object."
+              }
+            },
+            "required": [
+              "name",
+              "changes"
+            ]
+          },
+          "description": "Array of objects to edit, each with its own changes."
+        }
+      },
+      "required": [
+        "items"
+      ]
+    }
+  },
+  {
+    "name": "genexus_inspect",
+    "description": "Comprehensive object inspection. Returns metadata, variables, structure, and signature in a single call.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Object name."
+        },
+        "include": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "metadata",
+              "variables",
+              "signature",
+              "structure"
+            ]
+          },
+          "description": "Specific parts to include (defaults to all)."
+        },
+        "type": {
+          "type": "string",
+          "description": "Optional object type to resolve name collisions."
+        }
+      },
+      "required": [
+        "name"
+      ]
+    }
+  },
+  {
+    "name": "genexus_analyze",
+    "description": "Deep semantic and structural analysis using various specialized engines.",
+    "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": "Creates a semantically compressed summary of a GeneXus object to save tokens.",
+    "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": "KB state management: build, validate, sync, and indexing. For long-running MCP operations, query action='status' or action='result' with target='op:<operationId>'.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "build",
+            "rebuild",
+            "reorg",
+            "validate",
+            "sync",
+            "index",
+            "status",
+            "result"
+          ],
+          "description": "Lifecycle action."
+        },
+        "target": {
+          "type": "string",
+          "description": "Object or environment name, taskId for build status, or op:<operationId> for gateway operation tracking."
+        },
+        "code": {
+          "type": "string",
+          "description": "For validation: the code to check."
+        }
+      },
+      "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.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the Transaction or Table."
+        }
+      },
+      "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_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 and procedure extraction.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "RenameAttribute",
+            "RenameVariable",
+            "RenameObject",
+            "ExtractProcedure"
+          ],
+          "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."
+        }
+      },
+      "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_doc",
+    "description": "Knowledge extraction and documentation generation.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "wiki",
+            "visualize",
+            "health"
+          ],
+          "description": "Documentation action."
+        },
+        "target": {
+          "type": "string",
+          "description": "Object or domain name."
+        }
+      },
+      "required": [
+        "action"
+      ]
+    }
+  }
+]