MCP Server (ordo mcp)
ordo mcp runs Ordo as a Model Context Protocol server over stdio. A coding agent (Claude Code, Cursor, Windsurf, …) can then read, write, validate, test, and ship decision rules without leaving your editor.
Register
# Claude Code
claude mcp add ordo -- ordo mcpFor other clients, add a stdio MCP server whose command is ordo mcp, run from inside a decision project (the folder created by ordo init).
Tools
The server exposes ten tools. The read, edit and check tools work on the local project files and the embedded engine, offline. Only publish reaches the platform.
| Tool | What it does |
|---|---|
list_files | List the project's files |
read_file | Read a file |
grep | Search files for a substring |
write_file | Create/overwrite a file |
delete_file | Delete a ruleset/tests/contracts file |
validate | Compile a ruleset, structured errors |
run_tests | Run a ruleset's test cases |
trace | Execute an input and return the step-by-step path |
impact | List the decisions that changed since a commit |
publish | Deploy a ruleset to an environment |
Safety
The server is local-first and git-backed, so file edits are reversible and allowed by default. High-risk actions are gated by flags:
ordo mcp --allow-publish # permit the publish tool
ordo mcp --allow-delete # permit deleting ruleset filesWithout --allow-publish, the publish tool returns a blocked result rather than deploying. The agent can propose a release, but a person decides.
Typical flow
- You tell your agent: "add a rule: approve if amount ≤ 10000, else reject."
- The agent uses
list_files/read_fileto understand the project, thenwrite_fileto addrulesets/loan-approval.json. - It calls
validateandrun_tests, fixing anything that fails. - It calls
traceto confirm a sample input takes the expected path. - It calls
impactto check that every changed decision was meant (see CLI). - With
--allow-publish, it canpublish. Otherwise it hands off to you.
validate/test/trace/impact run offline in under a second, so the agent's edit → check loop is fast. Results match what the platform would produce, because concepts are materialized the same way.