OCL Context Layer MCP server

OCL standard

OCL is an experimental open format for giving AI systems structured, scoped, and verifiable business meaning for Odoo.

An Odoo connector explains how to reach records. An OCL context pack explains what relevant records and fields mean, which tempting interpretations are wrong, what ambiguity must be resolved, and which safety boundaries still apply.

question -> OCL context -> AI reasoning + existing connector -> Odoo

Use OCL

Choose the surface that fits your product:

Clone and try the context behavior:

git clone https://github.com/Nantiai/ocl-standard.git
cd ocl-standard
python reference/python/ocl_examples.py get-context "What is revenue?"

The result asks which revenue definition applies and returns the paired warning against treating account.move.amount_total as universal revenue.

Add the example MCP to an agent

{
  "mcpServers": {
    "ocl-public-examples": {
      "command": "python",
      "args": [
        "/absolute/path/to/ocl-standard/reference/python/ocl_examples.py",
        "serve-mcp"
      ]
    }
  }
}

This local server demonstrates the real OCL tool contract using ten public candidate examples. It is not the commercial Odoo 19 runtime.

See Using OCL for the integration flow, MCP calls, CLI commands, SDK examples, response handling, and current access boundary. Connector and MCP implementers should freeze against the connector runtime contract and its conformance fixture. Hosted runtime clients can follow the verified alpha call guide. Developers can first try one live verified decision, then start a scoped seven-day trial without GitHub, package installation, Odoo credentials, or customer data. The GitHub request and email paths remain available as fallbacks.

This repository contains the open interoperability layer:

• JSON Schemas for semantic entries and request-scoped context packs;
• a dependency-light Python validator and TypeScript client shape;
• ten Odoo 19 candidate examples covering the major knowledge types;
• an executable conformance suite;
• an example-only resolver and MCP server;
• public benchmark methodology.

It does not contain nanti.ai's commercial registry, production assembler, verification harness, source fingerprints, private benchmarks, tenant overlays, memory, or unreleased ontology candidates.

Status

Version 0.1.0 is an experimental technical alpha. The format can change while independent implementations test it. The examples demonstrate the format; they are not the commercial verified registry and do not carry a lifetime guarantee.

Odoo 19 is the only current stock-version focus.

External developer alpha

Developers can now clone the standard, run conformance, integrate the example MCP server, and report an independent implementation. See the developer alpha guide.

Shortened. The full README is on GitHub.