# DOME MCP — Unified Model Context Protocol

Unified FastAPI server exposing **18 tools** across 7 domains for the full DOME-HUB sovereign stack.

## Architecture

```
Agent → MCP Server (:8200) → DOME-HUB compute engines
                               ├── E8 Lattice (240 roots, Voronoi routing)
                               ├── AMMA Monitor (self-healing, 4 pillars)
                               ├── Akashic Records (dimensional query/store)
                               ├── Knowledge Base (skills, agents)
                               ├── Fractal Memory (holographic zoom recall)
                               ├── CTO Validation (full suite + sync)
                               └── System Health (7 services + coherence φ)
```

## Quick Start

```bash
cd dome-mcp
pip install -e .
python server.py
# → http://127.0.0.1:8200/docs
```

## Tools

| Category | Tools | Count |
|----------|-------|-------|
| e8 | roots, route, best_storage_node | 3 |
| amma | heal, status | 2 |
| akashic | write, query | 2 |
| kb | skills, agents | 2 |
| memory | fractal_store, fractal_recall | 2 |
| cto | validate, sovereign_sync | 2 |
| system | service_health, coherence | 2 |

## API

- `GET /health` — Health check
- `GET /tools` — List all tools (filter by `?category=`)
- `POST /tools/{name}` — Execute a tool
- `GET /docs` — OpenAPI docs
- `GET /redoc` — ReDoc docs

## Testing

```bash
pip install -e ".[dev]"
pytest tests/ -v
```

## Deployment

```bash
# Run as launchd service (auto-restart, auto-start on boot)
cp com.dome-hub.mcp.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.dome-hub.mcp.plist
```