Neuromcp
Semantic memory for AI agents with hybrid search, knowledge graph, and consolidation
Connector by AdelElo13 · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/adelelo13-neuromcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
Runs code on install
Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.
- Tools
- 23 read · 11 write · 1 delete · 11 not yet classified
- Secrets
- None asked for
- Install scripts
- Runs code on install
- Runs as
- Node.js package
Tools by what they do 46
Read from the source code; the running server may list different tools.
Read 23 · Look things up without changing anything.
agent_conflictsfind_expertfind_transferableget_cluster_memoriesget_episodeinit_reviewslist_clusterslist_episodesmemory_statsquery_graphrecall_answerrecall_memory
Show 11 more tools
review_queuesearch_allsearch_claimssearch_memorysearch_verbatimsummarize_clustersummarize_episodeusefulness_statsverbatim_statswiki_ingestwiki_lint
Write 11 · Create, change, send or run things.
cite_memoriescluster_memoriescreate_entitycreate_relationimport_memoriesregister_agentstart_episodestore_memorystore_verbatimtransfer_memoriesupdate_importance
Delete 1 · Delete, drop, revoke or wipe things.
consolidate
Not yet classified 11 · We could not tell from the name and description.
backfill_embeddingscompress_memoriescompute_centralityend_episodeexport_memoriesforget_memorygenerate_reflectionlog_retrievalmemory_timelinereview_memorywiki_briefing
Network hosts it talks to 5
api.openai.com· found in codeclaude.com· found in codegithub.com· found in codehuggingface.co· found in codeollama.com· found in code
Files it touches
/opt/homebrew/lib/node_modules/neuromcp/bin/query.mjs/private/tmp/tmp/neuromcp-auto-context-state.json/Users/a/projects/neuromcp/eval/fixtures/basic-recall.json/Users/a/projects/neuromcp/eval/fixtures/cross-namespace.json/Users/a/projects/neuromcp/eval/fixtures/governance.json/usr/local/lib/node_modules/neuromcp/bin/query.mjs/var/folders- Your home directory (~)
~/.neuromcp/wiki~/projects- Any path the agent passes to its tools
Tools (46)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
agent_conflictsFind conflicting knowledge between different agents on the same topic.
backfill_embeddingsRecompute embeddings for all memories missing from the vector store. Also syncs FTS index.
cite_memoriesAttach a late verdict to a previously-logged retrieval event. Use when the agent answers first and a critic scores the answer afterward. Updates the memory_usefulness prior based on which retrieved memories were cited + outcome.
cluster_memoriesRun k-means clustering on memories in a namespace. Groups semantically related memories into clusters. Returns cluster labels, sizes, and assignments.
compress_memoriesCompress old similar memories into digest memories. Reduces DB size while preserving knowledge. Hard-deletes ancient zero-access tombstones.
compute_centralityRun weighted PageRank over the knowledge graph to compute entity centrality scores. Entities with more connections and higher-weight edges rank higher. Persists results for search boosting.
consolidateRun consolidation: merge near-duplicates, decay stale memories, prune low-value, sweep expired, purge old tombstones. Set commit=true to apply.
create_entityCreate or update an entity in the knowledge graph. Entities represent concepts, people, tools, or any named thing.
create_relationCreate a typed relation between two entities in the knowledge graph. Supports temporal validity.
end_episodeEnd an active episode. Optionally provide a summary, or one will be auto-generated from the most important memories in the episode.
export_memoriesExport memories as JSONL or JSON for backup or migration.
find_expertFind agents with expertise matching a query topic.
find_transferableFind memories in a source namespace that could be useful in a target namespace. Scores by transferability (universal vs project-specific).
forget_memoryTombstone (soft-delete) memories matching the given filters. At least one filter is required.
generate_reflectionSynthesise a meta-reflection memory from memories that have been proven helpful (helpful_count >= min_helpful). Safeguarded: only touches memories with explicit positive critic signal — no speculation on unvalidated content. Stored as category=reflection so downstream searches can include or exclude meta-memories explicitly.
Show 31 more tools
get_cluster_memoriesGet all memories in a specific cluster, ordered by distance from centroid.
get_episodeGet details of a specific episode including memory count.
import_memoriesImport memories from JSONL or JSON data. Deduplicates by content hash.
init_reviewsInitialize spaced repetition for important memories that do not have a review schedule yet.
list_clustersList all clusters in a namespace with their labels and memory counts.
list_episodesList episodes in a namespace. Shows memory count per episode.
log_retrievalLog a retrieval event so future searches can learn which memories are actually helpful. Call right after search_memory. Pass retrieved_ids (all top-K), cited_ids (those actually used in the answer, if known), and an outcome label (helpful/neutral/harmful). Usefulness scores are applied as a prior in future rankings.
memory_statsGet statistics about stored memories: counts, categories, trust levels, importance, and database size.
memory_timelineTrack how knowledge about a topic evolved over time. Follows supersession chains and shows full revision history.
query_graphTraverse the knowledge graph starting from an entity. Returns connected nodes and edges up to max_depth hops. Supports temporal queries. Without entity_id/entity_name it returns an OVERVIEW: the top-N entities of the namespace ranked by number of relations (contradicts edges not counted), with the relations among them; internal memory_proxy entities that only back contradicts edges are excluded from the overview.
recall_answerAnswer a question FROM memory: runs hybrid retrieval, then returns a synthesized, CITED extractive answer (every sentence traces to a stored memory id) PLUS an explicit gap-analysis — what memory does NOT cover and the freshness boundary (stale_since). Returns status "not_in_memory" instead of fabricating when nothing matches. Deterministic, no LLM. Prefer this over search_memory when you need a grounded answer rather than raw chunks.
recall_memoryRecall memories by ID, namespace, category, or tags without semantic search.
register_agentRegister or update an agent profile with expertise topics. Auto-counts memories.
review_memoryRecord a review of a memory. Quality 0-5 (SM-2 scale: 0=forgot, 5=perfect). Updates interval and schedules next review.
review_queueGet memories due for spaced repetition review. Returns overdue memories ordered by urgency + importance.
search_allUnified search across both extracted memories and verbatim text. Returns results with source labels and per-source quotas.
search_claimsSearch atomic claims extracted from memories. Claims are verifiable facts with subject-predicate-object structure.
search_memorySearch memories using hybrid vector + full-text search with RRF ranking, graph boost, and cognitive priming. Supports temporal queries (valid_at) to find what was true at a specific time.
search_verbatimSearch raw verbatim text using full-text search. Returns exact matches from stored conversations. Use for literal recall.
start_episodeStart a new episode (session/task context). Memories stored with this episode_id will be grouped together. Use to track what happened during a session.
store_memoryStore a new memory with semantic deduplication, contradiction detection, surprise scoring, and entity extraction. Returns the memory ID, contradictions found (resolution supersede/coexist are claim-backed and recorded as graph edges; flag is heuristic-only and reported here but never stored in the graph), surprise score, and extracted entities.
store_verbatimStore raw conversation text verbatim — no summarization, no consolidation, never pruned. Use for exact recall of what was said.
summarize_clusterGenerate an extractive summary of a cluster. Selects the most central, representative sentences from cluster memories using embedding centrality.
summarize_episodeGenerate an extractive summary of an episode. Selects the most central, representative sentences from episode memories.
transfer_memoriesCopy memories from source to target namespace. Optionally adapts content by stripping project-specific references.
update_importanceRecalculate adaptive importance for all memories in a namespace. Boosts frequently accessed, recently relevant, and graph-central memories. Run after clustering and PageRank for best results.
usefulness_statsList memories ranked by observed usefulness (helpful vs harmful citation ratio). Use to inspect which memories the agent actually leans on, or to pick high-confidence source material for reflection.
verbatim_statsGet statistics about verbatim storage: total entries, size, and distribution by namespace.
wiki_briefingGenerate a structured briefing from the wiki: active projects, unprocessed sources, recent changelog entries, stale pages needing attention. Use for morning status checks.
wiki_ingestRead a file from the wiki raw-sources/ directory and extract structured metadata (title, type, key concepts, related pages). Returns analysis the LLM uses to decide which wiki pages to create or update. Does NOT write pages itself.
wiki_lintScan all wiki pages and check for health issues: missing frontmatter, pages not in index.md, stale pages (>30 days), thin pages (<5 lines), unprocessed raw sources, broken related links. Writes lint-report.md.
Signals
- Stars
- 4
- Forks
- 0
- Open issues
- 0
- Last commit
- Oct 15, 2026 (14 days ago)
- Last release
- Oct 15, 2026 (14 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.AdelElo13/neuromcp- Version
- 0.30.2
- Auth
- No auth
- Packages
- npm neuromcp
- License
- License unknown
- Repository
- github.com/AdelElo13/neuromcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from AdelElo13
- 0.574score
mac-control-mcp
AdelElo13
Native Swift macOS automation — 153 tools: AX, EventKit, voice, browser DOM, undo.
ConnectorAFreshness: ALocal★ 18Claude Code +5 - 0.365score
Neurohive
AdelElo13
Multi-agent memory intelligence with expertise tracking and conflict detection
ConnectorDFreshness: DLocal★ 1Claude Code +5
Cite this page
Neuromcp MCP server. Agent Mart. https://agentmart.dev/connectors/adelelo13-neuromcp (last updated 2026-10-25)