io.br8n/mcp
Owned, portable working memory: a plain-files markdown brain any model can read and cite.
Open source Open in the app JSON README (API)
About
Owned, portable working memory: a plain-files markdown brain any model can read and cite.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- io.br8n
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.2
- Last push
- 2026-08-24T22:13:56Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:36
- Updated
- 2026-08-29 03:01:36
- Origin id
io.br8n/mcp
README
# br8n
**Owned, portable working memory.** A plain-files brain template and a tiny MCP server that lets any model read it.
> Everything your team has taught a chat tool about how the work gets done is sitting inside somebody else's login. Switch tools and you're a stranger again. This repo is the other direction: the memory lives in files you own, and the model is just a reader.
br8n is the AI delivery practice of [Branded Mayhem Collective](https://brandedmayhem.com). This is the open part: the file layout and the door. The hosted install adds retrieval, governance, and someone running it with you — on the same files, which never change shape. [br8n.io](https://br8n.io)
## What's here
- `template/brain/` — the brain layout: `how-we-work/`, `decisions/`, `exceptions/`, `handoffs/`, `voice/`. Markdown only. One file, one thing. Write the *why*, so the model can push back later.
- `src/` — an MCP server (stdio) with three tools: `brain_list`, `brain_read`, `brain_search`. Search returns file + line so answers cite their source. No vectors, no index, no account. Grep is the point.
## Use it
```bash
npx @br8n/mcp ~/my-brain # MCP server on stdio (or: npm i -g @br8n/mcp && br8n ~/my-brain)
# template: git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n && cp -r br8n/template/brain ~/my-brain
```
Claude Desktop / Claude Code / Cursor (any MCP client) — add:
```json
{ "mcpServers": { "br8n": { "command": "npx", "args": ["-y", "@br8n/mcp", "/path/to/my-brain"] } } }
```
Then ask the model something the brain knows. It answers from the file and names it. Switch the model; same answer, same file.
## Why files
- **Portable.** `cp -r brain/ new-machine/` is the whole migration. If you can't do that, you don't own it.
- **Inspectable.** You can read every byte the model reads.
- **Model-agnostic.** The folder doesn't care which model is on the other side of MCP.
- **It can push back.** A decision stored with its *why* lets a model say "this conflicts with what you decided in March." A chat history can't.
## The method is public on purpose
The layout and this server are MIT. What br8n charges for is hands on a real operation: eliciting what's actually in people's heads, shaping retrieval for the role, running it, and keeping it current. If you'd rather do it yourself, start here — most people should. The free first course is at [br8n.io/lab](https://br8n.io/lab).
## Not affiliated
`br8n` on PyPI (a context-capture engine by a different author) is not this project.
MIT © 2026 Branded Mayhem Collective LLC
## Publishing (maintainers)
Configure npm's trusted publisher once for `@br8n/mcp`:
- Publisher: GitHub Actions
- Organization: `Branded-Mayhem-Collective-LLC`
- Repository: `br8n`
- Workflow: `publish.yml`
- Allowed action: `npm publish`
Publish the version already committed to `main`, then update the official MCP Registry:
```bash
gh workflow run publish.yml --ref main -f version=0.1.2
gh run watch --exit-status
mcp-publisher login github
mcp-publisher publish
```
The GitHub-hosted workflow uses npm trusted publishing (OIDC), so it requires no long-lived npm token. Change the version argument for future releases.