Documentation

OzBrain for Claude

Connect the OzBrain MCP server so Claude can read your routing index, pull articles, run tasks, and stage knowledge through the write protocol.

MCP URL

https://ozbrain.com/api/mcp

Product overview: OzBrain for Claude. Privacy: Privacy Policy.

Create your brain

Setup

A connector is how Claude talks to your OzBrain. Prefer a computer or Claude desktop for the one-time add. The Claude mobile app cannot add a custom connector; after you add it once, Claude can use it on your phone. For the click-by-click path after signup, use the guided walkthrough at /start.

  1. 1. Open Connectors

    In Claude on the web or desktop: Settings, then Connectors, then Add custom connector.

  2. 2. Paste the MCP URL

    Paste the MCP URL. Claude discovers tools from the server.

    https://ozbrain.com/api/mcp

  3. 3. Sign in and approve

    A browser window opens. Sign in to OzBrain with the email code from your inbox, then approve the connection. Later sessions reuse that approval until you revoke the client in OzBrain account settings.

Auth

OzBrain uses OAuth 2.1 through Supabase Auth. There are no long-lived API keys to paste. Each AI client gets its own grant, attributed in article and task history, and you can revoke it independently.

If Claude prompts for reconnect, open Connectors again or revoke and re-approve from your OzBrain account. Claude Code uses the same MCP URL with this command:

claude mcp add --transport http ozbrain https://ozbrain.com/api/mcp

Example prompts

Paste these after the connector is approved. Each one exercises a different tool path.

  • Map the brain

    list_brains, get_brain

    List my OzBrain brains, then open the main brain and read the routing index. Summarise what knowledge is there without inventing articles.

  • Search then read

    search, read_article

    Search my OzBrain for "welcome" (or another word from the routing index), open the best matching article with read_article, and quote one concrete fact from it.

  • Create a task

    create_task, get_task

    In my main OzBrain brain, create a task titled "Reviewer smoke check" with a short brief asking an agent to re-read the welcome article, then show me the task details.

  • Stage a note

    stage_write, get_write_status

    After reading the routing index, stage a new article slug reviewer-session-note titled "Reviewer session note" with a one-line description and a short body saying this was a directory review exercise. Do not promote it unless I ask. Show the staged write id and status.

Support

Product questions: support@ozbrain.com. Privacy: privacy@ozbrain.com. Security: support@ozbrain.com.