# find_for_sale

**Find items for sale**

Search Bonzai's public for-sale listings by keyword, with optional category, price, and locality filters ("are there any computers for sale?", "find a used road bike under $400"). Set `friends: true` to see only what the caller's friends are selling, and `nearby: true` to limit to the caller's current area ("what are my friends selling?", "anything for sale near me?"). Returns matching items plus a link to browse them all on Bonzai. This only FINDS things — it never buys: to reach a seller, use `express_interest`. Offer the user both the results here and the "see them all" link. (For the caller's OWN listings, use `my_listings`, not this.)

- **Category:** Marketplace
- **Access:** read-only (safe to call anytime)
- **Renders a UI card:** yes
- **Returns:** Listings for sale across your network, on a discovery grid card.

## Parameters

- `query` (string, optional) — What to look for, e.g. "computers", "road bike". Omit to browse everything.
- `category` (string, optional) — Optional category filter, e.g. "Furniture".
- `minPrice` (number, optional) — Optional minimum price (in the listing currency; v1 assumes one currency).
- `maxPrice` (number, optional) — Optional maximum price (in the listing currency; v1 assumes one currency).
- `locality` (string, optional) — Optional locality/area filter, e.g. "Los Altos".
- `friends` (boolean, optional) — When true, show only listings from the caller's own friends ("what are my friends selling?"). Off by default, which searches the whole network.
- `nearby` (boolean, optional) — When true, limit to the caller's current area — auto-filled from their latest check-in ("any bikes for sale near me?"). Ignored if you pass an explicit `locality`, or if their location is unknown.
- `limit` (integer, optional) — Max listings to return (default 12, max 30).

## 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 Bargain Hunter](https://bonzai.me/cookbook/the-bargain-hunter)
- [Window Shopping](https://bonzai.me/cookbook/window-shopping)

---

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