Marketplaceread-only renders a card

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.)

View as Markdown (for agents)

Parameters

querystringoptional

What to look for, e.g. "computers", "road bike". Omit to browse everything.

categorystringoptional

Optional category filter, e.g. "Furniture".

minPricenumberoptional

Optional minimum price (in the listing currency; v1 assumes one currency).

maxPricenumberoptional

Optional maximum price (in the listing currency; v1 assumes one currency).

localitystringoptional

Optional locality/area filter, e.g. "Los Altos".

friendsbooleanoptional

When true, show only listings from the caller's own friends ("what are my friends selling?"). Off by default, which searches the whole network.

nearbybooleanoptional

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.

limitintegeroptional

Max listings to return (default 12, max 30).

Returns

Listings for sale across your network, on a discovery grid card.

Related recipes

The Bargain Hunter Window Shopping

This is a tool on the Bonzai MCP server (https://mcp.bonzai.me). Connect your agent and it can call this for you.