Kirok Memory
Persistent memory for AI agents - hybrid semantic + keyword recall with autonomous consolidation
Connector by TadFuji · 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/tadfuji-kirok-mcp
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
- 9 read · 3 write · 4 delete · 3 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Python package
Tools by what they do 19
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
KIROK_get_bank_configKIROK_get_memoryKIROK_get_mental_modelKIROK_list_banksKIROK_list_memoriesKIROK_list_mental_modelsKIROK_recallKIROK_smart_retainKIROK_stats
Write 3 · Create, change, send or run things.
KIROK_retainKIROK_set_bank_configKIROK_update_memory
Delete 4 · Delete, drop, revoke or wipe things.
KIROK_clear_bankKIROK_delete_bankKIROK_delete_mental_modelKIROK_forget
Not yet classified 3 · We could not tell from the name and description.
KIROK_consolidateKIROK_reflectKIROK_refresh_mental_model
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GEMINI_API_KEY
Tools (19)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
KIROK_clear_bankDelete ALL memories and observations in a bank, keeping the bank itself. Mental models are preserved. This is destructive and cannot be undone. Without confirm=true this makes NO changes and returns a preview of what would be deleted. Only pass confirm=true after the user has explicitly approved deleting this specific bank's contents. Args: bank_id: Bank to clear. confirm: Must be true to actually delete. Defaults to false (preview).
KIROK_consolidateManually trigger observation consolidation for a bank. Processes unconsolidated memories and synthesizes them into observations — patterns, preferences, and durable knowledge. Args: bank_id: Memory bank to consolidate.
KIROK_delete_bankPermanently delete a bank and ALL its memories, observations, models, and config. This is destructive and cannot be undone. Without confirm=true this makes NO changes and returns a preview of what would be deleted. Only pass confirm=true after the user has explicitly approved deleting this specific bank. Args: bank_id: Bank to delete entirely. confirm: Must be true to actually delete. Defaults to false (preview).
KIROK_delete_mental_modelDelete a specific mental model. This is destructive and cannot be undone. Args: model_id: ID of the mental model to delete.
KIROK_forgetDelete a specific memory by its ID. This is destructive and cannot be undone. Args: memory_id: ID of the memory to delete.
KIROK_get_bank_configGet the current configuration for a memory bank. Args: bank_id: Memory bank to query.
KIROK_get_memoryGet full details of a specific memory by its ID. Args: memory_id: The memory ID to look up.
KIROK_get_mental_modelGet full details of a specific mental model. Args: model_id: The mental model ID to look up.
KIROK_list_banksList all available memory banks with their memory counts.
KIROK_list_memoriesList memories in a bank with pagination, ordered by most recent. Args: bank_id: Memory bank to browse. limit: Maximum number of memories to return (default 20, max 100). offset: Number of memories to skip for pagination (default 0).
KIROK_list_mental_modelsList mental models (insights generated by Reflect) for a bank. Args: bank_id: Memory bank to list mental models from. limit: Maximum number of models to return (default 10).
KIROK_recallSearch and retrieve relevant memories using semantic similarity and keyword matching, merged with Reciprocal Rank Fusion. Args: bank_id: Memory bank to search. query: Natural language search query. limit: Maximum number of results (default 10, max 50). time_min: Optional ISO 8601 lower bound for timestamp filtering. time_max: Optional ISO 8601 upper bound for timestamp filtering. verbose: If True, also show relevance scores (RRF/Sim) per item. Default False keeps the output compact (content + ID only) to save context tokens.
KIROK_reflectReflect on accumulated memories to generate new insights. Retrieves relevant memories, analyzes them with an LLM, and saves the resulting insight as a 'mental model' for future reference. Args: bank_id: Memory bank to reflect on. query: What to reflect on (question, topic, or open-ended prompt). limit: Max memories to consider (default 20, max 100). auto_refresh: Whether to refresh this model after future consolidations. source_query: Optional query to use for future refreshes. Defaults to query.
KIROK_refresh_mental_modelRefresh an existing mental model by re-analyzing current memories. Updates the insight based on the latest data in the bank. Args: model_id: ID of the mental model to refresh. limit: Max memories to consider (default 20, max 100).
KIROK_retainStore new information in agent memory. Automatically extracts entities and keywords, generates a semantic embedding, and indexes for later retrieval. Smart Deduplication (inspired by Mem0): If the new content is highly similar to existing memories (cosine > 0.85), the system will decide whether to ADD (new info), UPDATE (enrich existing), or NOOP (skip). Args: bank_id: Memory bank identifier (e.g. 'antigravity', 'user-prefs'). content: The information to remember. context: Optional free-text source of this memory (e.g. 'project meeting', 'code review'). Stored and displa…
Show 4 more tools
KIROK_set_bank_configConfigure a memory bank's retain and observations missions. The retain_mission guides what entities/keywords to extract (and what to ignore). The observations_mission guides what patterns to consolidate into observations. Args: bank_id: Memory bank to configure. retain_mission: Plain-language description of what this bank should focus on. observations_mission: Plain-language description of what observations to synthesize.
KIROK_smart_retainEvaluate content importance before retaining. Uses LLM to score the content from 1-10 and only retains if score >= threshold. Use this for bulk/automatic ingestion where you want the system to decide what's worth remembering. Args: bank_id: Memory bank identifier. content: The information to potentially remember. context: Optional context about the source. timestamp: Optional ISO 8601 timestamp. threshold: Minimum importance score to retain (1-10, default 5).
KIROK_statsGet statistics for a specific memory bank. Args: bank_id: Memory bank identifier.
KIROK_update_memoryUpdate an existing memory's content. Re-extracts entities/keywords and regenerates the embedding if content changes. Args: memory_id: ID of the memory to update. content: New content text (leave empty to keep current). context: New context string (leave empty to keep current).
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 27
- Last commit
- Sep 25, 2026 (1 month ago)
- Last release
- Jul 20, 2026 (3 months ago)
- Last package publish
- Jul 20, 2026 (3 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.TadFuji/kirok-mcp- Version
- 1.4.2
- Auth
- API key
- Packages
- pypi kirok-mcp
- License
- MIT
- Repository
- github.com/TadFuji/kirok-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Kirok Memory MCP server. Agent Mart. https://agentmart.dev/connectors/tadfuji-kirok-mcp (last updated 2026-10-24)