vishaltorc avatar

Subconscious

vishaltorc/subconscious-mcp

Gives Claude a local semantic memory layer backed by ChromaDB and sentence-transformers. You get four tools: recall(task) searches past work by similarity, remember(task, answer) stores new pairs, forget(entry_id) deletes an entry, and stats() shows hit rates. The default embedding model is all-MiniLM-L6-v2 running on CPU, so nothing leaves your machine. Useful when you want an agent to skip redundant work by checking if it's already solved a paraphrased version of the same task. First run downloads 80MB for the model, then recall latency drops to milliseconds. Configurable threshold and TTL per entry. All state lives in ~/.subconscious-mcp/data as a persistent ChromaDB collection.

tools
5
transport
STDIO
last updated
Jun 10, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

recallSemantic search for a previously remembered task.

Semantic search for a previously remembered task.

No parameter schema in public metadata yet.

rememberPersist a (task, answer) pair.

Persist a (task, answer) pair.

No parameter schema in public metadata yet.

echoSonar ping: return the nearest non-expired entries without their answers.

Sonar ping: return the nearest non-expired entries without their answers.

No parameter schema in public metadata yet.

drift_reportAnalyze the echo log for first-fill semantic drift candidates: entries whose recall hits span a wide similarity band across distinct query phrasings.

Analyze the echo log for first-fill semantic drift candidates: entries whose recall hits span a wide similarity band across distinct query phrasings.

No parameter schema in public metadata yet.

forgetDelete the entry with this id.

Delete the entry with this id.

No parameter schema in public metadata yet.

Sponsors

Readme

subconscious-mcp

CI PyPI Python License: MIT MCP Registry

Local-first semantic memory for MCP agents. Recall, remember, forget, echo, drift detection, stats over stdio.


View the full README on GitHub

Details

Repository
github.com/vishaltorc/subconscious-mcp
Categories
AI & LLM Tools, Productivity & Office
Package
subconscious-mcp
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1walkojas-boop avatarJSONShelfwalkojas-boop/jsonshelfDeterministic JSON repair, validate, example-gen, schema-coerce for agents. Zero LLM, sub-10ms.0stars
2trusteed avatarMcp Gatewaytrusteed/mcpwebstoreAgentic commerce gateway: discovery, search, checkout across Shopify/Woo/Odoo/PrestaShop.0stars
3yjhann33-design avatarKorea Stock Insight Mcpyjhann33-design/korea-stock-insight-mcpKorean stock market MCP — DART disclosures + KRX prices, English-first for global LLM analysts.0stars
4dayuanjiang avatarNext AI Draw.iodayuanjiang/next-ai-draw-iodraw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand36.9Kstars
5glips avatarFigma Context Mcpglips/figma-context-mcpGive your coding agent access to your Figma data. Implement designs in any framework in one-shot.16.2Kstars
6actionbook avatarActionbookactionbook/actionbookLet your AI agent operate any website through a real, logged-in browser session.1.6Kstars