Skip to content
Agentmart
Submit a tool

Neuromcp

Semantic memory for AI agents with hybrid search, knowledge graph, and consolidation

Connector by AdelElo13 · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)★ 4
Write a review

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.

We use your email only for this newsletter. Privacy

About

Semantic memory for AI agents with hybrid search, knowledge graph, and consolidation

No 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_conflicts
  • find_expert
  • find_transferable
  • get_cluster_memories
  • get_episode
  • init_reviews
  • list_clusters
  • list_episodes
  • memory_stats
  • query_graph
  • recall_answer
  • recall_memory
Show 11 more tools
  • review_queue
  • search_all
  • search_claims
  • search_memory
  • search_verbatim
  • summarize_cluster
  • summarize_episode
  • usefulness_stats
  • verbatim_stats
  • wiki_ingest
  • wiki_lint

Write 11 · Create, change, send or run things.

  • cite_memories
  • cluster_memories
  • create_entity
  • create_relation
  • import_memories
  • register_agent
  • start_episode
  • store_memory
  • store_verbatim
  • transfer_memories
  • update_importance

Delete 1 · Delete, drop, revoke or wipe things.

  • consolidate

Not yet classified 11 · We could not tell from the name and description.

  • backfill_embeddings
  • compress_memories
  • compute_centrality
  • end_episode
  • export_memories
  • forget_memory
  • generate_reflection
  • log_retrieval
  • memory_timeline
  • review_memory
  • wiki_briefing

Network hosts it talks to 5

  • api.openai.com · found in code
  • claude.com · found in code
  • github.com · found in code
  • huggingface.co · found in code
  • ollama.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_conflicts

    Find conflicting knowledge between different agents on the same topic.

  • backfill_embeddings

    Recompute embeddings for all memories missing from the vector store. Also syncs FTS index.

  • cite_memories

    Attach 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_memories

    Run k-means clustering on memories in a namespace. Groups semantically related memories into clusters. Returns cluster labels, sizes, and assignments.

  • compress_memories

    Compress old similar memories into digest memories. Reduces DB size while preserving knowledge. Hard-deletes ancient zero-access tombstones.

  • compute_centrality

    Run 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.

  • consolidate

    Run consolidation: merge near-duplicates, decay stale memories, prune low-value, sweep expired, purge old tombstones. Set commit=true to apply.

  • create_entity

    Create or update an entity in the knowledge graph. Entities represent concepts, people, tools, or any named thing.

  • create_relation

    Create a typed relation between two entities in the knowledge graph. Supports temporal validity.

  • end_episode

    End an active episode. Optionally provide a summary, or one will be auto-generated from the most important memories in the episode.

  • export_memories

    Export memories as JSONL or JSON for backup or migration.

  • find_expert

    Find agents with expertise matching a query topic.

  • find_transferable

    Find memories in a source namespace that could be useful in a target namespace. Scores by transferability (universal vs project-specific).

  • forget_memory

    Tombstone (soft-delete) memories matching the given filters. At least one filter is required.

  • generate_reflection

    Synthesise 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_memories

    Get all memories in a specific cluster, ordered by distance from centroid.

  • get_episode

    Get details of a specific episode including memory count.

  • import_memories

    Import memories from JSONL or JSON data. Deduplicates by content hash.

  • init_reviews

    Initialize spaced repetition for important memories that do not have a review schedule yet.

  • list_clusters

    List all clusters in a namespace with their labels and memory counts.

  • list_episodes

    List episodes in a namespace. Shows memory count per episode.

  • log_retrieval

    Log 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_stats

    Get statistics about stored memories: counts, categories, trust levels, importance, and database size.

  • memory_timeline

    Track how knowledge about a topic evolved over time. Follows supersession chains and shows full revision history.

  • query_graph

    Traverse 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_answer

    Answer 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_memory

    Recall memories by ID, namespace, category, or tags without semantic search.

  • register_agent

    Register or update an agent profile with expertise topics. Auto-counts memories.

  • review_memory

    Record a review of a memory. Quality 0-5 (SM-2 scale: 0=forgot, 5=perfect). Updates interval and schedules next review.

  • review_queue

    Get memories due for spaced repetition review. Returns overdue memories ordered by urgency + importance.

  • search_all

    Unified search across both extracted memories and verbatim text. Returns results with source labels and per-source quotas.

  • search_claims

    Search atomic claims extracted from memories. Claims are verifiable facts with subject-predicate-object structure.

  • search_memory

    Search 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_verbatim

    Search raw verbatim text using full-text search. Returns exact matches from stored conversations. Use for literal recall.

  • start_episode

    Start 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_memory

    Store 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_verbatim

    Store raw conversation text verbatim — no summarization, no consolidation, never pruned. Use for exact recall of what was said.

  • summarize_cluster

    Generate an extractive summary of a cluster. Selects the most central, representative sentences from cluster memories using embedding centrality.

  • summarize_episode

    Generate an extractive summary of an episode. Selects the most central, representative sentences from episode memories.

  • transfer_memories

    Copy memories from source to target namespace. Optionally adapts content by stripping project-specific references.

  • update_importance

    Recalculate 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_stats

    List 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_stats

    Get statistics about verbatim storage: total entries, size, and distribution by namespace.

  • wiki_briefing

    Generate a structured briefing from the wiki: active projects, unprocessed sources, recent changelog entries, stale pages needing attention. Use for morning status checks.

  • wiki_ingest

    Read 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_lint

    Scan 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
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from AdelElo13

Cite this page

Neuromcp MCP server. Agent Mart. https://agentmart.dev/connectors/adelelo13-neuromcp (last updated 2026-10-25)