API Overview

Authentication

Brainbase API requests use API keys. The Brainbase MCP uses a separate OAuth connection so compatible OAuth-capable MCP clients can authorize access without storing a Brainbase API key in their configuration.

API keys

Create an API key from Brainbase, then use it anywhere the docs show $BRAINBASE_API_KEY or <token>. For direct API requests, send the key in the Authorization header.

bash

curl "https://api.brainbaselabs.com/v2/agents" \
  -H "Authorization: Bearer $BRAINBASE_API_KEY"

Brainbase MCP

Connect through Brainbase MCP using the stable Streamable HTTP endpoint at https://api.brainbaselabs.com/mcp. Compatible clients complete authorization through Brainbase OAuth. Codex and Claude Code packages with an optional operating skill are also available.

Do not paste an API key into an MCP client

The Brainbase MCP requests mcp:all during OAuth and remains bounded by your normal Brainbase access. Keep REST API keys out of MCP URLs, headers, and installer configuration.