{"_id":"@br8n/mcp","_rev":"3-b3e640157713046ec8c13cc21eab5d18","name":"@br8n/mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@br8n/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","ai-memory","portable-memory","knowledge-base","markdown","br8n","owned-memory"],"author":{"url":"Branded Mayhem Collective","name":"Michael Sebastian"},"license":"MIT","_id":"@br8n/mcp@0.1.0","maintainers":[{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"}],"homepage":"https://br8n.io","bugs":{"url":"https://github.com/Branded-Mayhem-Collective-LLC/br8n/issues"},"bin":{"br8n":"dist/cli.js"},"dist":{"shasum":"bb6f074c316c12859ea526f4712189cdb0a6bde6","tarball":"https://registry.npmjs.org/@br8n/mcp/-/mcp-0.1.0.tgz","fileCount":12,"integrity":"sha512-Ri/CmXvVi5bb8M5ukRE3dzWYOwq6vHa9i1jU3WG95ookgHguWul1O/3cVZdE/9j3NcUbI0pPhDQetvULd2pIRQ==","signatures":[{"sig":"MEUCICQ56tmQM7lwJ8T6y7121GXSmX02+gP6QDopakHBqlFyAiEAnZO1xZu7mDSobRPZTbw4PxkYKdO4/suDFZWvyrwPWpw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12196},"main":"dist/server.js","type":"module","engines":{"node":">=20"},"gitHead":"1846a4003ba09a8aed7cdf6269337be9ccdf7653","mcpName":"io.github.Branded-Mayhem-Collective-LLC/br8n","scripts":{"test":"node --test test/*.test.mjs","build":"tsc -p tsconfig.json","start":"node dist/cli.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"},"repository":{"url":"git+https://github.com/Branded-Mayhem-Collective-LLC/br8n.git","type":"git"},"_npmVersion":"10.9.4","description":"br8n — owned, portable working memory. A plain-files brain template and a tiny MCP server that lets any model read it. Files, not a login.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1787166145066_0.8576698992403686","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@br8n/mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","ai-memory","portable-memory","knowledge-base","markdown","br8n","owned-memory"],"author":{"url":"Branded Mayhem Collective","name":"Michael Sebastian"},"license":"MIT","_id":"@br8n/mcp@0.1.1","maintainers":[{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"}],"homepage":"https://br8n.io","bugs":{"url":"https://github.com/Branded-Mayhem-Collective-LLC/br8n/issues"},"bin":{"br8n":"dist/cli.js"},"dist":{"shasum":"29cc2cfb2d94002557e6a2943cf1b715f6bfba70","tarball":"https://registry.npmjs.org/@br8n/mcp/-/mcp-0.1.1.tgz","fileCount":12,"integrity":"sha512-UMsYmhXPrCaY7xORx7v42/xUrUnChow1T+/VOqGgTgVk8yLq1eTjQeE14JlZhgQQJDjz11Mnas/2qYwl7JMDIQ==","signatures":[{"sig":"MEUCIQDtyg0Hw3zRktiOvCdmEXZmJZkk2BO+svE7Jk8RC/xWgQIgcKGAXrLZ5eIKouC6BZunskrCmwsyclDS9sLL5iP7sGc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12163},"main":"dist/server.js","type":"module","engines":{"node":">=20"},"gitHead":"94508ad7eb27022947605b90b4b71a6a83bed273","mcpName":"io.br8n/mcp","scripts":{"test":"node --test test/*.test.mjs","build":"tsc -p tsconfig.json","start":"node dist/cli.js","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"},"repository":{"url":"git+https://github.com/Branded-Mayhem-Collective-LLC/br8n.git","type":"git"},"_npmVersion":"10.9.4","description":"br8n — owned, portable working memory. A plain-files brain template and a tiny MCP server that lets any model read it. Files, not a login.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1787176249383_0.37283748891039337","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@br8n/mcp","mcpName":"io.br8n/mcp","version":"0.1.2","description":"br8n — owned, portable working memory. A plain-files brain template and a tiny MCP server that lets any model read it. Files, not a login.","type":"module","bin":{"br8n":"dist/cli.js"},"main":"dist/server.js","scripts":{"build":"tsc -p tsconfig.json","start":"node dist/cli.js","pretest":"npm run build","test":"node --test test/*.test.mjs","prepublishOnly":"npm test"},"keywords":["mcp","model-context-protocol","ai-memory","portable-memory","knowledge-base","markdown","br8n","owned-memory"],"author":{"name":"Michael Sebastian","url":"Branded Mayhem Collective"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Branded-Mayhem-Collective-LLC/br8n.git"},"homepage":"https://br8n.io","engines":{"node":">=20"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.23.8"},"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"gitHead":"124d390212d3cb9569b1bbb64584907da5daf949","_id":"@br8n/mcp@0.1.2","bugs":{"url":"https://github.com/Branded-Mayhem-Collective-LLC/br8n/issues"},"_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-rO5omifPBq9FLU/9NPZoj1Us04sFuFqY4LrggaEG6QaSqPZd1cCEUEHI3VyZmJWzUtG7/QIBCoNg9JEs5VIEwg==","shasum":"ff3dd7f0d454c44f6fc72637f75d071126bf23cd","tarball":"https://registry.npmjs.org/@br8n/mcp/-/mcp-0.1.2.tgz","fileCount":12,"unpackedSize":12907,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@br8n%2fmcp@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBDWfHvLhOVm1L5SEUXMQ79sH/5RtsO8fIK0xpo/bqmYAiBKGz1jpEPS3/SrHhYJxZ6/fbEhBRbo5+0gHDnSKIbY3g=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:bdcdb732-47ae-4190-abc7-abedf88c8295"}},"directories":{},"maintainers":[{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.2_1787610223463_0.33482914486753335"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-19T19:02:24.829Z","modified":"2026-08-24T22:23:44.031Z","0.1.0":"2026-08-19T19:02:25.216Z","0.1.1":"2026-08-19T21:50:49.542Z","0.1.2":"2026-08-24T22:23:43.609Z"},"bugs":{"url":"https://github.com/Branded-Mayhem-Collective-LLC/br8n/issues"},"author":{"name":"Michael Sebastian","url":"Branded Mayhem Collective"},"license":"MIT","homepage":"https://br8n.io","keywords":["mcp","model-context-protocol","ai-memory","portable-memory","knowledge-base","markdown","br8n","owned-memory"],"repository":{"type":"git","url":"git+https://github.com/Branded-Mayhem-Collective-LLC/br8n.git"},"description":"br8n — owned, portable working memory. A plain-files brain template and a tiny MCP server that lets any model read it. Files, not a login.","maintainers":[{"name":"michael-lee-sebastian","email":"michael@brandedmayhem.com"}],"readme":"# br8n\n\n**Owned, portable working memory.** A plain-files brain template and a tiny MCP server that lets any model read it.\n\n> 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.\n\nbr8n 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)\n\n## What's here\n\n- `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.\n- `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.\n\n## Use it\n\n```bash\nnpx @br8n/mcp ~/my-brain                         # MCP server on stdio (or: npm i -g @br8n/mcp && br8n ~/my-brain)\n# template: git clone https://github.com/Branded-Mayhem-Collective-LLC/br8n && cp -r br8n/template/brain ~/my-brain\n```\n\nClaude Desktop / Claude Code / Cursor (any MCP client) — add:\n\n```json\n{ \"mcpServers\": { \"br8n\": { \"command\": \"npx\", \"args\": [\"-y\", \"@br8n/mcp\", \"/path/to/my-brain\"] } } }\n```\n\nThen ask the model something the brain knows. It answers from the file and names it. Switch the model; same answer, same file.\n\n## Why files\n\n- **Portable.** `cp -r brain/ new-machine/` is the whole migration. If you can't do that, you don't own it.\n- **Inspectable.** You can read every byte the model reads.\n- **Model-agnostic.** The folder doesn't care which model is on the other side of MCP.\n- **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.\n\n## The method is public on purpose\n\nThe 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).\n\n## Not affiliated\n\n`br8n` on PyPI (a context-capture engine by a different author) is not this project.\n\nMIT © 2026 Branded Mayhem Collective LLC\n\n## Publishing (maintainers)\n\nConfigure npm's trusted publisher once for `@br8n/mcp`:\n\n- Publisher: GitHub Actions\n- Organization: `Branded-Mayhem-Collective-LLC`\n- Repository: `br8n`\n- Workflow: `publish.yml`\n- Allowed action: `npm publish`\n\nPublish the version already committed to `main`, then update the official MCP Registry:\n\n```bash\ngh workflow run publish.yml --ref main -f version=0.1.2\ngh run watch --exit-status\n\nmcp-publisher login github\nmcp-publisher publish\n```\n\nThe GitHub-hosted workflow uses npm trusted publishing (OIDC), so it requires no long-lived npm token. Change the version argument for future releases.\n","readmeFilename":"README.md"}