bonhams_results_search
Pack: bonhams · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/bonhams_results_search for the schema, then POST the same URL with its arguments for the data.
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":"bonhams_results_search","arguments":{"query":"Picasso"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('bonhams_results_search', {
"query": "Picasso"
});
More examples
{
"query": "Picasso",
"category": "prints",
"limit": 3
}
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the bonhams pack
{
"mcpServers": {
"bonhams": {
"url": "https://gateway.pipeworx.io/bonhams/mcp"
}
}
}
See Getting Started for client-specific install steps.