# aaaa-nexus

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add atomadictech-ud4n/aaaa-nexus

# Browse available tools
npx -y @smithery/cli@latest tool list atomadictech-ud4n/aaaa-nexus

# Get full schema for a tool
npx -y @smithery/cli@latest tool get atomadictech-ud4n/aaaa-nexus health

# Call a tool
npx -y @smithery/cli@latest tool call atomadictech-ud4n/aaaa-nexus health '{}'
```

## Direct MCP Connection

Endpoint: `https://aaaa-nexus--atomadictech-ud4n.run.tools`

**Required config:**
- `protocol` (query) — protocol: json-rpc-2.0

## Tools (9)

- `health` — Return worker health and runtime constants.
- `metrics` — Return platform metrics and endpoint registry.
- `oracle_entropy` — Return entropy epoch and nonce seed.
- `oracle_hallucination` — Return hallucination epsilon threshold.
- `ratchetgate_session` — Register a RatchetGate session — formally proved MCP session re-key preventing CVE-2025-6514 long-lived credential thef…
- `inference` — Run Llama 3.1 8B inference with anti-hallucination guard and error correction. Returns answer with HELIX metadata. $0.0…
- `inference_stream` — Streaming CoT inference with Server-Sent Events (SSE). Events: cot/cot_end/ans/done. $0.025/call.
- `ratchetgate_register` — Register a session with RatchetGate post-quantum re-keying (CVE-2025-6514 mitigation). Returns session_id and next_prob…
- `ratchetgate_advance` — Advance RatchetGate epoch, re-key session at RG_LOOP=47 boundary. Returns new epoch and key material. $0.005/call.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get atomadictech-ud4n/aaaa-nexus <tool-name>
```