MCP.Market

Thebrain MCP server

by yBookoff·io.github.yBookoff/thebrain·v0.3.0·8 stars
No reviews yet

MCP server for TheBrain 15: search by meaning, graph traversal and batch writes over the local API

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

full report

Adoption
Growing

8 stars110 downloads/wk

Reviews

Write one

Nobody has reviewed Thebrain yet.

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

Thebrain tools (19, 6 write)

write = sends, deletes, buys or posts

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

  • brain_activate

    Opens a thought in the user's TheBrain app on screen.

  • brain_append_note

    Appends text to the end of a note without erasing anything.

  • brain_attach_url

    Attaches a link to a thought. Checks first whether the same URL is already

  • brain_create_thoughtwrite action

    Creates a thought and sets its note, type, tags and aliases in the same call.

  • brain_create_type_or_tagwrite action

    Creates a thought type or a tag: the vocabulary thoughts are classified with,

  • brain_delete_thoughtwrite action

    Permanently deletes a thought along with its note and links. There is no undo.

  • brain_get_thought

    A thought in full: note, aliases, parents, children, jumps, tags, type and attachments in one call.

  • brain_index

    Manages the semantic index: status, build, refresh.

  • brain_ingestwrite action

    Writes a whole structure of thoughts, links, notes, tags and aliases in a single call.

  • brain_link

    Links two thoughts. Call it when you spot a meaningful relationship between

  • brain_list

    Lists the user's brains and which one is currently open in the app.

  • brain_list_types_and_tags

    The brain's vocabulary: which thought types and tags exist. Call it before

  • brain_recent_changes

    What changed in the brain over a period, in plain language. Call it for digests

  • brain_search

    Finds thoughts by meaning. Call it when looking for something by description

  • brain_set_note

    Replaces a thought's note entirely. The previous text is lost —

  • brain_tag

    Attaches and removes a thought's tags. Tags are separate thoughts of a special

  • brain_traverse

    Walks the graph several hops out from a thought. Call it when you need to see

  • brain_unlinkwrite action

    Removes the link between two thoughts, with its label. There is no undo. Requires

  • brain_update_thoughtwrite action

    Changes a thought's properties: title, caption, aliases, type, colours.

Public scan report

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

no findings
  • Code scan63 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 qualitystatic API keys via environment variables6/15
  • Maintenancelast push 20 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Thebrain compares

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

Safety score
83/100
higher than 70% of 3,470 Web search servers
Tools
19
the typical Web search server has 5
Tools that change things
32%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
8
more than 84% of 1,786 Web search servers
Downloads a week
110
more than 59% of 827 Web search servers with a package

What its tools let an agent do: 13 read · 6 change

Release history: 4 versions in the registry since 2026-08-12, latest 2026-10-14, typically one every 12 days.

Install Thebrain in Claude Code, Cursor or VS Code

Runs npx -y thebrain-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add thebrain -- npx -y thebrain-mcp-server
Add to Cursor

What the publisher says

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

thebrain-mcp

An MCP server for TheBrain 15, built on its local API.

It gives an agent semantic operations over your brain: search by meaning, read a neighbourhood of the graph, and write a decomposed piece of material into the brain as a whole connected structure. It is not a mirror of the API — 17 tools instead of 48 endpoints.

The point is not "save this text". The point is that when you hand an agent an article, it reads it, breaks it into meanings, works out where each one belongs in the graph you already have, what to link it to, and what each note should say.

Published on npm as thebrain-mcp-server — npm considers the shorter name

too close to an unrelated existing package. The installed command is still

thebrain-mcp.

Requirements

  • TheBrain 15 running, with the local API enabled
  • Node.js 22 or newer
  • An API key: Settings → User → Local API Key

Install

Claude Code

claude mcp add thebrain -e THEBRAIN_API_KEY=your-key -- npx -y thebrain-mcp-server

Clients with a config file

{
  "mcpServers": {
    "thebrain": {
      "command": "npx",
      "args": ["-y", "thebrain-mcp-server"],
      "env": { "THEBRAIN_API_KEY": "your-key" }
    }
  }
}

Semantic search

TheBrain's own search matches prefixes: OT finds OTGP, while a synonym or a typo finds nothing. To search by meaning, the server builds a local vector index.

The embeddings package is not part of the install: it weighs around 380 MB, plus 113 MB for the model itself on first run. Install it separately, and only if you want it:

npm install -g @huggingface/transformers

Then, from your client: brain_index with action: "rebuild". Indexing a 10,000-thought brain takes about a minute; later runs only recompute what changed.

The server works without the package. brain_search falls back to a fan-out of prefix queries over the synonyms the agent supplies, and says plainly that recall is lower.

Everything is local: neither your brain's contents nor your queries are sent anywhere.

Settings

Changing the model or the precision makes an existing index unusable — the server will say so and ask for a rebuild.

Tools

Reading

Writing

brain_ingest

The main tool for filling a brain. The agent breaks material into thoughts, wires them together through temporary identifiers, and the whole thing lands in one call:

Shortened. The full README is on GitHub.

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

Thebrain: common questions

Is Thebrain MCP server safe?
Mostly: it is graded B (83/100). Read the Thebrain safety report
How do I install Thebrain?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Thebrain need an API key?
Yes. The registry entry asks for THEBRAIN_API_KEY.
Is Thebrain maintained?
The last commit was 21 days ago (2026-10-14). The latest release is v0.3.0.
What can I use instead of Thebrain?
Servers from other publishers that do the same job: Link MCP server, Arxiv MCP server and Socraticode MCP server.
How does Thebrain compare with other Web search MCP servers?
safety score 83/100 (higher than 70% of 3,470 Web search servers); tools 19 (the typical Web search server has 5); tools that change things 32% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Thebrain

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

  • Link
    Local personal memory for agents as MCP tools — remember, recall, search, context, graph traversal.
    A
  • Arxiv
    Search arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.
    A
  • Socraticode
    MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs.
    B
  • Octocode
    AI-powered code indexer with semantic search and knowledge graphs
    More from Muvon →
    A
  • Ref Tools
    Token-efficient search for coding agents over public and private documentation.
    A