`bonanza_search`

Pack: bonanza · Endpoint: https://gateway.pipeworx.io/bonanza/mcp

Search active Bonanza marketplace listings by keyword (Bonapitit findItemsByKeywords). Requires a Bonanza API devID. No sold data — orders are seller-scoped on this API.

Parameters

Name	Type	Required	Description
`keywords`	string	yes	Search keywords, e.g. “vintage brass lamp”
`entries_per_page`	number	no	1-100 (default 25)
`page_number`	number	no	Page number, 1-based (default 1)
`sort_order`	string	no	BestMatch (default) \| CurrentPriceHighest \| PricePlusShippingLowest \| EndTimeSoonest

Example call

Arguments

{
  "keywords": "vintage brass lamp",
  "entries_per_page": 10,
  "_apiKey": "your-bonanza-devid"
}

curl

curl -X POST https://gateway.pipeworx.io/bonanza/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bonanza_search","arguments":{"keywords":"vintage brass lamp","entries_per_page":10,"_apiKey":"your-bonanza-devid"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('bonanza_search', {
  "keywords": "vintage brass lamp",
  "entries_per_page": 10,
  "_apiKey": "your-bonanza-devid"
});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "bonanza": {
      "url": "https://gateway.pipeworx.io/bonanza/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

bonanza_search