# VrtxOmega/omega-brain-mcp [Health: Active]

**Category:** 🔒 Security  
**Repository:** https://github.com/VrtxOmega/omega-brain-mcp  
**GitHub Stars:** 5  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vrtxomega-omega-brain-mcp

## Description
Omega Brain MCP Server. Hardened AI execution pipeline prioritizing NAEF logic constraints over narrative LLM hallucination. 15 VERITAS Build Gates for uncompromising determinism, semantic vault integration, and Tri-Node Cortex validations.

## Tools
Capabilities this server exposes over MCP:

- **omega_preload_context** — Episodic task briefing: RAG + vault + sealed handoff + VERITAS score
- **omega_rag_query** — Semantic search over RAG provenance store
- **omega_ingest** — Add text fragment to RAG store
- **omega_vault_search** — Full-text keyword search across vault entries
- **omega_cortex_check** — Tri-Node approval gate with similarity scoring
- **omega_cortex_steer** — Cortex correction mode — steer drifting args or hard block
- **omega_seal_run** — Append tamper-proof S.E.A.L. entry to audit ledger
- **omega_log_session** — Write session record to vault
- **omega_write_handoff** — SHA-256 sealed cross-session handoff
- **omega_execute** — Cortex-wrapped meta-tool — default execution path
- **omega_brain_report** — Human-readable audit report
- **omega_brain_status** — Unified brain health: vault stats, fragment count, ledger entries
- **veritas_intake_gate** — Gate 1/10: Canonicalize, validate fields, compute ClaimID
- **veritas_type_gate** — Gate 2/10: Primitives, domains, operators, symbols
- **veritas_dependency_gate** — Gate 3/10: SBOM, CVE, integrity, licenses, depth
- **veritas_evidence_gate** — Gate 4/10: MIS\_GREEDY, Quality(e), K/A/Q thresholds
- **veritas_math_gate** — Gate 5/10: Constraint satisfaction via interval arithmetic
- **veritas_cost_gate** — Gate 6/10: Resource utilization vs redline thresholds
- **veritas_incentive_gate** — Gate 7/10: Source dominance and vendor concentration
- **veritas_security_gate** — Gate 8/10: SAST, secrets, injection, auth, crypto
- **veritas_adversary_gate** — Gate 9/10: Fuzz, mutation, exploit, outage, spike
- **veritas_run_pipeline** — Full 10-gate pipeline — final verdict + seal hash
- **veritas_compute_quality** — Compute Quality(e) for single evidence item
- **veritas_mis_greedy** — Run MIS\_GREEDY algorithm on evidence items
- **veritas_claeg_resolve** — Map verdict to CLAEG terminal state
- **veritas_claeg_transition** — Validate state transition (absence = prohibition)
- **veritas_nafe_scan** — Scan for NAFE failure signatures in AI text

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "omega-brain-mcp": {
    "command": "uvx",
    "args": ["omega-brain-mcp"],
    "env": {
      "OMEGA_BRAIN_DATA_DIR": ""
    }
  }
}
```

**Requires environment variables:** `OMEGA_BRAIN_DATA_DIR` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation & README

# Omega Brain MCP

Omega Brain provides task-scoped memory retrieval, explicit claim evaluation and local audit records for MCP clients.

The standalone 2.3 release replaces unsafe argument steering and uncalibrated approval scores with advisory alignment. SSWP can enforce Brain's operator-policy receipts at its witness entry point. Retrieval uses indexed lexical candidates with stable features; it does not claim dense semantic recall.

Install with `python -m pip install .`, then run `omega-brain-mcp` or `python omega_brain_mcp_standalone.py`. Add that command to your MCP client's persistent user configuration. Data defaults to `~/.omega-brain`; use absolute paths for a portable desktop setup.

Call `omega_preload_context` with `task` and `task_id`, then use the same ID on `omega_rag_query` and `omega_ingest`. `omega_integrity_status`, `omega_brain_report` and `omega_ecosystem_status` expose current health and historical verification limits. `omega_write_handoff` requires `conversation_id` equal to the task ID.

The supplied Python client performs the MCP initialization handshake, bounds requests, drains diagnostics and raises server errors. `omega_call("omega_rag_query", query="deployment decision", task_id="example-task")` performs a scoped lookup.

The companion [Stenographer](https://github.com/VrtxOmega/omega-stenographer-mcp) preserves conversations; [SSWP](https://github.com/VrtxOmega/sswp-mcp) runs software checks. Their shared state directory and task IDs must agree.

See [current operating contract](https://github.com/VrtxOmega/omega-brain-mcp/blob/HEAD/docs/CURRENT_STATE.md) for migration, permissions, evidence semantics and recovery. Historical manuals and examples describe older contracts; this document and the current MCP schemas take precedence. Legacy network mode is outside the standalone deployment's tested guarantees.

Run `python -m unittest discover -s tests -p "test_contracts.py"` and `python -m pytest tests/test_build_gates.py`. The integration suite lives in `integration-tests/` and uses `OMEGA_SUITE_ROOT` pointing to sibling `omega-brain`, `omega-stenographer`, `sswp` checkouts and a shared `.venv`.