Best for
- Developers and teams using GeneXus 18
- AI tool users who want to interact with the knowledge base via natural language
G
GeneXus MCP Server
Community
Read, edit, and analyze GeneXus 18 knowledge base objects via MCP.
GitHub source repository ↗
FMRS 60/100 · C — Read the FMRS scoring method →
GeneXus MCP Server enables AI agents like Claude Desktop, Claude Code, Cursor, and others to read, edit, analyze, and refactor objects within a GeneXus 18 Knowledge Base over the Model Context Protocol. It talks to the native GeneXus SDK, so the agent works with a real KB, not a copy. Supports data model authoring, index management, WorkWithPlus UI editing, code refactoring, build, test, deploy, versioning, and more.
Tools
genexus_whoami
Get KB context, version, and health status.
genexus_doctor
Check connection and installation health.
genexus_recipe
Execute named playbooks and macros.
genexus_telemetry
Collect observability metrics.
genexus_query
Search objects with prefix filters.
genexus_list_objects
Paginated object listing with aggregates.
genexus_read
Read any part of an object (source, structure, etc.).
genexus_inspect
One-shot object snapshot (metadata, variables, etc.).
genexus_search_source
Search source code with regex.
genexus_navigation
Get navigation report.
genexus_edit
Edit any object part (full, patch, or ops modes).
genexus_edit_and_build
Edit and build with rollback on failure.
genexus_edit_form
Semantic WebForm edits.
genexus_variable
CRUD for variables.
genexus_create
Create objects (transactions, procedures, domains, etc.).
genexus_delete_object
Delete an object.
genexus_format
Format code snippet with rules.
genexus_structure
Read/write data model structure including index creation.
genexus_authoring
Manage external objects and menu options.
genexus_properties
Read/update object properties.
genexus_refactor
Refactor (rename, extract procedure).
genexus_apply_pattern
Apply patterns (WorkWith, WorkWithPlus).
genexus_wwp
Manage WorkWithPlus actions and buttons.
genexus_compare
Compare objects (IDE parity).
genexus_merge
Merge objects (2- or 3-way).
genexus_analyze
Analyze semantic impact, dependencies, complexity.
genexus_doc
Generate documentation and diagrams.
genexus_api
Inspect REST API endpoints.
genexus_security
Security audits and scans.
genexus_lifecycle
Build, validate, index, reorg.
genexus_test
Run GXtest tests.
genexus_db
Database operations (DDL, index advisor, etc.).
genexus_deploy
Deploy the application.
genexus_run_object
Resolve runtime URL.
genexus_browser
Headless browser verification.
genexus_layout
Layout/WebForm operations.
genexus_kb
Manage multiple knowledge bases (open/close).
genexus_module
Module manager.
genexus_kb_version
Knowledge base version management.
genexus_versioning
Versioning (git-style history).
genexus_gxserver
GXserver sync and CI pipelines.
genexus_transfer
XPZ export/import.
genexus_memory
Per-KB fact store.
genexus_gam
GAM security provisioning.
genexus_io
Assets, screenshots, OCR.
genexus_sdk_probe
Probe live SDK surface.
genexus_worker_reload
Hot-swap worker process.
Setup
- Ensure Windows, GeneXus 18 installed, and KB initialized.
- Run
npx genexus-mcp@latest init --kb "<KB_PATH>" --gx "<GENEXUS_PATH>". - Restart your AI client (fully quit).
- Test with prompt like "Using GeneXus MCP, list first 5 objects".
Fit and risk
Not for
- Users without GeneXus
- Cross-platform needs (Windows only)
- Users expecting no local installation
Required permissions
- Read/write local file system (KB files)
- Execute build/deploy processes
- Network access for certain features
Risks and side effects
- Misusing edit tools could damage KB, but rollback is available
- Build processes may incur performance overhead
- Requires granting sufficient execution permissions
Troubleshooting
- Common issues:
- - Client doesn't see tools: Check client config and run `npx genexus-mcp clients`.
- - Worker fails to start: Check .NET 4.8 errors.
- - Build errors often due to locked files; inspect KB build logs.
- - Port conflicts: If 5000 is in use, adjust config.
Use cases
AI-assisted viewing and editing of GeneXus objects
Automated data model authoring
Build and test execution
Refactoring and version management
Supported clients
Claude DesktopFull support
Claude CodeFull support
CursorFull support
AntigravityFull support
Gemini CLIFull support
OpenCodeFull support
Codex CLIFull support
VS CodeFull support
VS Code InsidersFull support