DEV Community

Anton Illarionov
Anton Illarionov

Posted on

ODEI MCP Server: Give Claude a Constitutional World Model

#ai #mcp #claude #agents

ODEI MCP Server: Give Claude a Constitutional World Model

The ODEI MCP server connects Claude Desktop to a production constitutional knowledge graph. Here's the complete setup guide.

What You Get

Three tools available to Claude after setup:

  1. odei_world_model_query — Query 91-node knowledge graph across 6 semantic domains
  2. odei_guardrail_check — Constitutional validation (APPROVED/REJECTED/ESCALATE)
  3. odei_world_model_signal — Instant agent trust scores and context signals

Setup in 2 Minutes

Step 1: Install 

npm install -g @odei/mcp-server
Enter fullscreen mode Exit fullscreen mode

Or use npx (no install needed):

npx @odei/mcp-server
Enter fullscreen mode Exit fullscreen mode

Step 2: Configure Claude Desktop

Edit ~/.claude/mcp.json (create if doesn't exist):

{
  "mcpServers": {
    "odei": {
      "command": "npx",
      "args": ["@odei/mcp-server"],
      "env": {
        "ODEI_API_KEY": "your-key-here"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Step 3: Get Your API Key

Register at https://api.odei.ai/integrate/

Free tier available for basic usage.

Step 4: Restart Claude Desktop

The ODEI tools will appear in Claude's tool list.

Usage Examples

Query the World Model 

Claude, what does ODEI know about AI safety?
Enter fullscreen mode Exit fullscreen mode

Claude calls odei_world_model_query with searchTerm: "AI safety" and returns structured graph data.

Constitutional Validation 

Before I transfer 500 USDC, check if this action is approved.
Enter fullscreen mode Exit fullscreen mode

Claude calls odei_guardrail_check and returns APPROVED/REJECTED/ESCALATE with reasoning.

Trust Score 

What's the trust score for AgentX?
Enter fullscreen mode Exit fullscreen mode

Claude calls odei_world_model_signal with signalType: "agent_score".

Without an API Key

The MCP server works without a key for basic queries — it falls back to the public endpoints. Add a key for full access and higher rate limits.

What the World Model Contains

The 91-node Neo4j graph covers:

  • FOUNDATION (25 nodes) — Identity, values, governance
  • VISION (12 nodes) — Strategic goals
  • STRATEGY (16 nodes) — Active plans
  • TACTICS (8 nodes) — Current tasks
  • EXECUTION (11 nodes) — In-progress work
  • TRACK (19 nodes) — Metrics and signals

Running in production since January 2026.

Source

Top comments (0)