Kairn
Local-first knowledge engine for AI agents: memory, graph, and recall.
Connector by primeline-ai · GitHub account verified by the MCP Registry
Chalk Labs
Need help deploying Kairn?
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 Desktop. Read the repository before you give any tool access to your data.
MCP bundle (.mcpb): open it with Claude Desktop.
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, install config and code. Checked Oct 25, 2026.
- Tools
- 9 read · 7 write · 2 delete · 4 not yet classified
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Downloaded binary
Tools by what they do 22
Read from the source code; the running server may list different tools.
Read 9 · Look things up without changing anything.
kn_crossrefkn_doctorkn_ideaskn_preferencekn_projectskn_querykn_recallkn_relatedkn_status
Write 7 · Create, change, send or run things.
kn_addkn_connectkn_ideakn_judgekn_learnkn_projectkn_save
Delete 2 · Delete, drop, revoke or wipe things.
kn_prunekn_remove
Not yet classified 4 · We could not tell from the name and description.
kn_contextkn_logkn_memorieskn_promote_pending
Network hosts it talks to 3
github.com· found in install command, codeprimeline.cc· found in coderaw.githubusercontent.com· found in code
Files it touches
~/.claude/projects- Your home directory (~)
~/.kairn
Tools (22)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
kn_addAdd node to knowledge graph. Auto-links via FTS5.
kn_connectCreate typed, weighted edge between nodes.
kn_contextKeywords to relevant subgraph with progressive disclosure.
kn_crossrefFind similar solutions from other workspaces.
kn_doctorRead-only Kairn health diagnostics. Returns a structured envelope with per-check verdicts and a roll-up summary. Identical JSON shape to `kairn doctor --json` (envelope parity). Safe to call any time; checks never mutate workspace state.
kn_ideaCreate or update idea with graph links.
kn_ideasList and filter ideas by status/score.
kn_judgeRecord a typed relationship judgment between two nodes. Strict-mode wrapper around kn_connect: only the 5 canonical relation verbs (conflicts_with, supersedes, compatible, scoped, related) are accepted. Use after kn_learn returns a non-empty candidates[] list to assert how the new node relates to an existing one. For legacy or system-generated edges, use kn_connect (lax mode).
kn_learnStore knowledge from conversation. Creates node (high) or experience (medium/low).
kn_logLog progress or failure entry.
kn_memoriesExperience search. Filters on time-decay, reports match-aware relevance.
kn_preferenceCapture a stated user preference at utterance time. The dedicated write path for preferences: stores a `preference`-type experience with the longest half-life of any type (durable by default). Call it the moment a preference is expressed - the host model hearing the preference is the extraction step; Kairn's server stays deterministic and never runs an LLM.
kn_projectCreate or update project (upsert).
kn_projectsList projects and switch active.
kn_promote_pendingPromote experiences flagged by the auto-promote SQL trigger. The exp_auto_promote trigger sets needs_promotion=1 when an experience's access_count crosses 5 (via the read-path touch_accessed wiring from Phase 8). This tool consumes those flags and turns each flagged experience into a permanent graph node via the existing _promote() path. Idempotent: repeatedly safe to call; no-op when nothing is flagged. Returns stats including the list of newly created node ids.
Show 7 more tools
kn_pruneRemove expired experiences (archive first).
kn_querySearch nodes by text, type, tags, or namespace.
kn_recallSurface relevant past knowledge for context.
kn_relatedFind nodes connected to a starting point.
kn_removeSoft-delete node or edge. Supports undo.
kn_saveSave experience with configurable decay.
kn_statusGraph stats, health, and system overview.
Signals
- Stars
- 13
- Forks
- 3
- Open issues
- 0
- Last commit
- Oct 11, 2026 (19 days ago)
- Last release
- Oct 11, 2026 (19 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.primeline-ai/kairn- Version
- 0.3.1
- Auth
- No auth
- License
- MIT
- Repository
- github.com/primeline-ai/kairn
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from primeline-ai
- 0.613score
universal-planning
primeline-ai
The Universal Planning Framework rulebook - 10-step planning pipeline, 8 domain profiles, 21 anti-patterns with detection rules, mandatory FAILED conditions…
SkillBFreshness: B★ 46Claude Code +9 - 0.610score
vehicle-selection
primeline-ai
The execution-vehicle rubric - decides silently how each plan phase runs (single agent, parallel sub-agents, agent team, background session, dynamic workflow…
SkillBFreshness: B★ 46Claude Code +9 - 0.451score
auto-run
primeline-ai
Autonomous personalized research loop.
SkillDFreshness: D★ 13Claude Code +9
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 Kairn 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
Kairn MCP server. Agent Mart. https://agentmart.dev/connectors/primeline-ai-kairn (last updated 2026-10-24)