Cross-session knowledge base over the Model Context Protocol. Local SQLite, no cloud.
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":"canola-persistent-kb-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.
# persistent-kb-mcp A Model Context Protocol (MCP) server that gives any MCP-capable AI agent a **persistent, searchable knowledge base** stored locally in a single SQLite file. Survives session restarts, context compaction, and machine reboots. [](https://pypi.org/project/canola-persistent-kb-mcp/) [](LICENSE) ## What it does Exposes 5 MCP tools for interacting with a local SQLite knowledge base: | Tool | Purpose | |---|---| | `kb_add` | Save a fact, lesson, decision, or reference (with title, kind, tags) | | `kb_search` | Full-text search via SQLite FTS5 | | `kb_show` | Fetch a single entry's full content + metadata | | `kb_list` | Browse entries, filter by kind / tag / date | | `kb_tag` | Add or remove tags on an existing entry | Storage default: `~/.persistent-kb/kb.sqlite` (override via `KB_DB`). ## Why AI coding agents lose everything between sessions. This server lets your agent **save and recall** facts across sessions — without sending data to a cloud service. ## Install Requires Python 3.10+. ```bash pip install canola-persistent-kb-mcp ``` Or from source: ```bash pip install git+https://github.com/0x67108864/persistent-kb-mcp.git ``` ## Configure your agent ### Claude Code Add to your `~/.claude/mcp.json` (or the project-local equivalent): ```json { "mcpServers": { "persistent-kb": { "command": "persistent-kb-mcp" } } } ``` Restart Claude Code and the 5 `kb_*` tools become available. ### Codex CLI / Cursor / other MCP-capable runtimes Each runtime has its own way of registering MCP servers; the `command` is always `persistent-kb-mcp`. Refer to your runtime's MCP configuration documentation. ## Quickstart Once configured, try these in your agent: ``` "Remember that Stripe's standard payout schedule in Japan is 7 days, domestic card fee is 3.6% + ¥40." → agent calls kb_add(title=..., ki…
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.