ERDL MCP Server
The ERDL MCP Server provides deterministic rule enforcement for AI agents, ensuring consistent, compliant behavior through mathematical condition matching rather than relying on LLM prompts.
Evaluate/Guard tool calls (
erdl_evaluate): Intercept and check any planned tool call against loaded rules before execution, returning decisions like ALLOW, DENY, CORRECT, REQUEST_HUMAN, or EMERGENCY_HALT.List active rules (
erdl_list_rules): View all currently loaded rules, optionally filtered by category (coding, engineering, writing, design, security, performance, testing, compliance, accessibility, or custom).Create rules from natural language (
erdl_create_rule): Turn plain-language instructions (e.g., "Never useanyin TypeScript") into persistent YAML rules saved to~/.openoba/rules/, taking effect immediately.Simulate rules before creating them (
erdl_simulate): Test a proposed rule against 3 auto-generated scenarios to validate it works as intended before committing.Explain decisions (
erdl_explain): Get a full decision trail showing every rule checked and why a particular decision was made.Access rules as resources: Query
erdl://rules/listfor all rules as JSON, orerdl://statusfor the server's runtime status.Use 30 built-in preset rules across coding, engineering, writing, and design categories โ active immediately with no configuration.
Integrate with any MCP-compatible client: Works with Claude Desktop, Cursor, OpenClaw, VS Code/GitHub Copilot, and more.
Pro/Enterprise features (with license): Includes advanced execution rings (ESCALATE, ROLLBACK, QUARANTINE), Guardian Agent Role, Audit Export (OCSF/OTLP), Team Rules, a Dashboard, and compliance packs for standards like NIST and EU AI Act.
Integrates with GitHub Copilot via VS Code MCP configuration, allowing Copilot to follow enforced rules.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ERDL MCP ServerCreate a rule that bans console.log in TypeScript files"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ERDL MCP Server
Deterministic rules for AI Agents. Say it once. Never repeat.
๐ ไธญๆ็
ERDL (Entity-Rule Definition Language) gives your Agent deterministic rules. 30 built-in rules across 6 categories. Unlimited personal rules. Free forever.
Why ERDL?
Without ERDL | With ERDL |
"Don't use | Rules enforced deterministically, every tool call |
"Write shorter sentences" โ ignored | Writing rules fire before every output |
"Confirm before adding deps" โ skipped | Blocked until you confirm |
"Why did you do that?" โ no answer |
|
Related MCP server: PolicyGuard
Quick Start
# Start MCP Server (5 tools, 30 rules โ all MCP clients)
npx -y @openoba-ai/erdl-mcp
# Or: install OpenClaw Plugin for hardware enforcement
openclaw plugins install @openoba-ai/erdl-openclaw30 rules active immediately. No account. No configuration. No API key.
ไธญๆ็จๆท๏ผ
npx -y @openoba-ai/erdl-mcp --lang zhFree vs Pro
Free | Pro | |
5 MCP Tools | โ | โ |
30 Preset Rules | โ | โ |
Unlimited Personal Rules | โ | โ |
Chinese / English | โ | โ |
All 11 Operators | โ | โ |
MIT Open Source | โ | โ |
Execution Rings 1โ2 (REQUEST_HUMAN, ESCALATE, ROLLBACK, QUARANTINE) | โ | โ |
Guardian Agent Role (็็ฎก่ ๆจกๅผ) | โ | โ |
Audit Export (OCSF / OTLP) | โ | โ |
Team Rules (็ป็ป็บง่งๅๅ ฑไบซ) | โ | โ |
Dashboard (่งๅๅฝไธญ็ป่ฎก) | โ | โ |
Enterprise Compliance Packs (GB/Z 185, NIST, EU AI Act) | โ | Enterprise |
One-command Install
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/OpenOBA/erdl-mcp-server/master/scripts/install.sh | bash# Windows (PowerShell)
iwr https://raw.githubusercontent.com/OpenOBA/erdl-mcp-server/master/scripts/install.ps1 | iexWhy ERDL vs SKILL.md / Prompt Rules?
Prompt-Based Rules | ERDL MCP Server | |
Execution | LLM "tries" to follow | Deterministic engine โ guaranteed |
Visibility | Invisible, can't tell if it worked |
|
Reliability | LLM may ignore or forget | Zero hallucination โ condition match is mathematical |
Testing | Manual |
|
Portability | Single platform | All MCP-compatible Agents |
ERDL rules don't suggest. They don't hope. They enforce.
What's Included
30 Built-in Rules (8 Categories)
Category | Rules | Scope |
| 10 | TypeScript quality, Git discipline, dependency hygiene |
| 24 | Workflow discipline, pipeline gates, session memory, self-verify |
| 7 | Tone, formatting, clarity |
| 3 | Tailwind-first, responsive, accessible |
| 6 | SQL injection, eval, hardcoded secrets, input validation |
| 11 | Coverage, boundary conditions, flaky tests, TDD workflow |
| 3 | N+1 queries, pagination, measure before optimize |
| 3 | Structured logging, health checks, no secrets in logs |
5 MCP Tools
Tool | Purpose |
| Action Guard โ check rules before every tool call |
| Test a rule against 3 scenarios before creating |
| Create a rule from natural language |
| List all active rules |
| Full decision trail for any action |
MCP Resources
Resource | Content |
| All rules as JSON |
| Server runtime status |
Installation
Any MCP Client
{
"mcpServers": {
"erdl": {
"command": "npx",
"args": ["-y", "@openoba-ai/erdl-mcp@latest"]
}
}
}Or let ERDL generate the config for your client:
npx @openoba-ai/erdl-mcp@latest --setupClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent path on your OS.
Cursor
Add to .cursor/mcp.json in your project root.
OpenClaw
# MCP Server (all MCP clients)
openclaw mcp set erdl '{"command":"npx","args":["-y","@openoba-ai/erdl-mcp@latest"]}'
# OpenClaw Plugin (hard enforcement via before_tool_call)
openclaw plugins install @openoba-ai/erdl-openclawPlugin vs MCP Server: The MCP Server gives your Agent ERDL tools. The Plugin adds deterministic tool call interception โ rules run BEFORE every exec/write/search, no relying on LLM self-discipline. Install both for maximum protection.
VS Code / GitHub Copilot
Add to .vscode/mcp.json or the Copilot MCP configuration.
Creating Your First Rule
You: "Never use `any` in TypeScript."
Agent: 1. erdl_simulate โ tests the rule against 3 scenarios
2. erdl_create_rule โ saves to ~/.openoba/rules/
3. Rule is now active. Next `any` will be blocked.
You: "Why did you reject my code?"
Agent: erdl_explain โ shows every rule that firedOr create rules manually in ~/.openoba/rules/ (ERDL SPEC ยง5 format):
protocol: "erdl/v1"
version: "1.0.0"
rules:
- name: "no_console_log"
description: "Don't commit console.log statements"
priority: 10
when:
logic: AND
conditions:
- field: "tool.name"
operator: in
value: ["write", "edit", "apply_patch"]
- field: "tool.args"
operator: match
value: "console\\.log"
then: DENY
message: "Remove console.log before committing"๐ Full tutorial: Create Your First ERDL Rule โ (English)
๐ Complete Rule Reference (all 30 rules with modification guides) โ (English)
CLI Reference
npx @openoba-ai/erdl-mcp@latest # Start MCP server (always latest)
npx @openoba-ai/erdl-mcp@latest --lang zh # Chinese mode
npx @openoba-ai/erdl-mcp@latest --pro-key sk-xxx # Activate Pro license
npx @openoba-ai/erdl-mcp@latest --upgrade # Upgrade to latest
npx @openoba-ai/erdl-mcp@latest --uninstall # Clean removal
npx @openoba-ai/erdl-mcp@latest --help # Full usageUpgrading from v1.0.x? You MUST update your MCP config:
Remove old local-path config:
openclaw mcp remove erdl # or remove "erdl" from mcp.servers in configRe-add with npx (auto-latest):
openclaw mcp set erdl "{\"command\":\"npx\",\"args\":[\"-y\",\"@openoba-ai/erdl-mcp@latest\"]}"Or manually in
~/.openclaw/openclaw.jsonโmcp.servers.erdl:{ "command": "npx", "args": ["-y", "@openoba-ai/erdl-mcp@latest"] }npm cache clearing (if
--versionshows an older release):npm cache clean --force
Run from Source
git clone https://github.com/OpenOBA/erdl-mcp-server.git
cd erdl-mcp-server
npm install
npm run build
node bin/erdl-mcp.js --versionLicense
Built by AI + Human. Deterministic architecture, not prompt engineering.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/OpenOBA/erdl-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server