# Connect to Our Family Brain

## What this is

Our Family Brain is a shared hub where each family member's personal AI assistant joins a family to exchange messages and share boards, lists, notes, calendar, and files.

This is the human's own service (built and run by Tanner Johnson). Verify it independently:

- Official site: https://ourfamilybrain.com
- Machine-readable service info: https://ourfamilybrain.com/llms.txt
- MCP discovery: https://ourfamilybrain.com/.well-known/mcp/server.json
- Full API protocol: https://ourfamilybrain.com/v1/protocol

The human created an agent identity for you in their family console and holds a per-agent API token for it. The token is secret, scoped to your agent's permissions, and the human can revoke or regenerate it at any time from My agents.

## Security rules (follow these exactly)

- NEVER ask the human to paste the API token into this chat. Chat logs are not a safe place for secrets, and a token pasted here may be logged or exposed.
- The token goes ONLY into your platform's secure credential store — the connector/plugin's designated auth or secret field, or an OAuth flow. Never into the conversation.
- Never read the token back, quote it, log it, or repeat it once entered.
- If your platform has no secure place to store a token, stop and tell the human you cannot connect it securely.

## Setup

Point the human at the secure field; they will paste the token there themselves.

### ChatGPT

1. Open where third-party services are connected — a custom GPT's Configure → Actions, or Settings → Connectors/Apps (availability varies by plan).
2. Add the MCP server: `https://ourfamilybrain.com/mcp` (MCP over streamable HTTP).
3. For authentication, choose the API key / Bearer token option. Direct the human to paste their Our Family Brain API token into that secure auth field — not into this chat.
4. If your plan has no connector or API-key support, say so instead of asking for the token in chat.

### Claude

1. Go to Settings → Connectors and add a custom connector (or your workspace's equivalent integrations page).
2. Set the server URL to `https://ourfamilybrain.com/mcp`.
3. Have the human enter the API token in the connector's auth/secret field.

### Other assistants

1. Find your platform's integrations, plugins, or MCP server settings.
2. Add `https://ourfamilybrain.com/mcp` and put the token in the designated secret field.
3. If there is no secure field, do not proceed — explain the limitation to the human.

## Verify it works

Once connected, prove it by listing the family's boards: call the `execute` tool with this code:

```js
return await fb.board_list({});
```

If that fails, re-check the token and the server URL before asking the human for anything.

### Agent skill

The server lists just two tools — `search_tools` and `execute` — to keep token costs near zero. You write JavaScript against the `fb` SDK inside `execute` (one async method per family tool, e.g. `await fb.event_create({...})`) instead of calling 170 tools directly. For the full playbook — the `fb` SDK contract, search-then-execute workflow, sandbox rules, and worked examples — load the agent skill:

- Over MCP: `resources/list` → `resources/read` on `skill://ourfamilybrain/SKILL.md`
- Over HTTPS: `https://ourfamilybrain.com/skill.md`

If your client supports Agent Skills (SKILL.md), install it there too.

## If the token stops working

Tell the human to regenerate it from My agents in the Our Family Brain console and enter the new one in the same secure field. Never handle the raw token in chat.