Skip to main content

MCP Server

The Novyx MCP server is a developer access path into the action gate. It lets MCP-capable agents request governed actions, attach context, read decisions, and inspect audit evidence.

Current novyx-mcp builds register 102 tools. Exact counts can change as experimental tools move in or out of the registry, so the useful adoption path is the workflow, not the count.

Install: pip install novyx-mcp

No API key needed for local memory work

novyx-mcp can run locally with SQLite at ~/.novyx/local.db. Use cloud mode when you need shared audit evidence, approvals, or production action governance.

Modes

ModeStorageAPI KeyUse case
LocalSQLite (~/.novyx/local.db)Not requiredPersonal context, local development, memory experiments
CloudNovyx API (Postgres)RequiredProtected actions, approvals, audit evidence, team workflows

Start with the action surface

WorkflowRepresentative toolsStatus
Request a protected actionsubmit_action, list_pending, approve_action, action_historyPrimary
Attach and inspect evidenceaudit, audit_verify, trace_create, trace_step, trace_completePrimary
Preserve contextremember, recall, list_memories, context_nowSupporting
Recovery reviewrollback_preview, rollback_history, create_checkpoint, rollback_to_checkpointSupporting; scope varies by API
Experimental supportcortex_*, eval_*, replay snapshotsOff by default or product-dependent

See the full tools reference for parameters and response shapes.