Genexus18mcp MCP Server

GeneXus 18 MCP server — read, edit, and analyze GeneXus knowledge base objects (transactions, web panels, procedures, SDTs) directly from Claude

Local serverstdioGo

What is the Genexus18mcp MCP server?

If you already use Genexus18mcp, the genexus18mcp mcp server is the piece that lets your assistant work with it directly. 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.

What the server does

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.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Non — admin shell** → %LOCALAPPDATA%\Programs\GenexusMCP\
  • genexus_whoami — KB context, version, worker/index/database health, self-update check, next-step hints
  • genexus_doctor — connection + install + cache health check
  • genexus_recipe — named playbooks / self-extending macros
  • genexus_telemetry — observability (metrics, latency, errors)
  • genexus_query — object search (prefixes name:, type:, usedby:, parent:, …)
  • genexus_list_objects — paginated object listing with aggregates
  • genexus_read — read any part of an object (source, structure, rules, events, docs, pattern XML, …)
  • genexus_inspect — one-shot object snapshot (metadata, variables, structure, signature, callers)
  • genexus_search_source — regex/semantic search across Procedure/DataProvider/WebPanel/Transaction source
  • genexus_navigation — the IDE "View Navigation" report
  • genexus_edit — edit any object part; modes full / patch / ops

Credentials and setup notes

Configuration is passed through the environment: MY_KB_PATH, MY_GENEXUS_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Before you start, make sure you have: - ✅ 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 if missing - ✅ **An

Installation

Installation goes through your MCP client rather than a global install: point it at genexus-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Where it fits

Among the database access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Genexus18mcp's toolset — Non, genexus_whoami, genexus_doctor and 11 more — is a fair guide to whether it matches your workflow. It is maintained by lennix1337; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Genexus18mcp.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
Nonadmin shell** → %LOCALAPPDATA%\Programs\GenexusMCP\
genexus_whoamiKB context, version, worker/index/database health, self-update check, next-step hints
genexus_doctorconnection + install + cache health check
genexus_recipenamed playbooks / self-extending macros
genexus_telemetryobservability (metrics, latency, errors)
genexus_queryobject search (prefixes name:, type:, usedby:, parent:, …)
genexus_list_objectspaginated object listing with aggregates
genexus_readread any part of an object (source, structure, rules, events, docs, pattern XML, …)
genexus_inspectone-shot object snapshot (metadata, variables, structure, signature, callers)
genexus_search_sourceregex/semantic search across Procedure/DataProvider/WebPanel/Transaction source
genexus_navigationthe IDE "View Navigation" report
genexus_editedit any object part; modes full / patch / ops
genexus_edit_and_buildedit + optional specification + rebuild callers in one call, with compensating rollback on validation failure
genexus_edit_formsemantic WebForm edits

How to install the Genexus18mcp MCP server

{
  "mcpServers": {
    "genexus18mcp": {
      "command": "npx",
      "args": ["-y", "genexus-mcp"],
      "env": {
        "MY_KB_PATH": "your-value",
        "MY_GENEXUS_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Before you start, make sure you have: - ✅ 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 if missing - ✅ **An

VariableDescriptionRequired
MY_KB_PATHFilesystem location the server is allowed to use.Optional
MY_GENEXUS_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Genexus18mcp to Non.
  • Use Genexus18mcp to genexus whoami.
  • Use Genexus18mcp to genexus doctor.

Frequently asked questions

It connects Genexus18mcp to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Non, genexus_whoami, genexus_doctor, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Genexus18mcp directly.