# Base de Conhecimento — MCP server on mcp.ai
> Your private knowledge base: upload documents (.md, .txt, .docx, PDF, images), the platform indexes everything semantically and the agent retrieves the relevant context on demand. Built for firms. Each base is isolated, content stays encrypted on the platform. You pay only for what you store.

By: mcp.ai · official
Page: https://mcp.ai/kb

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_kb?ms=1785595200000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/kb/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/kb/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/kb/skill.md
Postman collection (v2.1): https://mcp.ai/kb/postman.json

## Tools
- kb_add_text(title: string, text: string, account?: string) — Adiciona um texto colado à base (vira um documento indexado e buscável). Útil pra notas, trechos, anotações.
- kb_get_document(document_id: string, account?: string, document_ids?: string[]) — Metadados + status de um documento específico (sem o texto cru).
- kb_ingest_url(url: string, filename?: string, account?: string) — Baixa um arquivo de uma URL (.md/.txt/.docx) e o indexa na base. Bom pra ingerir um documento remoto sem upload manual.
- kb_list_accounts() — Lista as bases de conhecimento conectadas neste install. Retorna cada base com id, rótulo e um flag is_default (true quando só há uma — não precisa passar `account` nas outras tools). Com várias bases
- kb_list_documents(account?: string) — Lista os documentos da base (id, nome, status, tamanho, nº de chunks).
- kb_remove_document(document_ids: string[], account?: string) — Remove um ou mais documentos da base (apaga o original, os chunks e o índice). Aceita uma lista de ids.
- kb_search(query: string, top_k?: integer, account?: string) — Busca semântica na base de conhecimento. Devolve os trechos (chunks) mais relevantes pra usar como contexto, com nome do arquivo de origem e score. Retrieval-only: você sintetiza a resposta a partir d

## Example prompts
- "Search my base: what's the termination notice in the standard contract?"
- "Add this note to the knowledge base"
- "List the documents in my base"

## Links
Docs: https://mcp.ai/docs/mcps/kb
Website: https://mcp.ai/mcps/kb