Documentation · pre-MVP

Get your vault online in 5 minutes.

TheBrainfy turns your markdown vault into a live MCP server. Drop .md files, we index them with pgvector, and Claude Desktop queries them like any other tool. Below: the loop, the tools, the pricing, and the obvious questions.

Quickstart

Three steps. ~5 minutes if your Claude Desktop is already installed.

  1. 1

    Sign up + create a project

    Head to /signup (OAuth Google/GitHub or email). Pick a project slug (e.g. acme-notes). The slug becomes your MCP endpoint URL.

  2. 2

    Upload your .md files

    Drag-drop a folder, paste a GitHub repo URL, or sync via rsync. Indexing kicks off automatically — embeddings are generated with text-embedding-3-small (per-note, per-chunk).

  3. 3

    Connect Claude Desktop

    Copy your MCP config snippet from Project → Connect. Paste into claude_desktop_config.json, restart Claude. Ask: "search my vault for ADR-006" — done.

API endpoints

Seven MCP tools exposed per project. Auth via email allowlist + signed JWT. Read-only by default — write tools land in v0.2.

ToolDescription
search_notesSemantic search across your vault. Returns top-K notes ranked by pgvector cosine similarity.
read_noteRead full markdown of a note by id or path. Returns raw .md + frontmatter parsed.
list_notesList notes filtered by tag, folder, or updated_at. Paginated.
get_backlinksReturn notes that wikilink to a given note. Bidirectional graph traversal.
list_tagsAll tags in the vault with note counts. Useful for triage/overview prompts.
get_recentLatest N notes by updated_at. Default 10, max 50.
vault_statsSnapshot of vault size: total notes, total tokens, last index run, top folders.

Pricing

Per-project + storage tier. BYOC means you bring your own LLM key — we don't markup tokens. Cancel anytime.

Free

Start here
$0/mo

Try the loop end-to-end.

  • 1 project
  • 200 notes max
  • Public MCP endpoint
  • Community support

Solo

$12/mo

Individual indie hackers + solo founders.

  • 3 projects
  • 2k notes / project
  • Email allowlist
  • BYOC (your Anthropic key)

Pro

Popular
$39/mo

Power users with multiple vaults.

  • 10 projects
  • 10k notes / project
  • Agents + skills per project
  • Priority indexing

Team

$99/mo

Small teams sharing a corporate brain.

  • Unlimited projects
  • 50k notes / project
  • Shared workspace
  • SSO (Google Workspace)

Enterprise

$499/mo

Self-host option + SLA.

  • Unlimited everything
  • Custom retention
  • SAML SSO
  • Dedicated support

FAQ

The questions every prospect asks in the first 5 minutes.

What is MCP?
Model Context Protocol — Anthropic's open standard for connecting LLMs to external data/tools. TheBrainfy publishes your vault as an MCP server so Claude Desktop (and other MCP clients) can search and read your notes natively.
What does BYOC (Bring Your Own Claude) mean?
You use your own Anthropic API key from Claude Desktop. We never proxy your prompts — Claude talks directly to your MCP endpoint, authenticated via email allowlist. We don't pay for your inference; you don't pay us for tokens.
How do I cancel?
Cancel anytime in Settings → Billing. Your vault stays read-only for 30 days, then archived. No questions, no retention call.
Is it multi-LLM or Claude-only?
Multi-LLM by design. The MCP server is the surface — Claude Desktop, Continue.dev, Cursor, and any MCP-compatible client can consume it. We also expose a REST fallback for GPT/Gemini agents until those vendors ship MCP support natively.
Where is my data stored?
Postgres + pgvector for embeddings/metadata, Cloudflare R2 for raw .md files. EU + US regions available on Pro tier and above. Markdown stays markdown — no proprietary format lock-in. Export full vault as a .zip anytime.

Ready to put your vault online?

Free tier always. No credit card to start.