# my_listings

**My for-sale listings**

List the items the CALLER has put up for sale on Bonzai — their own inventory, newest first. Use for "show me my listings", "what am I selling", "did my listing post?", or "do I have any unfinished drafts?". This includes DRAFTS (started but not yet finished with photos + price on the phone) and SOLD/withdrawn items, which the public `find_for_sale` search never returns. It reads the caller's own inventory directly from Bonzai, so it works even when for-sale search is unavailable. Optional `status` filter; omit it to see everything. Read-only — it never posts, edits, or removes anything.

- **Category:** Marketplace
- **Access:** read-only (safe to call anytime)
- **Renders a UI card:** no
- **Returns:** Your own for-sale inventory — active listings, unfinished drafts, and sold/withdrawn items, newest first.

## Parameters

- `status` ("active" | "draft" | "sold" | "withdrawn", optional) — Optional status filter. Omit to see everything (live + unfinished drafts + sold/withdrawn). Use "active" for just the live public ones, "draft" for unfinished ones.
- `limit` (integer, optional) — Max listings to return (default 50, newest first).

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

_None yet._

---

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