novyx-mcp

Governed actions, shared memory, audit, and rollback for MCP clients such as Claude Desktop, Cursor, and Claude Code. Works locally with zero config (SQLite) for memory and policy-evaluation workflows, or connects to Novyx Cloud for policy-as-code, approval workflows, governance dashboards, Runtime v2, threat intelligence, defense tracking, replay, and eval baselines.

What To Try First

Use Novyx MCP when coding agents need reviewable shared memory instead of untracked context sprawl:

draft_memory(
  observation="Deploys fail if REDIS_URL is unset in staging",
  tags=["ops", "staging"],
  importance=8,
  branch_id="staging-fixes"
)

memory_branch("staging-fixes")
draft_diff("drf_abc123")
merge_branch("staging-fixes")

That workflow keeps agent memory reviewable before it becomes permanent. The same server also exposes governed-action tools (action_submit, list_pending, approve_action, explain_action) when you connect it to Novyx Cloud.

Install

pip install novyx-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "python",
      "args": ["-m", "novyx_mcp"],
      "env": {
        "NOVYX_API_KEY": "nram_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "novyx-memory": {
      "command": "python",
      "args": ["-m", "novyx_mcp"],
      "env": {
        "NOVYX_API_KEY": "nram_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add novyx-memory -- python -m novyx_mcp

Set the NOVYX_API_KEY environment variable before starting Claude Code. Omit it to use local mode (SQLite, zero config).

CLAUDE.md Integration

After installing and configuring the MCP server above, add this to your project's CLAUDE.md so Claude Code uses Novyx automatically:

## Shared Memory (Novyx MCP)
You have access to novyx-mcp tools for shared memory, knowledge graph, audit,
rollback, replay, and context spaces. Use them when relevant. Store decisions
and status at the end of tasks. Check for context from other agents before
starting new work.

This turns isolated Claude Code sessions into a coordinated team — each session stores what it learned and checks what other sessions have done before starting work.

Canonical Workflow: Draft, Review, Merge

This is the highest-signal Novyx workflow for coding agents:

1. The agent learns something important, but uses draft_memory(..., branch_id="feature-x") instead of writing directly.
2. Review the whole branch with memory_branch("feature-x").
3. Use draft_diff when one draft needs a closer look.
4. Merge the whole branch with merge_branch("feature-x"), or reject it with reject_branch("feature-x").

Example:

draft_memory(
  observation="Deploys fail if REDIS_URL is unset in staging",
  tags=["ops", "staging"],
  importance=8,
  branch_id="staging-fixes"
)

memory_branch("staging-fixes")

draft_diff("drf_abc123")

merge_branch("staging-fixes")

This keeps agent memory reviewable instead of letting every session write directly into permanent state.

Available Tools

Memory-only tools work in local SQLite mode (zero config, no API key). Cloud-only governance and runtime tools require a Novyx API key.

Core Memory (20 tools)

Store, recall, supersede, and audit individual memories.

Memory Drafts & Branches (8 tools)

Stage memory changes for review before committing.

Rollback (3 tools)

Time-travel restore — undo agent mistakes.

Context Spaces (10 tools)

Multi-agent collaboration — shared memory with fine-grained permissions.

Novyx Control — Governance (10 tools)

Policy-as-code, approval workflows, and governed actions. New in Phase 1-5 (v2.5.0).

Runtime v2 — Agent Orchestration (25 tools)

First-class agents, missions, capability packs, checkpoints, and human interventions.

Capabilities require Starter+. Checkpoints require Pro+. Interventions require Enterprise.

Replay (7 tools — Pro+)

Time-travel debugging — inspect how memory changed over time.

Eval (7 tools)

Memory health evaluation and CI/CD gates.

Cortex (5 tools — Pro+)

Autonomous memory intelligence — consolidation, reinforcement, and insights.

Traces (4 tools)

Sentinel trace logging for full agent step audits.

Operational (3 tools)

Available Resources

Available Prompts

Get an API Key

Sign up at novyxlabs.com to get your API key. The free tier includes 5,000 memories and 5,000 API calls per month, including the draft-review-merge workflow.

License

MIT - Copyright 2026 Novyx Labs