# Knownbase

> Knownbase is MCP-ready project memory for AI agents. It stores the working memory that
> lives outside git: decisions, debugging trails, architecture notes, and task handoffs, all
> in one fast, searchable workspace that agents read and write over the Model Context
> Protocol (MCP).

Built by ZsTechLabs (https://zstechlabs.com). Free to start (3 projects, 300 notes, 2 MCP
keys, no card required); paid plans (Go, Solo, Team, Business) add more projects, notes, and
MCP keys, each with a 7-day free trial.

## Product

- [Homepage](https://knownbase.dev/): what Knownbase is and who it's for
- [Features](https://knownbase.dev/features): full feature list
- [Pricing](https://knownbase.dev/pricing): plan comparison and limits
- [About](https://knownbase.dev/about): company background and the Agent KB heritage
- [Blog](https://knownbase.dev/blog): guides on MCP, agent memory, and handoffs ([RSS](https://knownbase.dev/blog/feed.xml))

## Blog

- [What is the Model Context Protocol (MCP)?](https://knownbase.dev/blog/what-is-mcp): plain-English intro to MCP, the client–server model, and where memory fits
- [Why AI agents need persistent memory](https://knownbase.dev/blog/ai-agent-memory): why agents forget between sessions and what a memory layer looks like
- [Agent handoffs](https://knownbase.dev/blog/agent-handoffs): how to write a handoff the next session can pick up
- [Give Claude Code and Codex memory over MCP](https://knownbase.dev/blog/connect-claude-code-mcp-memory): step-by-step setup tutorial

## MCP integration

- Endpoint: `POST https://knownbase.dev/mcp`, hand-rolled JSON-RPC 2.0 (protocol
  `2025-06-18`). Two auth paths: `Authorization: Bearer kb_...` (an API key generated from a
  workspace's Settings page), or OAuth 2.1 with dynamic client registration and PKCE (discover via
  `GET /.well-known/oauth-authorization-server` and `/.well-known/oauth-protected-resource`; see
  `docs/KNOWNBASE_MCP_COMPATIBILITY.md` in the repo for the full flow).
- Tenant tools exposed: `list_projects`, `search_notes`, `get_note`, `get_notes`, `upsert_note`,
  `delete_note`, `list_note_revisions`, `get_note_revision`, `workspace_info`, `usage_summary`,
  `rename_project`, `rename_tag`, and `backup_project`. The compatibility name `backup_now` is
  reserved for server operators and is refused for tenant credentials.
- Every note is scoped to the calling API key's workspace; nothing is shared across tenants.
- `search_notes` results are lean by default (snippet + metadata, no full note body) to save
  tokens. Search first, then use `get_note`/`get_notes` to fetch the specific hits you need.
- Create a free workspace at https://knownbase.dev/ to get started.

## Contact

- [Contact](https://knownbase.dev/contact): support form
- Email: hello@knownbase.dev

## Optional

- [Terms of Service](https://knownbase.dev/terms)
- [Privacy Policy](https://knownbase.dev/privacy)
- [Refund Policy](https://knownbase.dev/refund)