Skip to content

Search Documentation

Search across all documentation pages

search_and_read

Search notes using hybrid scoring (70% semantic + 30% keyword) and return the full content of top matches. Falls back to keyword-only if no OpenAI key, and to recency if no matches found. Best for gathering all relevant content on a topic in a single call.

Parameters#

ParameterTypeRequiredDescription
querystringrequiredSearch query (natural language or keywords)
maxNotesinteger (1-20)optionalMax notes to return (default 5)
vaultIdstring (UUID)optionalVault to search within. Uses default vault if omitted.

Returns#

An array of full note objects with decrypted content, ranked by hybrid relevance score. Each includes title, full content, tags, and scoring breakdown.

Example#

json
{
  "tool": "search_and_read",
  "arguments": {
    "query": "deployment pipeline configuration",
    "maxNotes": 3
  }
}