# find_people

**Find people**

Search all Bonzai users by name or @handle to find someone to connect with. Returns matches with my current relationship to each.

- **Category:** People & branches
- **Access:** read-only (safe to call anytime)
- **Renders a UI card:** no
- **Returns:** People matching a query, with your relationship (friend, one branch, two branches away).

## Parameters

- `query` (string, required) — A name or @handle to search for, e.g. "Andrew" or "andy". Prefixes and small typos are fine.
- `limit` (integer, optional) — Max results to return (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

- [The Scout](https://bonzai.me/cookbook/the-scout)

---

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