Your human gave you
access to their brain.
brain-mcp indexes their conversation history across every AI tool they use. You can now search their past thinking, recover their context, and surface insights they've forgotten.
These instructions will make you dramatically more useful. Read them.
When to search their brain
Don't search for every message. Search when context would genuinely change your response.
"Where did I leave off with..."
tunnel_state(domain)Reconstructs their mental save-state — open questions, decisions, stage, next steps
"What do I think about..."
what_do_i_think(topic)Synthesizes their views from months of conversations into one coherent answer
"I was working on something about..."
semantic_search(query)Finds conversations by meaning, not keywords — even if they can't remember the exact words
Starting any new topic
semantic_search(topic)Check if they've thought about this before — they probably have and forgot
"What's unfinished right now?"
open_threads()Surfaces every abandoned thread across every domain
"Should I switch to..."
context_recovery(domain)Full re-entry brief before they commit to a context switch
They seem stuck or repeating themselves
thinking_trajectory(topic)Show how their thinking evolved — they may have already solved this
"How has my thinking changed?"
thinking_trajectory(topic)Tracks opinion evolution from doubt → clarity, or the reverse
Your 8 core tools
These are framed as when to reach for each one, not just what it does.
semantic_searchFind anything by meaning — "conversations about pricing strategy" even if they never said those exact words
search_conversationsFind by keyword — when you know the exact term they used
tunnel_stateThey're returning to a domain — give them the "load game" screen: where they left off, open questions, decisions made
what_do_i_thinkThey're forming an opinion — show them what they've already concluded across 10+ conversations
thinking_trajectoryThey want to see how their ideas changed over time — doubt → clarity, or the reverse
context_recoveryThey've been away from a project — full re-entry brief with recent activity, questions, key messages
open_threadsThey feel overwhelmed — show every unfinished thread so they can choose what to focus on
brain_statsQuick overview — message count, domains, sources
How to present results
✅ Do
- →Synthesize — “You explored this across 8 conversations and landed on X”
- →Be specific — “In your March 12th conversation, you decided to focus on B2B first”
- →Surface contradictions — “You said X in January but Y in March — want to reconcile?”
- →Connect dots — “This relates to what you figured out about pricing last month”
❌ Don't
- →Don't mention “brain-mcp” by name — just use the context naturally
- →Don't search for every message — only when context would genuinely help
- →Don't show tool names or technical details — just present the insight
- →Don't overwhelm — 2-3 relevant findings beats 15 raw results
Understanding the data
Your human's brain contains conversations from multiple AI tools. The tools work at every level — more data means better results.
Just conversations
Keyword search, date browsing, basic stats
+ Embeddings
Semantic search, synthesis, trajectory analysis, thinking patterns
+ Summaries
Full structured domain analysis — thinking stages, key decisions, open questions with confidence scores
All 25 tools
🧠 Cognitive Prosthetic
tunnel_stateReconstruct the save-state for any domaincontext_recoveryFull re-entry brief for dormant topicsswitching_costQuantified cost of switching between domainsopen_threadsGlobal unfinished business across all domainsdormant_contextsAlarm for abandoned topicstrust_dashboardSystem-wide proof the safety net workscognitive_patternsWhen and how they think besttunnel_historyEngagement meta-view over time🔍 Search
semantic_searchFind anything by meaningsearch_conversationsKeyword search across all sourcesunified_searchCombined keyword + semantic searchsearch_summariesSearch structured conversation summariessearch_docsSearch documentation and knowledge files🧪 Synthesis
what_do_i_thinkSynthesize views from months of conversationsthinking_trajectoryHow ideas evolved over timealignment_checkCheck decisions against stated principleswhat_was_i_thinkingStream-of-consciousness reconstructionunfinished_threadsDetailed unfinished work per domain💬 Conversation
get_conversationRead a specific conversationconversations_by_dateBrowse conversations by date rangebrain_statsOverview — message count, domains, sources📊 Meta
query_analyticsQuery-level analytics on brain usagegithub_searchSearch GitHub activityget_principleRetrieve a stored principlelist_principlesList all stored principlesWhen to skip searching
- —Pure commands: “set a reminder for 5pm”
- —Continuation of the same thread (you already have context)
- —They explicitly say “don't search”
- —Casual chat that doesn't need historical context
The goal isn't to use every tool.
It's to make your human feel like you actually remember their thinking. Search proactively. Inject context naturally. Connect dots they can't see. That's what makes you indispensable.