Shop Data for AI Assistants
Version 1 · Public, no login · Read-only
Only the public shop's items, condition facts, prices and policies are available. No purchase costs, profit, private notes, personal inventory or customer details are exposed.
HTTP endpoints
| GET address | Response |
|---|---|
| /api/public/v1/products | Search and paginated public listings |
| /api/public/v1/products/{id} | One public item; UUID or current slug |
| /api/public/v1/products/{id}/availability | Current price and availability, uncached |
| /api/public/v1/shipping?id={id}&country=US | Published shipping quote, without changes |
| /api/public/v1/policies | Shipping, returns, verification and tax policies |
Search: q, category (all/new/used/coming-soon), theme, condition (new/used), min/max USD price, page (starts at 1), limit (1–50; default 20) and sort. Default category excludes Available Soon; use coming-soon for those items.
Responses cache for up to 30 seconds and support ETag / If-None-Match. Availability is uncached. Limit: 60 requests per minute per caller and interface, or a shared limit where a trusted caller address is unavailable. 429 includes Retry-After: 60. Invalid input returns 400; missing/nonpublic items return 404; temporary failures return 503.
MCP connection
Address: https://brick.broker/mcp · Streamable HTTP
Tools: search_sets, check_availability, quote_shipping, read_policies. The configured policy requires no authentication and is intended for anyone on the internet. Cross-origin browser requests are not enabled; desktop and server clients may connect without Origin.
Add to an assistant config (for example claude_desktop_config.json):
{
"mcpServers": {
"brick-broker": { "command": "npx", "args": ["mcp-remote", "https://brick.broker/mcp"] }
}
}Also listed in the official MCP Registry as broker.brick/shop.
Shipping & purchases
US basic ground shipping is included: the quote is $0 additional shipping, not a new carrier estimate. International destinations are unsupported for direct orders. Available Soon items have no price or purchasable offer. Tax is calculated at checkout. No endpoint reserves, edits, orders or pays; open an item's public URL for ordinary checkout, which rechecks availability.
Privacy & attribution
Anonymous request counts are private to the owner. Browser referral and related-sale measurement requires opt-in and preserves the first source across visits. Direct API/MCP calls cannot be linked to a buyer. Agent names are classifications, not verified identities. Read Privacy for choices.