dnotitia avatar

Akb

dnotitia/akb

A Git-backed knowledge vault that gives agents structured read/write access to organizational memory. Exposes hybrid search (semantic plus BM25), document CRUD with frontmatter relations, per-document SQL tables, and a URI graph over MCP. Every write commits to a bare Git repo and indexes into PostgreSQL with pluggable vector stores. Works with Claude Desktop, Cursor, Windsurf via the akb-mcp stdio proxy, or direct HTTP with bearer tokens. Ships agent plugins for Claude Code that auto-capture session notes and inject vault context into coding workflows. Reach for this when you need agents to maintain long-term memory across sessions with full version history and cross-document links, not just ephemeral context windows.

GitHub stars
52
tools
32
auth
Secret needed
transport
STDIO
env vars
2
last updated
Jun 6, 2026

Tools

32 tools

Public tool metadata for what this MCP can expose to an agent.

akb_list_vaultsVault management

Vault management

No parameter schema in public metadata yet.

akb_create_vaultVault management

Vault management

No parameter schema in public metadata yet.

akb_putDocument CRUD (revision + indexing)

Document CRUD (revision + indexing)

No parameter schema in public metadata yet.

akb_getDocument CRUD (revision + indexing)

Document CRUD (revision + indexing)

No parameter schema in public metadata yet.

akb_updateDocument CRUD (revision + indexing)

Document CRUD (revision + indexing)

No parameter schema in public metadata yet.

akb_deleteDocument CRUD (revision + indexing)

Document CRUD (revision + indexing)

No parameter schema in public metadata yet.

akb_put_fileFile attachments — proxy-side (requires local filesystem)

File attachments — proxy-side (requires local filesystem)

No parameter schema in public metadata yet.

akb_get_fileFile attachments — proxy-side (requires local filesystem)

File attachments — proxy-side (requires local filesystem)

No parameter schema in public metadata yet.

akb_update_fileFile attachments — proxy-side (requires local filesystem)

File attachments — proxy-side (requires local filesystem)

No parameter schema in public metadata yet.

akb_delete_fileFile attachments — proxy-side (requires local filesystem)

File attachments — proxy-side (requires local filesystem)

No parameter schema in public metadata yet.

akb_put_imageValidated inline Markdown images — proxy-side in akb-mcp 2.2+

Validated inline Markdown images — proxy-side in akb-mcp 2.2+

No parameter schema in public metadata yet.

akb_discard_imageValidated inline Markdown images — proxy-side in akb-mcp 2.2+

Validated inline Markdown images — proxy-side in akb-mcp 2.2+

No parameter schema in public metadata yet.

akb_create_tableTabular content — per-doc tables + SQL

Tabular content — per-doc tables + SQL

No parameter schema in public metadata yet.

akb_alter_tableTabular content — per-doc tables + SQL

Tabular content — per-doc tables + SQL

No parameter schema in public metadata yet.

akb_drop_tableTabular content — per-doc tables + SQL

Tabular content — per-doc tables + SQL

No parameter schema in public metadata yet.

akb_sqlTabular content — per-doc tables + SQL

Tabular content — per-doc tables + SQL

No parameter schema in public metadata yet.

akb_browseTree traversal (collection → docs)

Tree traversal (collection → docs)

No parameter schema in public metadata yet.

akb_searchHybrid search (dense + BM25)

Hybrid search (dense + BM25)

No parameter schema in public metadata yet.

akb_grepLiteral grep

Literal grep

No parameter schema in public metadata yet.

akb_drill_downSection-level retrieval

Section-level retrieval

No parameter schema in public metadata yet.

akb_relationsKnowledge graph

Knowledge graph

No parameter schema in public metadata yet.

akb_linkKnowledge graph

Knowledge graph

No parameter schema in public metadata yet.

akb_unlinkKnowledge graph

Knowledge graph

No parameter schema in public metadata yet.

akb_graphKnowledge graph

Knowledge graph

No parameter schema in public metadata yet.

akb_editIn-place edit, diff, revision history

In-place edit, diff, revision history

No parameter schema in public metadata yet.

akb_diffIn-place edit, diff, revision history

In-place edit, diff, revision history

No parameter schema in public metadata yet.

akb_historyIn-place edit, diff, revision history

In-place edit, diff, revision history

No parameter schema in public metadata yet.

akb_grantPermission boundaries — per-user, per-org, public

Permission boundaries — per-user, per-org, public

No parameter schema in public metadata yet.

akb_revokePermission boundaries — per-user, per-org, public

Permission boundaries — per-user, per-org, public

No parameter schema in public metadata yet.

akb_set_publicPermission boundaries — per-user, per-org, public

Permission boundaries — per-user, per-org, public

No parameter schema in public metadata yet.

akb_publishPublic publication

Public publication

No parameter schema in public metadata yet.

akb_unpublishPublic publication

Public publication

No parameter schema in public metadata yet.

Sponsors

Configuration

AKB_MCP_URL*

Your AKB backend MCP endpoint, e.g. https://akb.example.com/mcp/ — or try the public demo at https://akb-demo.agent.seahorse.dnotitia.ai/mcp/

AKB_PAT*secret

AKB Personal Access Token (akb_...). Create one in your AKB instance, or sign up on the public demo with any email to get one.

Readme

AKB — agents reading and writing into a permissioned knowledge vault of docs, tables, and files, linked by a URI graph

AKB — Agent Knowledge Base

Organizational memory for AI agents. PostgreSQL-native knowledge base served over the Model Context Protocol (MCP) — agents read and write directly with hybrid semantic + keyword search, structured tables, files, and a URI graph. Drop-in alternative to Confluence / Notion for Claude Code, Cursor, Windsurf, and any MCP-aware agent.

License: BSL 1.1 npm: akb-mcp MCP

Works with

Any agent client that speaks MCP (Streamable HTTP or stdio):


View the full README on GitHub

Details

Repository
github.com/dnotitia/akb
Categories
AI & LLM Tools, Developer Tools, Search & Web Crawling
Package
akb-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1mastercard avatarMastercard Developers MCPmastercard/developers-agent-toolkitAccess Mastercard Developers APIs, documentation, and API specifications through MCP.0stars
2phasespace-labs avatarPalinodephasespace-labs/palinodeInspectable, correctable project memory in git-versioned Markdown for AI agents.46stars
3raphasouthall avatarNeuroStackraphasouthall/neurostackToken-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.43stars
4mybolide avatarMcp Probe Kitmybolide/mcp-probe-kitSpec-driven dev workflow MCP: start_* orchestration, memory, GitNexus, quality gates.41stars
5artkeyai avatarbhivedartkeyai/bhived-mcpShared memory for AI agents: query proven fixes, avoid known mistakes, and find skills and MCPs.35stars
6diaaaj avatarA Mem Mcpdiaaaj/a-mem-mcpSelf-evolving memory system for AI agents34stars