MCP Memento
An MCP server that provides persistent memory and context management across sessions
Connector by annibale-x · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying MCP Memento?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
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/annibale-x-mcp-memento
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 and install config. Checked Oct 25, 2026.
- Tools
- 17 read · 5 write · 1 delete · 2 not yet classified
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 25
Read from the source code; the running server may list different tools.
Read 17 · Look things up without changing anything.
analyze_memento_graphcontextual_memento_searchfind_memento_patternsfind_path_between_mementosget_central_mementosget_low_confidence_mementosget_mementoget_memento_clustersget_memento_networkget_memento_statisticsget_recent_memento_activityget_related_mementos
Show 5 more tools
memento_onboardingrecall_mementossearch_memento_relationships_by_contextsearch_mementossuggest_memento_relationships
Write 5 · Create, change, send or run things.
apply_memento_confidence_decaycreate_memento_relationshipset_memento_decay_factorstore_mementoupdate_memento
Delete 1 · Delete, drop, revoke or wipe things.
delete_memento
Not yet classified 2 · We could not tell from the name and description.
adjust_memento_confidenceboost_memento_confidence
Tools (25)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
adjust_memento_confidenceManually adjust confidence of a relationship. Use for: - Correcting confidence scores when you know a memory is valid/invalid - Setting custom confidence based on verification - Overriding automatic decay for specific cases Examples: - adjust_memento_confidence(relationship_id="rel-123", new_confidence=0.9, reason="Verified in production") - adjust_memento_confidence(relationship_id="rel-456", new_confidence=0.1, reason="Obsolete after library update") Confidence ranges: - 0.9-1.0: High confidence (recently validated) - 0.7-0.89: Good confidence (regularly used) - 0.5-0.69: Moderate confide…
analyze_memento_graphGet comprehensive analytics and metrics for the memento graph
apply_memento_confidence_decayApply automatic confidence decay based on last access time. Use for: - System maintenance to keep knowledge base fresh - Applying intelligent decay rules - Monthly confidence adjustment routine Intelligent decay rules: - Critical memories (security, auth, api_key, password, critical, no_decay tags): NO DECAY - High importance memories: Reduced decay based on importance score - General knowledge: Standard 5% monthly decay (decay_factor=0.95) - Temporary context: Higher decay rate Decay formula: monthly_decay = confidence × decay_factor^(months_since_last_access) Minimum confidence: 0.1 (won…
boost_memento_confidenceBoost confidence when a memory is successfully used. Use for: - Reinforcing valid knowledge - Manual confidence increase for verified information - After successfully applying a solution - When verifying old information is still valid Usage patterns: - After successfully applying a solution → boost its confidence - When verifying old information is still valid → boost confidence - When multiple team members confirm a pattern → boost confidence Boost mechanics: - Base boost: +0.10 per access (capped at 1.0) - Additional boost for validation: +0.10 to +0.20 - Maximum confidence: 1.0 (cannot e…
contextual_memento_searchSearch only within the context of a given memento (scoped search). Two-phase process: (1) Find related memories, (2) Search only within that set. Provides semantic scoping without embeddings. WHEN TO USE: - Searching within a specific problem context - Finding solutions in related knowledge - Scoped discovery HOW TO USE: - Specify memory_id (context root) - Provide query (search term) - Optional: max_depth (default: 2) RETURNS: - Matches found only within related memories - Context information - No leakage outside context
create_memento_relationshipLink two mementos with a typed relationship. Common types: SOLVES (solution→problem), CAUSES (cause→effect), ADDRESSES (fix→error), REQUIRES (dependent→dependency), RELATED_TO (general) EXAMPLES: - create_memento_relationship(from_memory_id="sol-1", to_memory_id="prob-1", relationship_type="SOLVES") - create_memento_relationship(from_memory_id="err-1", to_memory_id="fix-1", relationship_type="CAUSES", context="Config error caused timeout") Optional: strength (0-1), confidence (0-1), context (description)
delete_mementoDelete a memento and all its relationships
find_memento_patternsFind patterns in mementos and relationships Analyzes the relationship graph to detect recurring structural patterns: - Most frequent relationship types - Common memory-type pairs connected by relationships Note: patterns require multiple occurrences of the same relationship type. With small datasets (< 10 relationships), lower the thresholds: min_pattern_size=1, min_support=0.0 → show all types, even singletons. When no patterns meet the thresholds the tool still reports all available relationship types with their counts so the result is always informative.
find_path_between_mementosFind the shortest path between two mementos through relationships
get_central_mementosFind mementos that connect different clusters (knowledge bridges)
get_low_confidence_mementosFind memories with low confidence scores. Use for: - Identifying potentially obsolete knowledge - Periodic cleanup and verification - Quality assurance of the knowledge base - Finding memories that need review Features: - Filter by confidence threshold (default: < 0.3) - Shows relationships causing low confidence - Includes memory details and last access time - Sorted by confidence (lowest first) Returns: - List of low confidence relationships with associated memories - Memory details for both ends of each relationship - Confidence scores and last access times
get_mementoRetrieve a specific memento by ID. Use when you have a memory_id from search results or store_memento. Set include_relationships=true (default) to see connected memories. EXAMPLE: get_memento(memory_id="abc-123")
get_memento_clustersDetect clusters of densely connected mementos
get_memento_networkGet the complete network structure of mementos and relationships
get_memento_statisticsGet statistics about the memento database
Show 10 more tools
get_recent_memento_activityGet summary of recent memento activity for session context. Returns: memory counts by type, recent memories (up to 20), unresolved problems. EXAMPLES: - get_recent_memento_activity(days=7) - last week's activity - get_recent_memento_activity(days=30, project="/app") - last month for specific project
get_related_mementosFind mementos connected to a specific memory via relationships. Filter by relationship_types (e.g., ["SOLVES"], ["CAUSES"]) and max_depth (default 1). EXAMPLES: - get_related_mementos(memory_id="prob-1", relationship_types=["SOLVES"]) - find solutions - get_related_mementos(memory_id="err-1", relationship_types=["CAUSES"], max_depth=2) - find root causes
memento_onboardingGet comprehensive onboarding protocol for Memento including tool usage guidance, retrieval flow optimization, and best practices. MEMENTO ONBOARDING PROTOCOL: 1. INITIALIZATION: Run memento_onboarding() at session start 2. RETRIEVAL FLOW: - Fact Check: Use search_mementos(tags=[...]) for simple identity/known facts - Complex Tasks: Use recall_mementos(query="...") for dev/architecture context - Fallback: If search fails, fallback to recall 3. AUTOMATIC STORAGE: Store via store_memento on git commits, bug fixes, version releases 4. ON-DEMAND TRIGGERS: Store instantly when user says "m…
recall_mementosPrimary tool for finding mementos using natural language queries. Optimized for fuzzy matching - handles plurals, tenses, and case variations automatically. BEST FOR: - Conceptual queries ("how does X work") - General exploration ("what do we know about authentication") - Fuzzy/approximate matching USE FOR: Long-term knowledge that survives across sessions. DO NOT USE FOR: Temporary session context or project-specific state. LESS EFFECTIVE FOR: - Acronyms (DCAD, JWT, API) - use search_mementos with tags instead - Proper nouns (company names, services) - Exact technical terms EXAMPLES: - r…
search_memento_relationships_by_contextSearch memento relationships by their structured context fields (scope, conditions, evidence, components)
search_mementosAdvanced search with fine-grained filters for precise retrieval of mementos. USE THIS TOOL FIRST (not recall) when searching for: - Acronyms: DCAD, JWT, MCR2, API, etc. - Proper nouns: Company names, service names, project names - Known tags: When you know the tag from previous memories - Technical terms: Exact matches needed PARAMETERS: - tags: Filter by exact tag match (most reliable for acronyms) - memory_types: Filter by type (solution, problem, etc.) - min_importance: Filter by importance threshold - search_tolerance: strict/normal/fuzzy - match_mode: any/all for multiple terms NOTE: T…
set_memento_decay_factorSet custom decay factor for specific memories. Use for: - Marking memories as "no decay" (critical information) - Adjusting decay rates based on importance - Customizing decay for specific use cases Special tags for no decay: - security, auth, api_key, password, critical, no_decay Decay factor ranges: - 1.0: No decay (critical information) - 0.98-0.99: Very low decay (high importance) - 0.95-0.97: Normal decay (general knowledge) - 0.90-0.94: High decay (temporary context) - 0.80-0.89: Very high decay (ephemeral data) Note: Decay factor is applied monthly: new_confidence = confidence × dec…
store_mementoStore a new memento with context and metadata. Required: type, title, content. Optional: id, tags, importance (0-1), context. USE FOR: Long-term knowledge that should survive across ALL sessions. DO NOT USE FOR: Temporary session state or project-specific context. LIMITS: - title: max 500 characters - content: max 50KB (50,000 characters) - tags: max 50 tags, 100 chars each - id: if provided, must be unique string identifier TAGGING BEST PRACTICE: - Always include acronyms AS TAGS (e.g., tags=["jwt", "auth"]) - Fuzzy search struggles with acronyms in content - Tags provide exact match fall…
suggest_memento_relationshipsGet intelligent suggestions for relationship types between two mementos
update_mementoUpdate an existing memento
Signals
- Stars
- 2
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 54
- Last commit
- Apr 1, 2026 (7 months ago)
- Last release
- Apr 1, 2026 (7 months ago)
- Last package publish
- Apr 1, 2026 (7 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.annibale-x/mcp-memento- Version
- 0.2.31
- Auth
- No auth
- Packages
- pypi mcp-memento
- License
- MIT
- Repository
- github.com/annibale-x/mcp-memento
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from annibale-x
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get MCP Memento running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
MCP Memento. Agent Mart. https://agentmart.dev/connectors/annibale-x-mcp-memento (last updated 2026-10-25)