# brainattic

> The knowledge base your AI reads and writes — under your rules. A governed,
> multi-tenant KB that Claude, ChatGPT, Mistral, or any MCP client searches, drafts,
> and revises through real tools, with transactional edits it can roll back. EU-hosted;
> your data never goes to a third-party model.

brainattic exposes a Model Context Protocol (MCP) server. Point your agent at the
endpoint, authenticate once, and it works on your canonical docs under the rules
you set.

## Connect
- MCP endpoint: https://app.brainattic.ai/api/mcp  (Streamable HTTP, OAuth 2.1)
- Discovery card: https://brainattic.ai/.well-known/mcp/server.json
- How to connect: https://brainattic.ai/connect
- Docs — overview: https://brainattic.ai/docs
- Docs — connect (Claude, Mistral Vibe, ChatGPT, any MCP client): https://brainattic.ai/docs/connect
- Docs — authentication (OAuth 2.1): https://brainattic.ai/docs/auth
- Docs — quickstart: https://brainattic.ai/docs/quickstart
- Docs — security & data: https://brainattic.ai/docs/security
- Request a pilot: https://brainattic.ai/#pilot

## What your agent can do (50 tools)
- Search & retrieve: `kb_documents_search` (hybrid keyword+vector), `kb_chunks_retrieve` (passage-level grounding)
- Read: `kb_documents_get`, `kb_documents_get_by_slug`, `kb_documents_list`, `kb_documents_get_meta`
- Write, transactional: `kb_documents_edit_begin` -> `kb_documents_edit_apply` -> `kb_documents_edit_commit` (or `kb_documents_edit_discard`)
- Author & lifecycle: `kb_documents_create`, `kb_documents_update`, `kb_documents_archive`, `kb_documents_restore`
- Organize: projects (`kb_projects_*`) and groups (`kb_groups_*`) — create, list, attach, pin
- Attachments: `kb_attachments_upload`, `kb_attachments_list`, `kb_attachments_get`
- Versioning: `kb_revisions_list`, `kb_revisions_get`, `kb_revisions_restore`
- Governance: `kb_rules_list_for_context` — the binding conventions, surfaced before any write
- Audit: `kb_audit_log_search`, `kb_audit_events_search` — the append-only trail
- Reminders: `kb_reminders_create` (RRULE) + a per-user iCal feed

## Example calls
{ "tool": "kb_documents_search", "arguments": { "query": "incident postmortem auth", "mode": "hybrid", "limit": 10 } }
{ "tool": "kb_chunks_retrieve", "arguments": { "query": "what is our on-call escalation policy", "k": 8 } }
{ "tool": "kb_documents_edit_begin", "arguments": { "document_id": 1234 } }