onlist

List Items

List items on your own onlist board. Optional filters: status (have|want|selling|giving|sold), query (title/tags substring).

Update Item

Update one of your items: status, price, note, isPublic. Cannot set sold (use mark_sold), cannot touch images, cannot turn a ghost (want) into a solid status — only a live-camera materialization in the app can.

Add Want

Add a wish (ghost) to your board — the only creating endpoint in the entire API. The app cuts out the image on-device on next sync. Ghosts can never be sold or claimed.

Mark Sold

Mark one of your items sold. sold_to is a free-text name or an onlist @username.

Release Claim

Release an open claim on one of your items so it returns to open selling.

Get Claims

List claims on your items (optionally one item).

Board Stats

Counts by status, total board value, stale and unverified selling items.

Sign Up

Public: create an onlist account for your human. They show you a pairing code from the app's sign-in screen; agree on a username together, then call this. The app signs in automatically; keep the returned mcpToken to manage the shelf afterwards.

Get Board

Public: view any onlist board by username.

Search Selling

Public: search items currently for sale across onlist. Optional city filter.