Sverklo MCP server
Local-first MCP code intelligence: 37 tools — hybrid search, blast-radius, diff review, memory.
80 stars171 downloads/wk
Reviews
Write oneNobody has reviewed Sverklo yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Sverklo tools (41, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
clear_index[Zilliz claude-context compat] Delete the index database and rebuild it from scratch.
get_indexing_status[Zilliz claude-context compat] Alias for sverklo_status. Returns current indexing
index_codebase[Zilliz claude-context compat] Index (or re-scan) the current codebase.
search_code[Zilliz claude-context compat] Alias for sverklo_search. Semantic + text hybrid
sverklo_askNatural-language router over sverklo's existing primitives.
sverklo_ast_grepFind code by AST shape, not text — e.g. 'every console.log($X)',
sverklo_auditOne-call codebase health report: god nodes (highest blast-radius symbols),
sverklo_clustersGroup files into modules by graph-community detection (label propagation
sverklo_conceptsSemantic search over LLM-labeled subsystem concepts. Returns the clusters
sverklo_contextUmbrella context bundler. Give a task description and get a single curated bundle:
sverklo_critiqueDeterministic coverage check for an agent's answer. Takes the evidence ids the agent cited
sverklo_ctx_grepFilter the result blocks of a context handle by regex. Operates on the cached body — no second
sverklo_ctx_peekReturn a byte-slice from a single result block of a prior tool call.
sverklo_ctx_sliceReturn a byte-slice of a context handle (ctx://<tool>/<id>). Use to drill into the body without
sverklo_ctx_statsInspect a context handle without consuming it: tool, age, block count, byte size, fresh/expired.
sverklo_demoteDemote a memory from core to archive tier. Archive memories are only retrieved on demand
sverklo_depsShow what a file imports/depends on and what depends on it. Helps understand the impact of changing a file.
sverklo_diff_searchSemantic search scoped to files in a git diff (and optionally their dependency closure).
sverklo_forgetPermanently delete a memory after recall returned a stale or wrong entry.
sverklo_grep_resultsFilter the result blocks of a prior sverklo tool call by a regex pattern —
sverklo_head_resultsKeep only the top N result blocks of a prior sverklo tool call. Cheap way
sverklo_impactRefactor blast-radius: callers of a symbol with confidence scoring. Run before editing. Use cross_repo:true to see impact across linked projects in a workspace.
sverklo_investigateSingle-call research primitive: fans out to BM25, embeddings, symbol lookup, and
sverklo_list_reposList all indexed repositories in the global registry.
sverklo_lookupLook up a specific symbol (function, class, type, variable) by name. Returns its full definition, signature, and location.
sverklo_memoriesList all memories for the current project. Shows memory health: staleness, confidence, access frequency.
sverklo_overviewGet a structural map of the codebase. Shows the most important files and their key symbols ranked by dependency importance (PageRank). Use this FIRST when starting work on an unfamiliar codebase or directory.
sverklo_patternsQuery the LLM-derived design-pattern annotations on indexed symbols.
sverklo_pinPin a memory to a specific file or symbol. Pinned memories surface automatically
sverklo_promotePromote a memory to the core tier. Core memories are auto-injected into every session
sverklo_recallSearch memories semantically. Finds past decisions, preferences, and patterns relevant to a query.
sverklo_refsFind all references to a symbol across the codebase. Shows where a function, class, or type is imported, called, or used. Matches on identifier word boundaries by default — `embed` does NOT match `embeddingStore`. Pass `exact: false` to opt into substring matching.
sverklo_rememberSave a persistent memory tied to git state. Auto-invalidates conflicting prior memories.
sverklo_review_diffDiff-aware context bundler for code review. Takes a git ref or range and returns:
sverklo_searchHybrid semantic + text search with PageRank ranking.
sverklo_search_iterativeWider-pool, iterative-friendly variant of sverklo_search. Returns a ctx:// handle to the
sverklo_statusProject state + tool usage guide. Returns index health (files, chunks, languages),
sverklo_test_mapMap a git diff to its test coverage. Given a ref/range, lists which tests likely cover
sverklo_unpinwrite actionRemove a pin from a memory.
sverklo_verifyCheck whether one or more evidence ids (from a prior search-family tool's
sverklo_wakeup500-token codebase summary suitable for pasting into a system prompt
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan269 source files scanned8/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 46 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (2)
- highShell command built from a string (injection risk)
exec.shell-concatdist/bin/sverklo.js: …pen"; try { execSync(`${cmd} ${out}`); } catch … - mediumeval / new Function used
exec.evaldist/src/search/investigate.js: …helper" gap revealed by the * research eval (rankCandidates, runInvestigate, verifyEv…
Install Sverklo in Claude Code, Cursor or VS Code
Runs npx -y sverklo on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add sverklo -- npx -y sverklo
What the publisher says
From the Sverklo repository's README, as published. We do not edit it. Read it on GitHub
🇬🇧 English · 🇨🇳 中文
Give your coding agent repo memory.
Sverklo gives coding agents repo memory: symbols, callers, diffs, blast radius, and git-pinned decisions before they edit. It is an open-source local-first MCP server for Claude Code, Cursor, Windsurf, Codex CLI, and any MCP-speaking coding agent.
Local-first ◦ MIT ◦ bundled local embeddings by default ◦ remote embeddings only when explicitly configured ◦ telemetry opt-in and off by default
Use Sverklo when your agent needs relationships before editing: callers, dependencies, tests, diff risk, or prior repo decisions.
Use grep/ripgrep when you know the exact string, the repo is tiny, or the change is one file.
Start with the no-write proof command before installing MCP config. The public bench covers 180 hand-verified tasks across 6 OSS codebases; the methodology and ground truth live in sverklo/sverklo-bench. Bench · paper · 90-second demo
cd your-project
npm exec --yes --package=sverklo@latest -- sverklo prove --no-write --guided --markdown
sverklo init --dry-run
npm install -g sverklo && sverklo initsverklo prove --no-write --guided --markdown shows central files, a real symbol with callers, why that proof was selected, the exact prompt to paste into your agent, and a small feedback template before any MCP config or instruction files are written. It may cache the local model/index under ~/.sverklo, but it does not mutate your project. sverklo init --dry-run then previews the files init would touch; sverklo init writes the MCP config for your agent, appends local instructions to AGENTS.md or CLAUDE.md, and runs sverklo doctor to verify the handshake. With the bundled provider, code indexing and embeddings stay on your machine. An explicitly configured remote embedding provider receives the code chunks it embeds.
Need something shareable? Run sverklo prove --no-write --guided --markdown to print a GitHub/Discord-ready proof receipt from your repo, then post it in the proof thread.
Latest no-write proof run: on calesthio/OpenMontage@9066dcb (1,284 indexed files), Sverklo selected ToolResult at tools/base_tool.py:120 and found 475 references across 81 files. The legacy token-efficiency demo on the same checkout used 21.9× fewer estimated input tokens than grep+reading the top 10 matched files, with one miss called out plainly. Read the receipt · OpenMontage discussion
Need local launch planning for the Sverklo account? sverklo marketing runs a local-first Twitter/X agent-team workflow from operator-provided snapshots. It ranks opportunities, drafts seed-content queues, checks profile health, and records human decisions without posting, scraping, replying, liking, reposting, following, or changing the profile.
"The map is not the territory." — Alfred Korzybski
Training data is the map. Your codebase is the territory. Sverklo gives the agent the territory.
Editor shortcuts
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Sverklo: common questions
- Is Sverklo MCP server safe?
- With care: it is graded C, so read the findings first (60/100). Read the Sverklo safety report
- How do I install Sverklo?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Sverklo need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Sverklo maintained?
- The last commit was 46 days ago (2026-08-12). The latest release is v0.19.0.
- What can I use instead of Sverklo?
- Servers from other publishers that do the same job: M3 Memory MCP server, Reverie MCP server and DocsMint MCP server. Compare all Sverklo alternatives.
Alternatives to Sverklo
Same job from other publishers: the closest match first, then the best rated.
- M3 MemoryLocal-first memory — 100+ tools, 99.2% LongMemEval-S retrieval@10, hybrid search, GDPR, no cloud.not reviewedEstablishedA
- ReverieGraph memory that dreams: Neo4j knowledge-graph memory for AI agents with hybrid searchnot reviewedEstablishedB
DocsMintCloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools.not reviewedEstablishedA- MisakanetFailure-memory layer for coding agents: search evidence-rated failure lessons by error text.not reviewedEstablishedA
- MarmUniversal MCP Server with advanced AI memory capabilities and semantic search.not reviewedEstablishedA