Connect an agent

ValorBrain speaks MCP over HTTP. Use OAuth when your client supports it, or paste a dedicated MCP token into the client config.

Connection

Endpoint: https://mcpbrain.valor.digital/mcp
Transport: Streamable HTTP
Preferred auth: OAuth 2.1
Direct-token auth: Authorization: Bearer vbm_…

Authorize the agent

An MCP token carries the workspace, user and agent scope of the person who created it. It is shown once. Create one token per agent so activity stays attributable and one agent can be revoked without stopping the others.

Guided setup Create an MCP token Create an account

Client configuration

Use OAuth where the card shows an OAuth command. For token-based configs, replace <your-token> with the dedicated MCP token. Any client that supports MCP over HTTP can connect.

Claude Code (CLI)

terminal (one-time)

Run this once. Claude Code opens the ValorBrain OAuth flow on first use.

claude mcp add --transport http valorbrain \
  https://mcpbrain.valor.digital/mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)

Paste into the config file, then restart Claude Desktop.

{
  "mcpServers": {
    "valorbrain": {
      "url": "https://mcpbrain.valor.digital/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Cursor

Settings → MCP → Add new MCP Server

In Cursor: Settings → MCP → Add, choose "HTTP", paste URL + header.

{
  "mcpServers": {
    "valorbrain": {
      "url": "https://mcpbrain.valor.digital/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Hermes Agent

~/.hermes/config.yaml or profiles/<persona>/config.yaml

Paste under mcp_servers. One token per human or per Hermes persona. Identity comes from the token.

# Hermes: ValorBrain MCP (tools)
mcp_servers:
  valorbrain:
    url: https://mcpbrain.valor.digital/mcp
    headers:
      Authorization: Bearer <your-token>
    timeout: 180

# Optional lifecycle (MemoryProvider): memory.provider: valorbrain
# Mint a separate token per persona with intended_agent_platform=slug

ZCode / valorcode (OpenCode)

opencode.json (project root) or ~/.config/opencode/opencode.json

Add an "mcp" entry under the project opencode.json. Key is the server name.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "valorbrain": {
      "type": "remote",
      "url": "https://mcpbrain.valor.digital/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Kiro CLI

.kiro/settings/mcp.json (project) or ~/.kiro/settings/mcp.json (all projects)

Paste into the Kiro MCP config file and restart Kiro.

{
  "mcpServers": {
    "valorbrain": {
      "url": "https://mcpbrain.valor.digital/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Machine-readable discovery

An agent can discover the endpoint, OAuth metadata, credential matrix and reusable workflows without scraping this page.

curl -fsS https://valorbrain.valor.digital/.well-known/mcp/server-card.json
curl -fsS https://valorbrain.valor.digital/.well-known/oauth-authorization-server
curl -fsS https://valorbrain.valor.digital/auth.md
curl -fsS https://valorbrain.valor.digital/.well-known/agent-skills/index.json

Verify before using memory

Call tools/list, then whoami to confirm the workspace and user. Stop if either identity is unexpected. Read with memory_retrieve and save durable outcomes with memory_store.

Clients without MCP can use the engine REST API at https://valorbrain-api.valor.digital. Read the REST reference.