Sovant
Dashboard →

Sovant MCP for Claude Code

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.

Install (2 minutes)

1. Get your API key

Sign up at sovant.ai and get your API key from Dashboard > API Keys.

Your key looks like: sk_live_...

2. Clone and build

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

3. Add to Claude Code

claude mcp add sovant \
  --command "node" \
  --args "/absolute/path/to/integrations/claude-code-sovant/dist/index.js" \
  --env "SOVANT_API_KEY=sk_live_your_key_here"

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

4. Verify

Restart Claude Code, then ask:

"What Sovant tools are available?"

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

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.

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 (repo-scoped) | | 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 |

Next steps