genexus-mcp 2.5.3 → 2.6.0

package/README.md

@@ -7,6 +7,7 @@
 [![MCP Badge](https://lobehub.com/badge/mcp/lennix1337-genexus18mcp)](https://lobehub.com/mcp/lennix1337-genexus18mcp)
 
 > **¿Hablás español?** → [Guía de inicio en español](docs/GETTING_STARTED.es.md)
+> **Fala português?** → [Guia de início em português](docs/GETTING_STARTED.pt-br.md)
 > **Stuck?** → [Troubleshooting guide](TROUBLESHOOTING.md)
 
 ---
@@ -21,17 +22,28 @@ In practice: you point the MCP at your KB, then ask your AI assistant things lik
 
 Before you start, make sure you have:
 
-- ✅ **Windows** (GeneXus is Windows-only — this MCP runs on Windows)
-- ✅ **GeneXus 18** installed locally (usually `C:\Program Files (x86)\GeneXus\GeneXus18`)
-- ✅ **A GeneXus 18 Knowledge Base** opened at least once in the IDE (so it has been built/initialized)
-- ✅ **Node.js 18+** ([download](https://nodejs.org/))
+- ✅ **Windows** (GeneXus is Windows-only)
+- ✅ **GeneXus 18** installed locally (default path: `C:\Program Files (x86)\GeneXus\GeneXus18`)
+- ✅ **A GeneXus 18 Knowledge Base** opened at least once in the IDE (so it's initialized)
+- ✅ **Node.js 18+** — check with `node --version` in a terminal; install from [nodejs.org](https://nodejs.org/) if missing
 - ✅ **An MCP-compatible AI client** — [Claude Desktop](https://claude.ai/download), [Claude Code](https://claude.com/claude-code), Cursor, Antigravity, etc.
 
 You do **not** need to clone this repo or install anything globally — `npx` handles it.
 
+**Never used a terminal before?** Press `Win+R`, type `powershell`, hit Enter. That's your terminal.
+
 ---
 
-## Quickstart (3 steps)
+## Quickstart (3 steps, ~5 minutes)
+
+### Find your two paths first
+
+Before running the installer, note these down:
+
+1. **GeneXus install folder** — where `GeneXus.exe` lives. Usually `C:\Program Files (x86)\GeneXus\GeneXus18`.
+2. **Your KB folder** — the root folder of your Knowledge Base (contains the `.gx` file and subfolders like `Model/`, `WebSpa/`).
+
+Not sure where your KB lives? Open it in GeneXus and check the title bar, or look in `File → Recent`.
 
 ### Step 1 — Run the installer
 
@@ -43,21 +55,38 @@ npx genexus-mcp@latest init --kb "C:\KBs\YourKB" --gx "C:\Program Files (x86)\Ge
 
 > Prefer the wizard? Run `npx genexus-mcp@latest init --interactive` and answer the prompts.
 
-When it finishes you should see `🎉 You are all set!` plus a JSON snippet for your AI client.
+What you'll see (takes ~30 seconds first time, faster on re-runs):
+
+1. `npx` downloads the package.
+2. The installer verifies the paths exist and GeneXus is present.
+3. It **auto-detects** which AI clients you have installed and adds the MCP config to each one.
+4. Prints a JSON snippet at the end — keep it in case you need to configure a client manually.
+5. Finishes with `🎉 You are all set!`.
 
 ### Step 2 — Register the MCP in your AI client
 
-The installer **auto-registers** the server with Claude Desktop, Claude Code, Cursor, and Antigravity when it detects them. If yours wasn't detected, copy the JSON snippet from Step 1 into your client's MCP config manually. See the [client setup guide](TROUBLESHOOTING.md#client-setup) if unsure where that file lives.
+Step 1 auto-registers with Claude Desktop, Claude Code, Cursor, and Antigravity when it detects them. If yours wasn't detected, copy the JSON snippet from Step 1 into your client's MCP config manually. See the [client setup guide](TROUBLESHOOTING.md#client-setup) if unsure where that file lives.
+
+### Step 3 — Restart your AI client, then test
+
+This part trips most people: **fully close** your AI client and reopen it. Not just the window — the whole process.
+
+- **Claude Desktop**: right-click the system-tray icon → **Quit**. Then launch it again. (Closing the window is not enough.)
+- **Claude Code**: end the session and start a fresh one.
+- **Cursor / Antigravity**: close all windows and reopen.
+
+Then paste this prompt:
 
-### Step 3 — Restart your AI client and test
+> *"Using the GeneXus MCP, list the first 5 objects in my KB and show name + type."*
 
-Fully close and reopen Claude / Cursor / etc. Then try this prompt:
+**What should happen:**
 
-> *"Using the GeneXus MCP, list the first 5 transactions in my KB and show their names."*
+- The AI invokes the `genexus_list_objects` tool (some UIs show "calling tool…").
+- A few seconds later, you get a list of objects from your KB.
 
 If you get a list back — **you're done**. Skip to [What can I ask the AI?](#what-can-i-ask-the-ai) for ideas.
 
-If something didn't work, go straight to [Troubleshooting](TROUBLESHOOTING.md) — most issues are covered there.
+If the AI says it doesn't have a GeneXus tool, or nothing happens, go to [Troubleshooting](TROUBLESHOOTING.md) — most issues are covered there.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "2.5.3",
+  "version": "2.6.0",
   "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

@@ -7,7 +7,7 @@
   "targets": {
     ".NETCoreApp,Version=v8.0": {},
     ".NETCoreApp,Version=v8.0/win-x64": {
-      "GxMcp.Gateway/2.5.3": {
+      "GxMcp.Gateway/2.6.0": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -66,7 +66,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/2.5.3": {
+    "GxMcp.Gateway/2.6.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/publish/tool_definitions.json

@@ -12,6 +12,7 @@
   {"name":"genexus_test","description":"Execute native GeneXus tests (GXtest).","inputSchema":{"type":"object","properties":{"name":{"type":"string"},"kb":{"type":"string","description":"Target KB. Required when 2+ 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. Required when 2+ 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_sdk_probe","description":"Scan loaded GeneXus SDK assemblies and dump a structured map of every public type, method, property to docs/sdk-probe/. Use when investigating new SDK surface or hunting for an entry point. Outputs raw.json + INDEX.md + generators.md.","inputSchema":{"type":"object","properties":{"outputDir":{"type":"string","description":"Optional absolute path. Defaults to <repo>/docs/sdk-probe/ or %TEMP%/gxmcp_sdk_probe/."}}}},
   {"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. Required when 2+ 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. Required when 2+ open."}},"required":["name","outputPath"]}},