Eruka MCP

What is Eruka?

Eruka is a knowledge engine that tracks what AI agents know, what they don't know, and what they should never fabricate. It provides:

• 4 Knowledge States: CONFIRMED, INFERRED, UNCERTAIN, UNKNOWN
• Gap Detection: identifies missing information before generation
• Constraint Injection: "DO NOT FABRICATE" directives for LLM prompts
• Knowledge Decay: confidence degrades over time, facts become UNCERTAIN
• Quality Scoring: 6-layer hallucination detection pipeline

Install

cargo install eruka-mcp

Or build from source:

git clone https://github.com/dirmacs/eruka-mcp
cd eruka-mcp
cargo build --release

Setup

eruka-mcp works with two backends:

Local mode — openeruka

Run the open-source Eruka server locally — single binary, SQLite backend, zero infrastructure.

# 1. Install the local server
cargo install openeruka-server   # installs the `openeruka` binary

# 2. Start it
openeruka serve  # runs at http://localhost:8080

# 3. Run eruka-mcp — connects to localhost:8080 by default
eruka-mcp

Full docs: dirmacs.github.io/openeruka

Managed mode — eruka.dirmacs.com

1. Sign up at eruka.dirmacs.com
2. Create a service key (Settings > API Keys)
3. Set your key:

export ERUKA_API_URL=https://eruka.dirmacs.com
export ERUKA_API_KEY=eruka_sk_...

Usage

Claude Desktop

Local mode (openeruka — runs locally, no service required):

{
  "mcpServers": {
    "eruka": {
      "command": "eruka-mcp"
    }
  }
}

Managed mode (eruka.dirmacs.com):

{
  "mcpServers": {
    "eruka": {
      "command": "eruka-mcp",
      "env": {
        "ERUKA_API_URL": "https://eruka.dirmacs.com",
        "ERUKA_API_KEY": "eruka_sk_..."
      }
    }
  }
}

Claude Code

Local mode:

claude mcp add eruka eruka-mcp

Managed mode:

claude mcp add eruka eruka-mcp \
  -e ERUKA_API_URL=https://eruka.dirmacs.com \
  -e ERUKA_API_KEY=eruka_sk_...

Streamable HTTP Transport (remote MCP)

Run as a remote MCP server for claude.ai web, Cursor, or any HTTP-capable MCP client:

eruka-mcp --transport sse --port 8080

This starts a Streamable HTTP server (MCP spec 2025-03-26) at http://localhost:8080/mcp:

• POST /mcp — JSON-RPC 2.0 requests (initialize, tools/list, tools/call)
• GET /mcp — SSE notification stream
• Session management via Mcp-Session-Id header

Claude.ai Web

Use the hosted endpoint at https://eruka.dirmacs.com/mcp:

1. Go to claude.ai → Settings → Connectors → Add custom connector
2. Enter URL: https://eruka.dirmacs.com/mcp
3. Authenticate with your Eruka credentials (OAuth)
4. All 18 tools are automatically available

Direct HTTP Test

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Tools

CLI Alias

For shorter commands, add an alias:

alias eruka='eruka-mcp'
# Then: eruka get "*", eruka write ..., eruka health

CLI Commands

eruka-mcp works as both an MCP server AND a standalone CLI tool. Without a subcommand, it runs as an MCP server (backward compatible).

# Read all context
eruka-mcp get "*"

# Read a specific field
eruka-mcp get "identity/company_name"

# Write a field
eruka-mcp write "identity/mission" "Build anti-hallucination infrastructure"

# Write with custom confidence and source
eruka-mcp write "market/tam" '$4.2B' --confidence 0.7 --source agent_inference

# Search
eruka-mcp search "revenue"

# Completeness report
eruka-mcp completeness

# Knowledge gaps
eruka-mcp gaps

# Health check
eruka-mcp health

# JSON output (for scripting)
eruka-mcp get "*" --format json
eruka-mcp completeness --format json

All CLI commands use the same ERUKA_API_KEY and ERUKA_API_URL environment variables as the MCP server.

Environment Variables

CLI Reference

eruka-mcp [OPTIONS] [COMMAND]

Commands:
  get             Read context fields
  write           Write a context field
  search          Search context
  completeness    Show completeness report
  gaps            List knowledge gaps
  health          Check API health

Options:
      --api-url <URL>        Eruka API URL [env: ERUKA_API_URL]
      --api-key <KEY>        Service key [env: ERUKA_API_KEY]
      --tier <TIER>          Tier override [default: free]
      --transport <MODE>     stdio or sse [default: stdio]
      --port <PORT>          SSE port [default: 8080]
      --format <FMT>         Output: text or json [default: text]
      --debug                Debug logging

License

MIT