Sovant MCP for Claude Code

Sovant MCP for Claude Code provides governed memory for your coding sessions — explicit, inspectable, and controllable. Every memory is written intentionally, scoped per repository, and fully auditable.

MCP runs locally. The adapter runs as a local stdio process alongside Claude Code.
Memory stored in Sovant cloud. Memories are persisted, searchable, and manageable via your API key.
Explicit memory only. Nothing is captured automatically — every memory is a deliberate tool call.

Current version: v0.3.0 (changelog) — adds dev-only recall isolation, scope/mode/debug parameters.

Install (2 minutes)

1. Get your API key

Your key looks like: sk_live_...

2. Install the package

npm install -g @sovant/claude-code-mcp

Or install as a project-local dev dependency:

npm install --save-dev @sovant/claude-code-mcp

3. Add to Claude Code

claude mcp add sovant \
  --transport stdio \
  --env SOVANT_API_KEY=sk_live_your_key_here \
  -- sovant-mcp

4. Verify

Restart Claude Code, then ask:

"What Sovant tools are available?"

You should see 10 tools. If you do, you're set.

Manual install (from source)

If you prefer to build from source instead of using npm:

git clone https://github.com/sovant-ai/sovant-claude-code-mcp.git
cd sovant-claude-code-mcp
npm install
npm run build

Then register with Claude Code using the local path:

claude mcp add sovant \
  --transport stdio \
  --env SOVANT_API_KEY=sk_live_your_key_here \
  -- node /absolute/path/to/sovant-claude-code-mcp/dist/index.js

Replace /absolute/path/to/ with the actual path on your machine.

Quick demo (5 commands)

Once installed, try these in Claude Code:

# 1. Save a decision
"Remember decision: we chose PostgreSQL for the main database because of JSONB support"

# 2. Recall project context
"What decisions have we made about the database?"

# 3. Search within this repo
"Search for database decisions"

# 4. Search across all projects
"Search all projects for deployment configs"

# 5. Update a memory
"Update memory abc123 to say: we chose PostgreSQL 16 specifically"

All memories are scoped to the current git repository by default. Global search requires an explicit opt-in — no silent scope expansion.

Privacy default

By default, sovant_recall only returns dev memories — those tagged with source:claude-code (i.e., memories saved through this MCP adapter). Dashboard memories, CRM records, smart-capture data, and Google Sheets sync data are excluded.

To include all workspace memories in a recall, pass include_workspace: true.

What it does NOT do

No auto-capture. Sovant never silently records context. Every memory is written by an explicit tool call.
No background memory. There is no passive listener or hidden persistence layer running in your session.
No silent recall. Context is only retrieved when you (or the model) explicitly asks for it via recall or search.

All 10 tools

Tool	Purpose
`sovant_remember`	Save a general note or fact
`sovant_remember_pref`	Save a coding preference
`sovant_remember_decision`	Save an architectural decision
`sovant_recall`	Retrieve relevant memories (dev-only by default; supports `scope`, `mode`, `debug`, `include_workspace`)
`sovant_search`	Search with explicit scope (repo or global)
`sovant_memory_list`	List recent memories with short IDs
`sovant_memory_show`	Show full details of a memory
`sovant_memory_update`	Edit a memory's content
`sovant_memory_delete`	Delete a memory
`sovant_thread_info`	Show thread ID, repo, and status

Recall parameters

Parameter	Type	Default	Description
`query`	string	(required)	The search query
`limit`	number	10	Max results (max 25)
`scope`	`"thread"` \| `"global"`	`"thread"`	`thread` = current repo only; `global` = all projects
`mode`	`"smart"` \| `"exact"`	`"smart"`	`smart` = hybrid AI recall; `exact` = deterministic keyword match
`debug`	boolean	false	Append debug info (token counts, sources)
`include_workspace`	boolean	false	Include non-dev memories (dashboard, CRM, smart capture)

Example calls

# Dev-only recall (default) — only returns memories saved via MCP
"Recall: strategic direction"

# Global dev-only — search across all repos, still dev-only
"Recall with scope=global: OAuth implementation"

# Include workspace — also surfaces dashboard/CRM/smart-capture memories
"Recall with include_workspace=true: Winnie Wen"

# Deterministic keyword match with debug output
"Recall with mode=exact and debug=true: grant status"

Uninstall

claude mcp remove sovant

This removes the MCP registration from Claude Code. Memories already stored in Sovant are not deleted — you can manage them from the Sovant dashboard.

Next steps

Quickstart (SDK) — use the TypeScript or Python SDK directly
API Reference — full CRUD operations
Dashboard — view and manage all memories
GitHub — source, issues, and changelog