🔍Search Tool

search_conversations

Full-text keyword search across all conversation messages. Fast, exact matching via DuckDB.

When to use this

Use search_conversations when you know the exact term, name, or code snippet. For conceptual/fuzzy search, use semantic_search instead.

Quick Example

mcporter call brain.search_conversations term="deployment pipeline"
Response
## Conversations containing 'deployment pipeline' (15 found)

[2025-06-12] Railway CI/CD Setup
  user: "I need a deployment pipeline that handles..."
  ID: abc-123... | claude-code/claude-4

[2025-05-28] Docker Multi-Stage Builds
  assistant: "Your deployment pipeline should..."
  ID: def-456... | chatgpt/gpt-4o

[2025-04-15] Vercel Edge Functions
  user: "How does the deployment pipeline interact..."
  ID: ghi-789... | claude_desktop/claude-3.5-sonnet

Parameters

NameTypeRequiredDefaultDescription
termstringYesSearch term (keyword matching, case-insensitive)
rolestringNoFilter by role: 'user' for your messages, 'assistant' for AI responses
limitintegerNo15Maximum results to return

Examples

Basic search

mcporter call brain.search_conversations term="hyperfocus"

Only your messages

mcporter call brain.search_conversations term="should I" role="user"

Only AI responses

mcporter call brain.search_conversations term="I recommend" role="assistant" limit=5