A portable markdown memory MCP server for any agent. Store durable, searchable memories as git-friendly markdown files.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"smriti-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Smriti MCP > A portable memory server for AI agents, built for the Model Context Protocol (MCP). [](https://pypi.org/project/smriti-mcp/) [](https://www.python.org/downloads/) []() Smriti stores durable memories as plain markdown files with YAML frontmatter. This keeps your data readable, git-friendly, and easy to inspect outside any single agent runtime. ## Features - **Framework agnostic**: Works with any MCP-compatible agent (Claude, OpenAI, local models, etc.) - **Durable & portable**: All memories stored as plain markdown files—no database required - **Git-friendly**: Version control your memories alongside your code - **Search & filter**: Full-text search, filtering by tags, categories, and status - **Relationship tracking**: Use `[[wikilinks]]` to connect related memories - **Memory index**: Auto-generate markdown indexes of your entire memory store - **Archive & organize**: Hierarchical organization with categories and status tracking ## Installation Smriti MCP is published on PyPI as [`smriti-mcp`](https://pypi.org/project/smriti-mcp/). ### With pip Install into your current Python environment: ```bash pip install smriti-mcp ``` Then verify the CLI is available: ```bash smriti-mcp --help ``` ### With uv Install Smriti as a persistent command-line tool: ```bash uv tool install smriti-mcp ``` Or run it directly without a separate install: ```bash uvx smriti-mcp --help ``` ### From source for development ```bash git clone https://github.com/deepak-bhardwaj-ps/smriti-mcp.git cd smriti-mcp pip install -e . ``` ## Quick Start ### 1. Run the server locally ```bash smriti-mcp server --memory-root ~/.smriti/memory ``` By default, Smriti uses `~/.smriti/memory`. You can override it with: ```bash export SMRITI_MEMORY_ROOT="$HOME/.smriti/memory" smriti-mcp…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.