# genexus

Connects AI clients to GeneXus Knowledge Bases to read, edit, and refactor objects. Works with modern SDKs and legacy installations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 39
- Author: lennix1337
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lennix1337/Genexus18MCP
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/genexus

## What it does

This MCP server communicates with Knowledge Base files using the actual GeneXus SDK rather than parsing text dumps. It treats GeneXus 18 as its primary target, while also providing native SDK support for GeneXus 16 and 17. Legacy editions like Evolution 1 through 3 and GeneXus 15 run through a runtime reflection adapter.

Classic GeneXus 8.0 and 9.0 setups rely on 32-bit GXPublic COM adapters. Because of that architecture, legacy 8 and 9 configurations only expose metadata, without source editing parity. When you point the configuration to another SDK or directory via `init`, restart the AI client process to reload schemas.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add genexus -- npx -y genexus-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add genexus -- npx -y genexus-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "genexus": {
            "command": "npx",
            "args": [
                "-y",
                "genexus-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "genexus": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "genexus-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add genexus npx -y genexus-mcp
```

## When to use it
- inspect attributes across Knowledge Base transactions
- append validation rules to transactions
- refactor legacy procedures to target modern SDTs
- verify installed SDK compatibility against `.gxw` files

## Example prompts
- List all transactions that contain the CustomerId attribute.
- Add a validation rule for the total field inside the Order transaction.
- Run genexus-mcp doctor to check the SDK version against my Knowledge Base.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md