# ValorBrain > Company brain for people and AI agents. Persistent, sourced, correctable memory. > Hosted product (this file), not an agent orchestrator. ## For agents reading this file ### Don't have a key? ```bash npx @valorbrain/cli init --agent --agent-caller --json ``` Replace `` with who you are (`claude-code`, `cursor`, `grok`, `hermes`, `zcode`, …). Identity is self-declared, never inferred. This mints a `vb_agent_` REST key against https://valorbrain-api.valor.digital in a few seconds. Claim later with `npx @valorbrain/cli init --email `, same key, memories preserved. `npx @valorbrain/cli help --json` is the command contract. There is no `setup harness` subcommand on the published CLI. ### Routing - REST (search, documents, agent signup): https://valorbrain-api.valor.digital, Authorization: Bearer vb_agent_… - MCP: https://mcpbrain.valor.digital/mcp, Authorization: Bearer vbm_… or OAuth 2.1 DCR - App / ingest with fk_ keys: https://valorbrain.valor.digital - Do **not** send /search or /documents to mcpbrain.valor.digital: non-OAuth paths there are MCP transport (401). - After retrieve, call memory_used with the docids you relied on. - Canonical write tool is memory_store, not store (deprecated). - Text is stored verbatim. Do not translate. OpenAPI (this site): https://docs.valorbrain.com.br/openapi.json MCP server card (product): https://valorbrain.valor.digital/.well-known/mcp/server-card.json Full docs dump: https://docs.valorbrain.com.br/llms-full.txt ## Identify the user's setup - CLI config at ~/.valorbrain/config.json → they already have a REST key. Use add/search. - MCP client with vbm_ token → tools/list, whoami, memory_retrieve, memory_store, memory_used. - Human in a browser → https://valorbrain.valor.digital ## Pages # Documentação - [Introdução](/docs): ValorBrain é o cérebro da empresa: memória operacional compartilhada para pessoas e agentes, com fontes citáveis e fatos corrigíveis. - [Começo rápido](/docs/quickstart): Quatro comandos de um shell limpo até uma memória pesquisável. Medido, não estimado. - [CLI](/docs/cli): @valorbrain/cli: memória agent-native direto do shell. Zero dependências, Node 18+. - Conceitos - [Conceitos](/docs/concepts): Cérebro da empresa, hosts, tokens, coleções e corrigibilidade. - [Hosts](/docs/concepts/hosts): REST, MCP e o app são três hostnames com três funções. Misturá-los é a falha de integração mais comum. - [Tokens](/docs/concepts/tokens): Três prefixos, três funções. O token carrega o tenant. Não invente um header de tenant. - [Como funciona a memória](/docs/concepts/memory): Armazene um resultado tipado, recupere com busca híbrida, cite o que você usou. - [Corrigibilidade](/docs/concepts/correctability): Um documento em prosa pode ter meses e ainda rankar em primeiro. Keyed facts têm data e um nível de autoridade, e vencem. - [Como a recuperação funciona](/docs/concepts/how-retrieval-works): O pipeline híbrido, o modelo de memória e a maquinaria de confiança: uma página, sem enrolação. - [Avaliação e benchmarks](/docs/concepts/evaluation): O que os números medem, quais são reproduzíveis, e as regras que os mantêm honestos. - [Coleções e vaults](/docs/concepts/collections-vaults): Os dois eixos da organização da memória: o que é uma coleção, o que é um vault, e as regras que surpreendem. - MCP - [MCP](/docs/mcp): Streamable HTTP no mcpbrain, ou stdio via @valorbrain/connect. Bearer vbm_ ou OAuth 2.1. - [Ferramentas MCP](/docs/mcp/tools): Nomes canônicos de src/tool-catalog.ts. Aliases continuam funcionando; integrações novas devem chamar a ferramenta canônica. - REST - [REST](/docs/rest): Busca híbrida e CRUD de documentos no valorbrain-api. Um token basta. - Integrações - [Integrações](/docs/integrations): Editores, harnesses e conectores que existem de verdade hoje: não os que um README torceu pra existir. - [Claude Code](/docs/integrations/claude-code): MCP via Streamable HTTP, ou stdio via @valorbrain/connect. - [Cursor e Windsurf](/docs/integrations/cursor): Registro dinâmico de cliente OAuth 2.1, ou um bearer token vbm_. - [Grok](/docs/integrations/grok): Templates no valorbrain-harness mais o proxy stdio publicado. - [Hermes](/docs/integrations/hermes): Plugin MemoryProvider nativo. Isto não é "10 ferramentas MCP num prompt". - [OpenClaw](/docs/integrations/openclaw): Plugin de slot memory com injeção por turno e extração no fim da sessão. - [ZCode](/docs/integrations/zcode): Plugin de marketplace: hooks, skill e recall por prompt. - [Conectores](/docs/integrations/connectors): Notion, Google Drive, Slack, GitHub e Linear. Você traz as credenciais OAuth. Starter para cima. - API - [Referência de API](/docs/api): Ferramentas MCP, endpoints REST e os dois documentos OpenAPI diferentes que existem hoje. - [Referência das ferramentas MCP](/docs/api/mcp-tools): O catálogo, não um screenshot. Aliases incluídos para clientes antigos continuarem funcionando. - [Referência REST](/docs/api/rest): Rotas do engine voltadas ao cliente. O host é sempre valorbrain-api.valor.digital. - [MCP catalog (generated)](/docs/api/generated-mcp): src/tool-catalog.ts, regenerated at docs build. Do not edit. - [MCP tool schemas (generated)](/docs/api/generated-mcp-schemas): registerTool() metadata from src/mcp-tools.ts, rebuilt with the docs. - [REST (generated)](/docs/api/generated-rest): Every path in the engine OpenAPI, regenerated at docs build. Do not edit. - Guias - [Guias](/docs/guides): Passeios curtos que batem com os comandos que o CLI publicado realmente executa. - [Primeira memória em 15 segundos](/docs/guides/first-memory): Máquina limpa, pacote publicado, sem credenciais nossas. - [Claim de conta de agente](/docs/guides/claim): Vincular um e-mail sem rotacionar a chave. - [Corrija um fato errado](/docs/guides/correct-a-fact): Um documento pode ranquear em primeiro e ainda estar errado. Escreva um keyed fact. A próxima sessão não deve repetir o erro. - [Cookbook REST](/docs/guides/rest-cookbook): Receitas funcionais contra a API viva do engine: cada campo verificado contra a spec em execução. - [Cookbook MCP](/docs/guides/mcp-cookbook): Fluxos de agente sobre as 92 ferramentas MCP: cada parâmetro verificado contra os schemas de registerTool. - [On-premise (Enterprise)](/docs/guides/on-prem): A arquitetura que implantamos na sua rede no plano Enterprise: stack, bancos, serviços e gates de qualidade. - [Team OS](/docs/guides/team-os): Briefing, handoffs, inbox e escalonamento humano: o time humano+agente operando sobre a mesma memória. - [Grafo de conhecimento](/docs/guides/knowledge-graph): Entidades, triplas com validade temporal, quarentena SHACL e explicabilidade: o KG que não aceita fato sem prova. - [Uso e valor entregue](/docs/guides/usage-value): O ledger de uso, o pré-agregado diário e a saúde do índice: medir sem estimar.