Skip to content

Connect your agents and systems to ValorBrain

The shortest path from the terminal to memory: one command that sets up your agents, MCP with a bearer token, a REST API with an OpenAPI contract and the agent-ready layer of this domain. The full documentation lives at docs.valorbrain.com.br.

Create a free accountRead the docs

What the command does

Paste it in a terminal on the computer where you use Claude Code, Codex, Cursor, Gemini CLI, Kiro, OpenCode or Hermes. It finds the agents, opens the browser for you to approve the computer, and sets up MCP, the memory rules and hooks in each one, with one token of yours for the computer, used by all of them.

No account yet? You create it on the same approval screen. On Windows without Node.js, the script offers to install the LTS with winget. The hooks send the prompt of each turn to your workspace to fetch memory; no hooks: --mcp-only (Hermes has no hooks: its memory plugin keeps sending the prompt; use --prompt off there); --remove undoes everything. What leaves the machine and how to turn it off: https://docs.valorbrain.com.br/en/docs/concepts/what-leaves-your-machine

Or set it up by hand

Connect your agent over MCP

Pick your client, paste the vbm_ token and call memory_prepare to check the connection. Without an account, the agent creates its own with one command; the full walkthrough, which you can send straight to the agent, is at /connect.

terminal
npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-code

No hooks (MCP and rules, nothing sent per turn):

terminal
npx -y @valorbrain/connect@latest --token <vbm_…> --harness claude-code --mcp-only

Or MCP by hand:

terminal
claude mcp add --transport http --scope user valorbrain https://mcpbrain.valor.digital/mcp --header "Authorization: Bearer <vbm_…>"
.well-known/mcp.json
{  "mcpServers": {    "valorbrain": {      "type": "http",      "url": "https://mcpbrain.valor.digital/mcp",      "headers": {        "Authorization": "Bearer <vbm_…>"      },      "description": "ValorBrain shared company memory for AI agents: retrieve, store, handoffs, audit. The MCP accepts only vbm_ tokens. No account: npx -y @valorbrain/cli@latest init --agent --agent-caller <agent-name> --json returns mcp_token. With an account: https://valorbrain.valor.digital/settings/mcp-tokens.",      "docs": "https://valorbrain.com.br/connect.md"    }  }}

REST API

A REST API with an open contract

The public SaaS API answers at this base URL and the full contract is OpenAPI 3.1. The browsable reference lives inside the app, behind the workspace login.

Base URL

https://valorbrain-api.valor.digital

OpenAPI specification
openapi.json
Browsable reference (workspace login)
api-docs
API service catalog
api-catalog

Authentication

Bearer token in the Authorization header. MCP accepts only the vbm_ token; the REST API uses the vb_agent_ key (agent account) or vb_. auth.md documents each case, including OAuth and a device flow for headless clients.

Read auth.md

First step

The sandbox is the product

There is no separate test environment: you try it in your own workspace, with one real project and the agents you already use. One free project to prove it in your real workflow; the paid steps have their prices published at /pricing.

Connect your first agent

The link goes through the product login and returns to the connection onboarding.

For AI agents

This site speaks to machines too

The public domain is agent-ready: pages exist as clean Markdown at the same URL with a .md suffix (full index in llms.txt), and the discovery files live at the root.