# saor-mcp

Your AI remembers now. MCP server for [saor.io](https://saor.io) — persistent brain that compounds across every session.

## Setup

One command. No config files to edit.

```bash
npx saor-mcp --setup --key sk_YOUR_KEY
```

This writes your `.mcp.json` and adds brain instructions to `CLAUDE.md`. Restart your AI tool and the brain loads automatically. Every project feeds the same brain.

## What it does

Every AI tool forgets between sessions. saor gives them a brain.

- **Read** — load the brain at session start. Identity, voice, memories, constraints, agent instructions. You pick up where the last session left off.
- **Write** — save memories as you learn. Tag them. The brain auto-links related knowledge across all your projects.
- **Compound** — memories that get used get stronger. Unused ones fade. The brain behaves like a real brain.

## Tools

| Tool | What it does |
|------|-------------|
| `brain_context` | Load the full brain. Call at START of every session. |
| `brain_remember` | Write a memory with tags. Do this CONTINUOUSLY as you work. |
| `brain_query` | Ask the brain a question. |
| `brain_identity` | Load voice, values, positioning (lighter than full context). |
| `brain_memories` | List stored memories, filtered by type or tier. |
| `brain_absorb` | Feed raw text — CLAUDE.md, brand docs, READMEs. |
| `brain_feedback` | Report what worked. Performance memories shape future recall. |
| `brain_create` | Create a new brain for a new project. |
| `brain_list` | List all brains in your account. |

## Features

- **Zero config** — no project ID needed. Auto-discovers your brains.
- **Cross-brain context** — `scope: "all"` thinks across every brain at once.
- **Tags + auto-linking** — memories link by tag overlap across all projects.
- **Background loading** — MCP resource auto-surfaces the brain without explicit calls.
- **Agent-friendly 429** — when the free limit hits, the error message tells you exactly what to say to your human.

## Pricing

- **Free** — unlimited brains, unlimited reads, 200 memory writes/month
- **Pro** — $3/month, unlimited everything

## Manual config

If you prefer manual setup over `--setup`:

```json
{
  "mcpServers": {
    "saor": {
      "command": "npx",
      "args": ["-y", "saor-mcp"],
      "env": {
        "SAOR_API_KEY": "sk_your_key"
      }
    }
  }
}
```

## Links

- [saor.io](https://saor.io) — sign up, get your key
- [For AI agents](https://saor.io/for-agents) — if you're an AI reading this
- [API docs](https://saor.io/llms.txt) — LLM-readable overview

## License

MIT