results_search
Pack: bonhams · Endpoint: https://gateway.pipeworx.io/bonhams/mcp
Search Bonhams’ past-lot realized-price archive by artist/maker (or any keyword). Returns sold lots with hammer price, hammer price including buyer’s premium (the actual realized price), estimate range, sale date and department. Optionally filter by category (matches the department name, e.g. “jewellery”, “prints”).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Artist, maker, or keyword, e.g. “Picasso”, “Rolex Daytona”. |
category | string | no | Optional free-text filter matched against the department name, e.g. “jewellery”, “prints”, “books”. |
page | number | no | Result page, 1-based (each page is ~45 lots). Default 1. |
limit | number | no | Max lots to return from the page (1-45, default 20). |
Example call
Arguments
{
"query": "Picasso"
}
curl
curl -X POST https://gateway.pipeworx.io/bonhams/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"results_search","arguments":{"query":"Picasso"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('results_search', {
"query": "Picasso"
});
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"bonhams": {
"url": "https://gateway.pipeworx.io/bonhams/mcp"
}
}
}
See Getting Started for client-specific install steps.