Genexus MCP

GeneXus MCP Serverlets AI agents — Claude Desktop, Claude Code, Cursor, Antigravity, and any MCP-compatible client — read, edit, analyze, and refactor objects inside a GeneXus 18 Knowledge Base. It talks to thenative GeneXus SDK, so the agent works with therealKB, not a copy or a parsed approximation.

In practice: you point the MCP at your KB, then ask your AI assistant things like"list all transactions with attribute CustomerId","add a rule to the Order transaction that validates the total", or"refactor this procedure to use the new SDT"— and it does it.

It works through thenative GeneXus SDK— the same code paths the IDE uses — so edits are real and validated, not text hacks on KB files.

You donotneed to clone this repo or install anything globally —npxhandles it.

Never used a terminal before?PressWin+R, typepowershell, hit Enter. That's your terminal.

Before running the installer, note these down:
- GeneXus install folder— whereGeneXus.exelives. UsuallyC:\Program Files (x86)\GeneXus\GeneXus18.
- Your KB folder— the root folder of your Knowledge Base (contains the.gxfile and subfolders likeModel/,WebSpa/).

Not sure where your KB lives? Open it in GeneXus and check the title bar, or look inFile → Recent.

Open a terminal and run, replacing the paths withyourKB folder andyourGeneXus install:

npx genexus-mcp@latest init --kb "C:\KBs\YourKB" --gx "C:\Program Files (x86)\GeneXus\GeneXus18"

Prefer the wizard? Runnpx genexus-mcp@latest init --interactiveand answer the prompts.

What you'll see (takes ~30 seconds first time, faster on re-runs):
- npxdownloads the package.
- The installer verifies the paths exist and GeneXus is present.
- Itauto-detectswhich AI clients you have installed and adds the MCP config to each one.
- Prints a JSON snippet at the end — keep it in case you need to configure a client manually.
- Finishes with🎉 You are all set!.

Step 2 — Register the MCP in your AI client

Step 3 — Restart your AI client, then test

This part trips most people:fully closeyour 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.
- OpenCode: fully quit and reopen it so it reloadsopencode.json/opencode.jsonc.
- Gemini CLI / Codex CLI: start a new process or session.

"Using the GeneXus MCP, list the first 5 objects in my KB and show name + type."

- The AI invokes thegenexus_list_objectstool (some UIs show "calling tool…").
- A few seconds later, you get a list of objects from your KB.