# for_sale

**List an item for sale**

Put a REAL item the user owns up for sale on Bonzai, like a classified ad — it posts PUBLICLY to the whole network (there is no friends-only or private option; do not imply one). Call this with no arguments as soon as the user wants to sell something ("sell my bike", "list this for sale", "put my couch up for sale"). Do NOT ask for or invent photos, and do NOT ask for the price or details yourself — the tool returns a one-tap link that opens a page where the user snaps/picks photos and sets the price on their phone. `title`, `price`, `condition`, and `category` are OPTIONAL pre-fills — pass them only if the user already stated them; otherwise omit. The link expires in about half an hour.

- **Category:** Marketplace
- **Access:** mutating (changes state)
- **Renders a UI card:** yes
- **Returns:** A one-tap link to add photos and price a listing, plus a for-sale card.

## Parameters

- `title` (string, optional) — Optional short title for the item, e.g. "IKEA desk, white".
- `price` (string, optional) — Optional asking price as the user phrased it, e.g. "$45" or "45 USD"; parsed server-side. Pass "free" if the user said they are giving the item away.
- `condition` (string, optional) — Optional condition, free text, e.g. "like new", "well-loved".
- `category` (string, optional) — Optional category, e.g. "Furniture", "Electronics".

## 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

- [Sell It](https://bonzai.me/cookbook/sell-it)

---

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