cogmemai-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y cogmemai-mcp@3.33.2
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
list_rules | No usable answer tool reported an error: {"error":"Could not locate the bindings file. Tried:\n → /app/node_modules/better-sqlite3/build/better_sqlite3.node\n → /app/node_module |
get_intent | No usable answer tool reported an error: {"error":"get_intent needs cloud or hybrid mode (current: local). The intent check runs on the CogmemAi server."} |
get_project_context | No usable answer tool reported an error: {"error":"Could not locate the bindings file. Tried:\n → /app/node_modules/better-sqlite3/build/better_sqlite3.node\n → /app/node_module |
list_memories | No usable answer tool reported an error: {"error":"Could not locate the bindings file. Tried:\n → /app/node_modules/better-sqlite3/build/better_sqlite3.node\n → /app/node_module |
list_trash | No usable answer tool reported an error: {"error":"list_trash is not available in local storage mode."} |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
3 tools with commands in capitals or very long text
- Gives the agent orders in
save_rule:Save a mandatory rule that will ALWAYS be followed in every session. Rules bypass scoring and decay — they are injected into every convers
- Gives the agent orders in
set_intent:rt markdown document with the sections Purpose, Invariants (NEVER and ALWAYS sentences the guard will enforce), Decisions (with the why), and Out of scope. Every ses
- Gives the agent orders in
guard_check:the rules this person has asked their Ai to keep, plus the NEVER and MUST lines of the project intent. Returns allow, ask or deny with the rule that applies. The sh
Common and usually harmless: it is how many makers stress how a tool should be used.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
save_memory content, memory_type, category, subject, importance, scope, team_id, tags, ttl, project_id, verified
Store a developer memory (fact, preference, decision, architecture detail). Memories persist across all Claude Code sessions and are available in future conversations.
save_rule content, subject, scope, category, tags, project_id
Save a mandatory rule that will ALWAYS be followed in every session. Rules bypass scoring and decay — they are injected into every conversation, every time. Use for absolute requirements like "NEVER do X" or "ALWAYS do Y".
list_rules scope
List all mandatory rules for the current project and/or globally. Rules are always-on memories that surface in every session.
get_intent project_id
Read the project's Intent document: the owner's plain-English source of truth (what the project is for, what must always hold, what was decided and why, what is out of scope). It is loaded automatically at session start; call this when you need the full text, or to confirm one exists before proposing a change to it.
set_intent content, changed_by, project_id
Create or replace the project's Intent document in the owner's own words: a short markdown document with the sections Purpose, Invariants (NEVER and ALWAYS sentences the guard will enforce), Decisions (with the why), and Out of scope. Every session loads it, the end-of-turn review checks changes against it, and every replacement is versioned. Use it when the owner describes what the project is for, or agrees to record a change of intent. Ask before replacing an existing document, and pass changed_by "agent" when you drafted the text.
37 more tools
guard_check action, kind, context, project_id
Ask before acting. Judges a proposed action (a command, a message about to be sent, a purchase, a change, anything) against the rules this person has asked their Ai to keep, plus the NEVER and MUST lines of the project intent. Returns allow, ask or deny with the rule that applies. The shell hook does this automatically for commands; call this for everything else, and always before an action that is hard to undo. Fails open: an error is an allow with judged=false.
review_work work, intent, project_id
Review finished work against the intent: what the person set out to have done, what must always hold, what was decided. Pass a description, output, message or transcript of what you did; the project intent document is used, or pass intent inline when there is none. Returns a plain summary, what the intent covers, what it does not, and any violations. The Stop hook does this automatically for code changes in a repository; call this for everything else.
voice_check text, scope, min, project_id
Check a draft against the person's own writing voice. Call it before handing back any draft longer than a paragraph when the rules include a voice_profile (learned with `cogmemai-mcp voice learn` from writing the person wrote themselves). Measures the draft (sentence rhythm, punctuation habits, contractions, person, vocabulary, formatting) against their profile and has the review judge it against the voice document. Returns a drift score with findings, the review verdict, and passed. Fix what is flagged, then check again. Pass scope "project" for a brand voice learned with --project.
delete_rule memory_id
Delete a mandatory rule by its memory ID. Use list_rules to find the ID first.
preflight message, project_id
Proactive recall. Call this BEFORE making any suggestion, recommendation, or action plan. Sends the topic to a fast keyword search and returns any relevant prior context: previous attempts, decisions, contacts, evaluations. This prevents suggesting things that were already tried, rejected, or completed. Fast and cheap, use liberally.
recall_memories query, scope, limit, memory_type, category, importance_min, tag, team_id, context_type, synthesize, max_chars, expand_ids
Search stored memories using semantic search. Returns memories ranked by relevance, importance, and recency. Use this to find relevant context from past sessions.
extract_memories user_message, assistant_response, previous_context
Extract memories from a conversation exchange using AI. Send the developer message and assistant response, and the server identifies facts worth remembering (architecture decisions, preferences, bug fixes, etc.).
get_project_context project_id, include_global, context, context_type, compact, limit, team_id
Load top memories for the current project plus relevant global memories. Use at the start of a session to get full context from previous sessions. Optionally pass context to get memories most relevant to your current task.
list_memories memory_type, category, importance_min, scope, limit, tag, offset, untyped, sort_by
List stored memories with optional filters by type, category, scope, or project.
delete_memory memory_id
Move a memory to the trash by its ID. Trashed memories are hidden from recall and restorable with restore_memory for 30 days, then purged permanently.
restore_memory memory_id
Restore a trashed (deleted) memory by its ID. Works within 30 days of deletion, before the trash is purged. Use list_trash to find restorable memories.
list_trash limit, offset
List trashed (deleted) memories, newest first, with days remaining before each is purged permanently. Restore any of them with restore_memory.
update_memory memory_id, content, importance, scope, memory_type, category, subject, tags
Update an existing memory's content, importance, or scope.
bulk_delete ids
Delete multiple memories at once by their IDs. Maximum 100 IDs per call. This is permanent.
bulk_update updates
Update multiple memories at once. Each item needs a memory_id and fields to update. Maximum 50 items per call.
get_usage
Get current usage statistics — memory count, extractions this month, tier info, projects.
export_memories
Export all memories as JSON. Use this to back up memories or transfer them to another project.
import_memories memories
Bulk import memories from a JSON array. Each memory needs at minimum a content field. Deduplication is applied automatically.
ingest_document text, document_type
Extract memories from a document by splitting it into chunks and processing each one. Great for onboarding — feed in READMEs, architecture docs, or API specs to quickly build project context.
save_session_summary summary
Save a summary of the current coding session. Captures what was accomplished, decisions made, and next steps. Stored as a session_summary memory for future reference.
list_tags
List all tags in use across your memories, with counts. Use this to see what threads/groups exist and find related memories by tag.
link_memories memory_id, related_memory_id, relationship
Connect two related memories with a named relationship. Use this to build a knowledge graph — e.g., linking a bug fix to the architecture decision that caused it, or connecting a preference to the pattern it led to.
get_memory_links memory_id
View all memories linked to a specific memory. Returns the relationship type and full memory details for each connection. Use this to explore the knowledge graph around a memory.
get_memory_versions memory_id
View the edit history of a memory. Shows all previous versions with timestamps and what changed. Useful for understanding how a decision or fact evolved over time.
get_analytics project_id
Get a memory health dashboard with insights: most recalled memories, never-recalled memories, stale memories, growth trends, and breakdowns by type and category. Use this to identify cleanup opportunities and understand memory usage patterns.
promote_memory memory_id
Promote a project-scoped memory to global scope so it applies across all projects. Use this when you discover a preference or pattern that should be universal — e.g., "user prefers tabs over spaces" or "always use Bun instead of npm".
consolidate_memories subject, memory_type, category, dry_run
Consolidate related memories into fewer, richer memories. Finds clusters of memories sharing the same subject (3+ memories required), then uses AI to synthesize each cluster into 1-2 comprehensive facts. Originals are archived (not deleted) with full version history. Use dry_run=true to preview without making changes. Great for cleaning up memory clutter after many sessions.
save_task title, description, priority, status, project_id
Create a task that persists across sessions. Tasks are tracked with status (pending, in_progress, done, blocked) and priority (high, medium, low). Use this to maintain continuity on multi-session work.
get_tasks status, include_done
Get tasks for the current project. Returns tasks filtered by status — defaults to showing pending and in_progress tasks. Use at session start to pick up where you left off.
update_task task_id, status, title, description, priority
Update a task's status, title, description, or priority. Use this to mark tasks as in_progress, done, or blocked as you work.
save_correction wrong_approach, right_approach, context, scope, project_id
Save a correction pattern — what went wrong and what the right approach is. These are surfaced automatically when similar situations arise in future sessions, helping avoid repeated mistakes.
set_reminder content, ttl
Set a reminder that surfaces automatically at the start of your next session. Use for follow-ups, things to check, or deferred work. Reminders auto-archive after being shown.
get_stale_memories days_threshold, limit
Find memories that may be outdated based on age and access patterns. Returns memories that haven't been recalled or updated recently, so you can review, update, or delete them.
get_file_changes
Show what files changed since your last session. Compares the current git state to a snapshot saved when your previous session ended. Helps you understand what happened between sessions.
feedback_memory memory_id, signal
Signal whether a recalled memory was useful or irrelevant. Helps improve future recall quality over time. Use after recalling memories to indicate which were helpful vs noise.
generate_skills subject, project_id, dry_run
Manually trigger skill generation from your corrections, preferences, and patterns. Skills are behavioral directives that auto-improve how the AI works with you. CogmemAi also generates skills automatically when enough evidence accumulates — this tool lets you trigger it manually or preview candidates.
extract_principles subject, project_id, dry_run
Analyze memory clusters and extract underlying factual principles or patterns. Principles are observations about your project — "this codebase tends to have X" — not behavioral instructions (those are skills). Use dry_run to preview candidates first.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=20.0.0 |
| Source | github.com/hifriendbot/cogmemai-mcp |
| Install scripts | better-sqlite3 declare them. This runner does not run them. |
| Tarball | sha512-ljGzfwsQJOAo1Y5itx7SMJU/K4XFTbxPygCtEmhoAAUn7m2NmYexUFf9pe7UEeejJXKS+zgmsaDd0YcUasLH1w== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/cogmemai-mcp)
New version out? Ask for a fresh report.