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

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.

ToolWhat it doesParameters
search_lotsFree-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_semanticMeaning-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_lotOne 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_catalogAn 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_catalogsThe catalogs of one house, newest first, with date, state, lot counts and public URL. house*, offset, limit
list_housesThe 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

What the data is

Limits

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