kbdb MCP server

Read from the package source without running it. The installed server may list more.

• auto-capture-review

  Propose knowledge for storage and let the user confirm it, when the host supports elicitation.

• check

  Verify the integrity of the knowledge base. Reports checksum mismatches, orphan sections, broken references, and circular reference chains.

• consolidate

  Propose groups of stored sections that could become one, so a knowledge base of twenty overlapping notes can become a few good ones. Proposes ONLY -- nothing is merged. Each group reports its weakest link. Without an entailment judge kbdb CANNOT tell whether a group disagrees with itself; read every section before merging it.

• content

  Compose a rendered Markdown document from one or more kbid or docid identifiers.

• contradictions

  Report pairs of stored sections covering the same ground, to read together before trusting either. Similarity finds pairs; it cannot judge agreement. Without an entailment model every pair reads "related", and no "contradicts" means nothing was asked, not that nothing conflicts.

• export

  Export the knowledge base as a self-contained directory snapshot (sections, documents, catalog -- no indexes).

• gaps

  Report what this knowledge base is repeatedly asked and answers badly, worst first. Call it to decide what to learn next. Ranking is triage, not measurement: the log records how each search went, never whether the answer helped.

• gcwrite action

  Remove unreferenced sections from the knowledge base. A section is eligible when no document manifest references it.

• history

  List every revision of a section, oldest first, and name the current one. Call it when a kb-id you hold no longer appears in search: revisions are retired, not deleted, so a stale kb-id still leads to the text that replaced it. A section revised once has two revisions; one never revised has one.

• learn

  Store durable knowledge in the agent's second brain.

• mark_result

  Record whether a recalled section answered a query. Accumulates real usage into an eval dataset. Call it once you know whether a result helped, including when it did not -- a wrong answer is the more useful judgement.

• neighbourhood

  List what relates to a section and HOW, so you can decide what to read next. Eight relations: supersedes, superseded-by, parent, child, sibling, references, referenced-by, similar. Seven are recorded facts; only "similar" is inferred from a cosine. Related is not relevant -- judge these against your task.

• rebuild

  Reconstruct all index files from section files and document manifests on disk. Use this to recover from index corruption.

• recall

  Expand remembered context after search. Retrieves full content and context for sections by identifier, returning section text, level, parent, metadata, references, and back-references. Call it on the kbids search returned. Use maxTokens to bound the payload, and format: compact when you only need the content.

• retrieve

  Low-level fetch of a section or document by identifier. For AI agent workflows, prefer `recall` which includes metadata, context, and back-references.

• save_evals

  Validate and persist retrieval eval cases drafted via the eval-generate prompt. Rejects cases whose kbids do not resolve, and drops duplicates. Call it only with kbids a search actually returned; invented ids fail the whole batch.

• search

  Recall relevant knowledge by ranked keyword and semantic (hybrid) relevance. Returns ranked results with heading, snippet, matched terms, level, parent, and sectionType. Sections from the same document receive a sibling score boost when multiple sections match. Use multiple short keyword queries for best coverage. Use recall for full content.

• status

  Get knowledge base status including document count, section count, index size, and cache statistics.

• unlearnwrite action

  Remove a section from the knowledge base by its kb-id, or an entire document (and its member sections) by docid.

• Code scan714 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 20 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

kbdb: common questions

Is kbdb MCP server safe?

Yes, by our scan: it is graded A (92/100). Read the kbdb safety report

How do I install kbdb?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does kbdb need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is kbdb maintained?

The last commit was 20 days ago (2026-09-01). The latest release is v1.0.3.

What can I use instead of kbdb?

Servers from other publishers that do the same job: Code Context MCP server, openchronicle-mcp server and x402 Bazaar Rank MCP server. Compare all kbdb alternatives.