Return runtime status and active configuration summary for this MCP server.

Return a compact runtime health summary for fast smoke checks.

Return concise best-practice guidance for users and AI agents using this MCP.

Get task-scoped tool guidance. Describe what you want to do and receive a tailored list of tools, workflow steps, and tips.

Check npm for the latest localnest-mcp version on the selected channel (cached, default every 120 minutes).

Update localnest-mcp globally via npm and sync bundled skill. Supports stable, beta, or explicit version targets. Requires explicit user approval.

[QUICK_REHYDRATION] Bundle runtime status, memory state, and relevant recall for a non-trivial task in one call.

Return local memory feature status, consent state, and backend compatibility.

Recall the most relevant local memories for a task or query. Use item_format=compact to drop content/metadata (~50% fewer tokens) or lite to return only id+title (~85% fewer tokens).

[COMPLETE_MISSION] One-call mission summary capture. Use this after completing a task, fixing a bug, or making a major architectural decision to persist the "Winner" state for future agents.

[MANDATORY_START] The single most important tool for task initialization. Rehydrates project context, recalled memories, KG entities, relevant files, recent changes, and suggested actions in one call. Always call this BEFORE deeper research.

Cross-session delta: new memories, KG triples, file changes, and commits since a given timestamp or last session.

Teach the agent a durable behavior rule. Stores a high-importance feedback memory that auto-surfaces in agent_prime when future tasks match the instruction domain. Use this to set persistent preferences, coding standards, or workflow rules that should apply across sessions. Teach memories can be listed (kind=feedback), updated, or deleted via existing memory CRUD tools.

List stored memories with optional scope, kind, nest, branch, and tag filters. Use item_format=compact to drop content/metadata (~50% fewer tokens) or lite to return only id+title (~85% fewer tokens).

Fetch one stored memory with revision history.

Store a durable local memory entry.

Update a stored memory entry and append a revision.

Delete a stored memory entry and all of its revisions.

Delete up to 100 memory entries in a single call. Returns the count of deleted entries and per-row errors for IDs that were not found or failed.

Ingest a background work event and auto-promote meaningful events into durable memory.

List recently captured memory events and whether they were promoted into durable memory.

Find semantically similar memory entries that could be linked to a given memory. Uses dense embeddings (all-MiniLM-L6-v2) when available, falls back to token overlap. Returns candidates ranked by similarity without creating any relations — use localnest_memory_add_relation to confirm.

Link two memory entries with a named relation. Use to build a traversable knowledge graph (e.g. "depends_on", "contradicts", "supersedes", "related").

Remove a relation between two memory entries.

Return all memory entries linked to a given memory ID, traversing the knowledge graph one hop in both directions.

Store up to 100 memory entries in a single atomic transaction. Deduplicates via fingerprint and optional semantic similarity. Returns created/duplicate counts and per-row validation errors.

List configured local roots available to this MCP server.

List first-level project directories under a root.

Return a compact tree of files/directories for a project path.

Read a bounded chunk of a file with line numbers.

Report that a file was edited and receive proactive hints about high-importance memories linked to it. Memories with importance >= 70 that reference the file are flagged with suggest_update=true, indicating the memory may need updating to reflect the file change.

Return a high-level summary of a project directory.

Return local semantic index status and metadata.

Return active embedding backend/model status and vector-search readiness.

Build or refresh semantic index for a project or across all roots.

[FAST_DISCOVERY] Search file paths and names matching a query. Use this first when looking for a module, feature, or component by name (e.g. "sso", "payment", "auth").

[EXACT_MATCH] Search text across files under a project/root and return matching lines. Best for exact symbol names, imports, or known identifiers.

[DEEP_ANALYSIS] Run lexical + semantic retrieval and return RRF-ranked results. Best for queries where concepts and context matter as much as exact keywords.

[SYMBOL_INDEX] Look up symbol definitions/exports by name using fast regex search.

[USAGE_ANALYSIS] Find call sites and import usages of a symbol by name.

Create or update an entity in the knowledge graph. Entity IDs are auto-generated as normalized slugs (lowercase, underscored).

Add a subject-predicate-object triple to the knowledge graph. Entities are auto-created on first reference. Detects contradictions (same subject+predicate with different valid object) and warns without blocking.

Create up to 500 entities in a single transactional batch. Returns created/duplicate counts and per-row errors. Use response_format "verbose" to get back an ids[] array.

Add up to 500 triples in a single transactional batch. Entities auto-created on first reference. Deduplicates against active triples.

Query all relationships for an entity in the knowledge graph with optional direction filtering (outgoing, incoming, or both).

Set valid_to on a triple to mark it as no longer current. The triple remains in history but is excluded from current-state queries.

Query triples for an entity at a specific point in time. mode="event" (default) returns facts whose valid_from/valid_to bracket the date (event-time axis). mode="transaction" returns every triple LocalNest knew at that time via recorded_at, regardless of valid_to (transaction-time axis).

Get a chronological timeline of all triples for an entity, including invalidated facts. Ordered by valid_from date ascending.

Get knowledge graph statistics: total entity count, total triple count, active triple count, and breakdown by predicate type.

Retroactively scan existing memories and create KG triples linking them to matching entities. Processes memories in batches. Use limit/offset for pagination.

List all nests (top-level memory domains) with their memory entry counts.

List all branches (topics) within a specific nest with their memory entry counts.

Get the full taxonomy tree: all nests, their branches, and memory counts at each level.

Traverse the knowledge graph from a starting entity with configurable max hops (default 2). Uses recursive CTEs with cycle prevention. Returns discovered entities with path information.

Discover cross-nest bridges (default) or cross-branch bridges within a nest. Use mode="cross-branch" with a nest to find entities that span different branches within that nest.

Write a private diary entry for an agent. Diary entries are isolated and only visible to the owning agent.

Read recent diary entries for a specific agent. Only returns entries belonging to the requesting agent.

Ingest a Markdown conversation export into memory entries and knowledge graph triples. Pass the full text content directly — file reading is handled by the CLI, not MCP tools.

Ingest a JSON conversation export (array of {role, content, timestamp?} objects) into memory entries and knowledge graph triples. Pass the full JSON text directly.

Check whether content is a semantic duplicate of an existing memory entry. Uses embedding cosine similarity with configurable threshold (default 0.92). Returns the matching entry when a duplicate is found.

Returns hook system statistics: whether hooks are enabled, total registered listener count, and a breakdown of listener counts per event type.

Returns all valid hook event names that listeners can subscribe to. Covers memory lifecycle (store, update, delete, recall), knowledge graph operations (addEntity, addTriple, invalidate), graph traversal, diary, ingestion, dedup, taxonomy, and catch-all wildcards.

Delete a knowledge graph entity by ID. Cascades: also deletes all triples where the entity is subject or object.

Delete up to 100 knowledge graph entities in one call. Cascades: also deletes all triples where each entity is subject or object. Returns count of deleted entities and removed triples.

Hard-delete up to 100 knowledge graph triples by ID. Unlike invalidate (which sets valid_to), this permanently removes the triples.

Scan a directory for projects and create seed memory entries for those with zero existing memories. Detects package.json, Cargo.toml, go.mod, pyproject.toml, pom.xml, build.gradle, and .git. Use dry_run=true to preview without writing.

Search across memory entries, code chunks, and knowledge graph triples in a single call. Results are re-ranked across all sources using normalized scores. Each item includes a source field ("memory", "code", or "triple"). Use the sources parameter to limit which backends are queried.

Run a comprehensive self-audit of LocalNest health. Returns memory coverage by project, KG density metrics (entities, triples, orphans, duplicates, connected components), unpopulated nests, broken bridges, stale memories, a 0-100 health score, and actionable suggestions. Call once to get a full integrity dashboard.

Find every call site of a function or method across indexed files. Returns file path, line number, and surrounding context for each call. Requires the project to be indexed first via localnest_index_project.

Jump to the declaration location(s) of a symbol across TypeScript, JavaScript, Python, Go, and Rust files. Returns file path, line range, and declaration text. Requires the project to be indexed first via localnest_index_project.

Find every class, struct, or object that implements a given interface or trait. Supports TypeScript implements, Python class inheritance, Rust impl-for, and Go struct patterns. Requires the project to be indexed first via localnest_index_project.

Preview every location that would change when renaming a symbol. Does NOT modify any files -- returns a dry-run list of changes grouped by file. Requires the project to be indexed first via localnest_index_project.

Create a point-in-time backup of the LocalNest memory database using SQLite VACUUM INTO. The backup is a clean, compacted SQLite file verified with PRAGMA integrity_check. If destination is omitted, the backup is written to {memoryDbDir}/backups/{timestamp}.db.

Restore the LocalNest memory database from a backup file. Verifies backup integrity before replacing the live database. IMPORTANT: The MCP server must be restarted after restore for changes to take effect.