OpenL MCP Server

Let an AI assistant work with your OpenL Studio business rules. Connect Claude (Desktop or Code), Cursor, or VS Code to OpenL Studio, then ask in plain language to view, edit, test, and deploy rules.

Get started (about 5 minutes)

1. Copy your OpenL Studio address from your browser's address bar (for example http://localhost:8080).

2. Create a Personal Access Token in OpenL Studio (User Settings → Personal Access Tokens). Skip this if your Studio has no login screen.

3. Follow the Quick Start — paste one configuration block into your AI client and send a test message.

Nothing to install — your AI client downloads and starts the server for you (published on npm as openl-mcp; no Node.js on your machine? use the Docker option).

Documentation

• 🚀 Quick Start — connect Claude Code, Claude Desktop, Cursor, or VS Code

• 📖 Usage Examples — what to ask once connected, and what the tools cover

• ⚙️ Advanced Guide — all server settings, authentication, Docker, shared HTTP mode

• 🖥️ CLI Guide — use the same binary as a shell tool (no MCP client needed)

• 🐛 Troubleshooting — common issues and solutions

• 🗂️ Full documentation index — including developer docs

Tools and prompts

The server gives the AI client tools covering OpenL Studio repositories, projects, files, rules tables, tests, an interactive rule debugger (tracing), and deployments — see Usage Examples. It also ships 14 expert guidance prompts for complex workflows (e.g. create_rule, deploy_project) — see prompts/.

Reporting a problem? Include the running build:

npx -y openl-mcp --version

Configuration

End users: the Quick Start covers everything. All server settings (base URL, token, timeout, HTTP mode, debug logging) are in the Advanced Guide.

Development

npm run build          # Build TypeScript
npm test               # Run all tests
npm run lint           # Check code quality
npm run watch          # Dev mode with auto-rebuild

See the Contributing Guide for development guidelines, Architecture for how the code is organized, and the Testing Guide for test suites.

License

LGPL-3.0 - GNU Lesser General Public License v3.0 (follows OpenL Studio project license).