🔍Search Tool

unified_search

Search across all data sources simultaneously: conversations (semantic), GitHub repos/commits, and markdown docs.

When to use this

Use unified_search when you want the broadest possible view. It combines semantic conversation search, GitHub commit search, and markdown doc search into one integrated timeline.

Quick Example

mcporter call brain.unified_search query="authentication flow"
Response
## Unified Search: "authentication flow"

Found 11 results across sources:

### CONVERSATION
[2025-06-10] Auth Middleware Redesign
> "The authentication flow needs to handle both
> API keys and JWT tokens. Current approach..."

[2025-05-22] NextAuth to Better Auth Migration
> "Migrating the auth flow from NextAuth v4 to
> Better Auth. Key differences: session handling..."

### GITHUB
[2025-06-08] brain-mcp: feat: add auth middleware to API routes
> Added JWT validation and API key auth. Supports
> both bearer tokens and x-api-key header...

### MARKDOWN
[2025-04-01] auth-architecture.md
> Authentication Architecture — Overview of auth
> flow for the platform. OAuth2 + JWT + API keys...

Parameters

NameTypeRequiredDefaultDescription
querystringYesSearch query — searched across all data sources
limitintegerNo15Maximum total results to return

Data Sources

SourceMethodMax Results
ConversationsSemantic (vector similarity)5
GitHub CommitsKeyword (ILIKE)3
Markdown DocsKeyword (ILIKE)3