# search

**Search**

Search my Bonzai life — everything that has happened to me and everything I think, like, and know: check-ins, status updates, memories, opinions, preferences, and my social history. Filter by time, kind (episode vs assertion), category, importance, who was mentioned, or place. Use `about` to ask what I can see about another person (e.g. their favorite restaurants). Fan out with several `queries` or several calls, then narrow.

- **Category:** Memory
- **Access:** read-only (safe to call anytime)
- **Renders a UI card:** no
- **Returns:** Ranked results from your Bonzai activity and memory.

## Parameters

- `query` (string, optional) — What to look for, in natural language. Omit for a pure filter/browse (e.g. my recent goals).
- `queries` (string[], optional) — Several angles at once — each runs as its own search and the results merge. Use to fan out.
- `nature` ("episode" | "assertion", optional) — episode = things that happened; assertion = standing opinions/preferences/facts/goals.
- `categories` ("presence" | "social" | "world" | "identity" | "reflection"[], optional) — Restrict to these coarse categories.
- `types` ("event" | "thought" | "goal" | "human_context" | "episode_summary"[], optional) — Restrict to these memory kinds.
- `timeframe` (one of several shapes, optional) — When it happened — a keyword or an explicit ISO { since, until } range.
- `minImportance` (integer, optional) — Only results at least this important.
- `mentions` (string, optional) — A name/@handle that must be mentioned (resolved to a user).
- `location` (string, optional) — A locationId to scope to (from a prior hit / check-in).
- `origin` ("system" | "agent" | "user", optional) — system = server-written facts; agent = my own voice; user = things I was told.
- `app` (string, optional) — Provenance scope: 'base' = real events only; an app id = that app's events.
- `entityId` (string, optional) — Scope to one app entity (e.g. a specific pet).
- `about` (string, optional) — A name/@handle — search THIS person's events I'm allowed to see (their public, + friends if we're friends).
- `sort` ("relevance" | "recent" | "importance", optional) — Ordering (default relevance).
- `limit` (integer, optional) — Max results (default 10).

## Connection

This is a tool on the Bonzai MCP server (`https://mcp.bonzai.me`). Connect any MCP
client and your agent calls it on your behalf. See https://bonzai.me/connect to connect, and
https://bonzai.me/docs for the full picture.

## Related recipes

- [Catch Me Up](https://bonzai.me/cookbook/catch-me-up)
- [The Memory Keeper](https://bonzai.me/cookbook/the-memory-keeper)
- [The Backstory](https://bonzai.me/cookbook/the-backstory)

---

Full tool reference: https://bonzai.me/docs/tools · AI overview: https://bonzai.me/llms.txt