Bidspirit MCP server
Live auction catalogs for AI agents. Search lots, read a lot in full, browse an auction, list the houses. Read-only, no login, every result links to the public page on bidspirit.com where the live bidding state is shown and bids are placed.
Connect
Server URL:
https://ai.bidspirit.com/services/mcp
- Claude (claude.ai or the desktop app): Settings → Connectors → Add custom connector → paste the URL. No authentication, leave the OAuth fields empty.
- Claude Code:
claude mcp add --transport http bidspirit https://ai.bidspirit.com/services/mcp - ChatGPT, Cursor and other MCP clients: add a remote MCP server with the URL above. Transport is Streamable HTTP, authentication none.
The server is stateless: every call is one HTTP POST with a JSON-RPC 2.0 request and a JSON response. There is no session to keep and no server-initiated stream (GET answers 405).
Tools
All six tools are read-only and idempotent. Parameters marked * are required.
| Tool | What it does | Parameters |
|---|---|---|
| search_lots | Free-text search over every lot of every house, any language. By default only lots that can still be bought (forthcoming or running auctions). | query*, house, region (IL, US, EU, UK, RU, …), contentType (ART, CARS, MACHINES, REAL_ESTATE), status (available, sold, all), limit |
| search_lots_semantic | Meaning-based (AI vector) search: describe what you look for in any language and get the lots whose images and texts match the meaning, not the words. Covers only the AI-indexed part of the catalog (houses that enabled AI search, today mainly US houses' recent auctions); each result carries a relevance score and an AI-written description. | query*, house, region, contentType, status (available, sold, all), limit |
| get_lot | One lot in full: texts per language, images, estimate, prices where the house shows them, condition, dimensions, sale terms, its auction and the public lot URL. | house*, lotId* |
| get_catalog | An auction or shop catalog: header (name, date, state, end time, buyer's premium, viewing hours) and its lots in lot-number order, paged. | house*, catalogKey*, offset, limit |
| list_catalogs | The catalogs of one house, newest first, with date, state, lot counts and public URL. | house*, offset, limit |
| list_houses | The auction houses on Bidspirit: code, name, region, country, catalog and lot counts, public URL. | query, region, limit |
Every url a tool returns carries from=mcp, so visits that start in an agent are counted on our side. Keep the URLs as given.
Example prompts
- Find lots by Reuven Rubin currently for sale on Bidspirit and give me their links.
- Which Judaica auctions are running this week, and which house has the most lots?
- Show me the catalog of the next Tiroche auction and the ten lots with the highest estimates.
What the data is
- The same public catalog data as bidspirit.com, with the same visibility rules: where a house hides sold prices or start prices the fields are absent and the catalog says so. Hidden lots and pending (not yet opened) auctions are not returned.
- Texts are per language (
he,en,ru, …) exactly as the house wrote them. Prices are in the catalog's currency. Times are ISO-8601 UTC. - Every house, catalog and lot carries
url: the public page on bidspirit.com. Send people there to see the live state and to bid; the server itself never places bids and never acts on anyone's behalf. - The same data is available as a JSON feed for crawlers: see llms.txt.
Limits
- Tool calls: one per 2 seconds per client address. A faster call answers HTTP 429 with
Retry-Afterand a JSON-RPC error carryingretryAfterMs. The handshake (initialize, tools/list, ping) is not limited. - Result sizes are capped per call (
limit); page through catalogs withoffset.
Raw example
curl -X POST https://ai.bidspirit.com/services/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_lots","arguments":{"query":"Reuven Rubin","limit":5}}}'
Privacy and support
- The server stores nothing about the user. Requests are logged with the calling address and client name for abuse protection and usage statistics only. Bidspirit privacy notice.
- Support: support@bidspirit.com.