Skip to Content
FoundationsArchitecture overview

Architecture overview

The Nebbos platform is composed of four product surfaces operating on a shared substrate. Each surface has a distinct role in the operator’s day-to-day workflow. Every capability the platform exposes is an interaction among two or more of these surfaces.

The four product surfaces

SurfaceFunctionDeployment
PlatformWeb application. Hosts department-scoped Pearls, dashboards, approval workflows, task tracking, and audit-chain readers. Every action is recorded against a resolved identity.Cloud (us-east-1 default; eu-west-1 available for Enterprise deployments)
AppNative desktop client. Provides the offline execution path for operator work; synchronises with the Platform when network is available.macOS 13+ and Windows 11+
MCPThe Model Context Protocol capability layer. Classifies each tool call to the appropriate data tier on the operator’s host, applies redaction before egress, and forwards the call to the substrate. Policy enforcement is operator-scoped.Runs on the Cradle
CradleHardware device. Carries the MCP binary, the operator’s Pearl memory slice, and the cryptographic keys that authorise Host and Architect-tier operations. Elevated capability is bound to physical possession of the device.FIPS 140-3 Level 3 secure element

Substrate consistency across surfaces

Tool calls made through the MCP, reads included, and changes made through the platform API are committed to hash-chained audit records, and client-scoped tables carry the same row-level isolation at the database layer whichever surface a request comes from, so an application-layer error in one surface cannot read across clients in those tables. Read-only platform API requests are not recorded yet, and the Cradle factor is recorded but not yet required.

Reading path

  1. Security model — enforcement mechanisms for the four governance pillars.
  2. Glossary — canonical definitions of Cradle, Pearl, MCP, and related terms.
  3. The audit chain — the substrate record of every platform operation.