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, replay, and eval baselines. The threat-intelligence and defense-tracking tools were removed in 2.9.0 and never enforced anything; upgrade to 2.9.0 or later.
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:
- The agent learns something important, but uses
draft_memory(..., branch_id="feature-x")instead of writing directly. - Review the whole branch with
memory_branch("feature-x"). - Use
draft_diffwhen one draft needs a closer look. - Merge the whole branch with
merge_branch("feature-x"), or reject it withreject_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