MCP access to ODEI world model queries, guardrails, and governed retrieval.
@odei/mcp-server
MCP access to ODEI world model queries, guardrails, and governed retrieval.
ODEI exposes a constitutional world model through the Model Context Protocol so AI clients can work with structured context instead of raw chat history.
This server gives MCP-compatible tools access to:
- world model queries
- guardrail checks
- signal and confidence scoring
- governed retrieval over ODEI's graph-native memory layer
Live System Status
Metric Value Graph nodes (production) 18,749+ Public projection 18,702 nodes Node types 91 Relationship types 36 Domains 7 Daemons healthy 17/17 Grok x ODEI exchanges 9,993 Insights shipped to code 13 Uptime 18m Latest signal Guardian Layer is Code-Level Validation, Not a Graph Node — Minimum Seed Correction Auto-updated 3x/day · 2026-03-22 15:56 UTC
Why It Exists
Most agent clients can call tools, but they still lack:
- persistent structured memory
- explicit policy checks before action
- retrieval over relationships, not just text similarity
@odei/mcp-server connects those clients to ODEI's governed architecture.
Quick Start
Run locally
git clone https://github.com/odei-ai/mcp-odei.git
cd mcp-odei
npm install
npm run build
node dist/index.js
Claude Desktop
{
"mcpServers": {
"odei": {
"command": "node",
"args": ["/absolute/path/to/mcp-odei/dist/index.js"],
"env": {
"ODEI_API_KEY": "your-key"
}
}
}
}
Core Tools
| Tool | Purpose |
|---|---|
odei_world_model_query |
Query the world model using structured or free-text intent |
odei_guardrail_check |
Evaluate an action against ODEI guardrails before execution |
odei_world_model_signal |
Score claims and signals against known context |
odei_smart_contract_audit |
Run a graph-informed audit workflow for onchain artifacts |
Example
Ask your MCP client:
What are the currently active strategic objectives?
The server routes that request through ODEI's retrieval and policy surfaces instead of relying on an empty session window.
Authentication
Authenticated endpoints use:
X-Api-Key: <your key>
Public projection surfaces may be used for lighter, unauthenticated flows depending on configuration.
Related Surfaces
- odei.ai for research and thesis
- api.odei.ai for docs and production APIs
- memory for the memory architecture
- research for the research program
License
MIT
Tools (4)
odei_world_model_queryQuery the world model using structured or free-text intentodei_guardrail_checkEvaluate an action against ODEI guardrails before executionodei_world_model_signalScore claims and signals against known contextodei_smart_contract_auditRun a graph-informed audit workflow for onchain artifactsEnvironment Variables
ODEI_API_KEYrequiredAPI key for authenticated access to ODEI servicesConfiguration
{
"mcpServers": {
"odei": {
"command": "node",
"args": ["/absolute/path/to/mcp-odei/dist/index.js"],
"env": {
"ODEI_API_KEY": "your-key"
}
}
}
}