MCP.Market

brain — the recorder MCP server

by mordechaipotash·io.github.mordechaipotash/brain-mcp·v2.0.0·81 stars
No reviews yet

Records your Claude Code, Codex and Pi history before deletion. Cited-or-abstain recall.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

81 stars91 downloads/wk

Reviews

Write one

Nobody has reviewed brain — the recorder yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

brain — the recorder tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • brain_backup

    Sync lake/ + manifest/ to dest (pure-add, content-addressed), then verify by re-hashing sampled files at the destination. The verify can fail — that is the point.

  • brain_capture_status

    Spool depth, heartbeat file ages (side-effect mtimes, never self-report), floor totals. Distinct from health: a backing-up spool is invisible to health until it becomes staleness.

  • brain_get

    Raw floor bytes for a cited span. Pass the citation's sha256 as expect_sha256 to verify; a mismatch is reported, never repaired.

  • brain_health

    Origin-vs-floor staleness per lane. fresh = floor holds everything the agent's own files show; stale = the agent has content the recorder missed; unknown = unmeasured, NOT healthy (mandatory reason attached).

  • brain_recent

    Time-ordered recent messages, every row cited. An empty result states its coverage — silence never renders as an answer.

  • brain_search

    Keyword (BM25) search over all recorded conversations. Every hit carries a mechanically verifiable citation; zero hits return an explicit abstention with coverage. role='user' answers 'what did I say'; order='time_asc' reads a thinking trajectory.

  • brain_sessions

    Session cards (agent, span, message counts, floor file) for a date or range. A whole session's raw text is brain_get(file, [1, n]).

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan32 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 6 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How brain — the recorder compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
92/100
higher than 95% of 48,255 servers
Tools
7
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
81
more than 95% of 28,688 servers
Downloads a week
91
more than 61% of 12,191 servers with a package

What its tools let an agent do: 7 read

Release history: 2 versions in the registry since 2026-08-20, latest 2026-10-04, typically one every 45 days.

Install brain — the recorder in Claude Code, Cursor or VS Code

claude mcp add brain-mcp -- uvx brain-mcp
Add to Cursor

What the publisher says

From the brain — the recorder repository's README, as published. We do not edit it. Read it on GitHub

<!-- mcp-name: io.github.mordechaipotash/brain-mcp -->

brain-mcp — the recorder for your AI conversations

Your AI history is being deleted right now. Claude Code deletes session files older than cleanupPeriodDays (default 30) at startup. Run this and see your own cliff edge:

# macOS
find ~/.claude/projects -name '*.jsonl' -exec stat -f '%Sm  %N' -t '%Y-%m-%d' {} + | sort | head -3
# Linux
find ~/.claude/projects -name '*.jsonl' -printf '%TY-%Tm-%Td %p\n' | sort | head -3

The oldest date you see is where your history ends. brain-mcp records it before it goes — byte-exact, content-hashed, locally — and makes it queryable with citations you can verify with sed and shasum.

Install

pipx install brain-mcp --pre     # or: uvx brain-mcp
brain-mcp install cc             # CC hooks + 60-second scheduler
brain-mcp serve                  # the MCP server (stdio) — add to your client config

Or as a Claude Code plugin (hooks + server in one step):

/plugin marketplace add mordechaipotash/brain-marketplace
/plugin install brain

What it does

snapshot); Codex and Pi via a 60-second poll-scan. One spool, one floor.

  • Captures at source. Claude Code via Stop/SessionEnd hooks (line-deltas + a final

byte-identical to the original, with an append-only sha256 manifest. Nothing is parsed and discarded; the DuckDB index is a cache, fully re-derivable from the lake.

  • Keeps the bytes. The floor is ~/.brain/lake//.jsonl — append-only,

by anyone with sed -n 'A,Bp' file | shasum -a 256, no database required. Zero hits return an explicit abstention naming the lanes and dates actually searched.

  • Cites or abstains. Every search hit carries {file, line span, sha256} — checkable

stale = the agent has content the recorder missed; unknown = unmeasured, not healthy — never folded into "looks fine".

  • Reports health honestly. fresh = the floor holds everything the agent's files show;

sampled files at the destination. The verify can fail; that is the point.

  • Backs up verifiably. brain-mcp backup syncs lake+manifest and re-hashes

there is no httpx/requests import in this package.

  • Zero network calls at runtime. No telemetry, no cloud, no accounts. Verify it:

The 7 MCP tools

🤖 For AI Assistants

You're reading this because your human runs THE RECORDER and gave you access to their AI history. This is the honesty contract.

The one rule: everything you state from these tools is either CITED or ABSTAINED — there is no third state. A cited claim carries a checkable pointer (file + line span + sha256); verify it with brainget(expectsha256=...) before building on it. An abstention means "not found above threshold in the lanes and dates the tool measured" — it does NOT mean "it never happened". Never fill an abstention with your own guess.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

brain — the recorder: common questions

Is brain — the recorder MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the brain — the recorder safety report
How do I install brain — the recorder?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does brain — the recorder need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is brain — the recorder maintained?
The last commit was 9 days ago (2026-10-26). The latest release is v2.0.0.
What can I use instead of brain — the recorder?
Servers from other publishers that do the same job: CPU Performance Engineering MCP server.
How does brain — the recorder compare with other MCP servers?
safety score 92/100 (higher than 95% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to brain — the recorder

Same job from other publishers: the closest match first, then the best rated.

  • CPU Performance Engineering
    A CPU performance engineering brain: a vetted reading list, benchmarks and cited source passages
    A