Brick Budget

Read explanations of pricing limits, privacy, imports, set savings or the explicit Cart Helper handoff.

get_help

Read cached price records for up to 100 part IDs and six providers in one currency, without joining metadata. BrickLink values are benchmarks, not purchasable seller quotes. Missing prices remain null.

get_part_prices

Read cached price records for up to 100 set IDs and six providers in one currency, without joining metadata. BrickLink minimum values mean from; average values mean average. Source dates can be unknown.

get_set_prices

Read metadata for up to 100 mixed set and part references in one call, preserving input order and reporting missing IDs. Optional language applies only to set names and defaults to English. Prices are separate.

get_items

Read one part by internal catalog ID, including its design, color and website link. Returns null when absent. Fetch prices separately.

get_part

Read one set by internal catalog ID, including its canonical website link. Optional language requests an official name (default English); NameLanguage, NameFallback and NameOfficial identify the actual source. Returns null when absent. Fetch inventory and prices separately.

get_set

Pick one random part from the matching catalog: optional query, categories, colors and excluded IDs. Useful for building challenges and games. Returns null when no part matches; no prices.

get_random_parts

Pick one random set from the matching catalog: optional query, themes, years, size bounds, excluded IDs and official name language (default English). Useful for inspiration and games. Returns null when no set matches; no prices.

get_random_sets

Read statistics with explicit field scopes: set values use the selected provider, part presence covers the catalog, and legacy part ranges mix sources in the selected currency. Comparable price groups keep source, condition and availability separate. No historical lows.

get_item_stats

Resolve public purchase links for item IDs and providers in one currency. Links may be affiliate links. Returning a link does not open it or buy anything.

get_purchase_links

Read a bounded page of a set inventory as part IDs, quantities and inventory types. Follow pages and fetch part metadata or prices separately.

get_set_inventory

Parse supplied CSV, BrickLink XML, BSX or PBG text and resolve parts using website matching rules. At most 500 parsed lines and 3 MiB UTF-8 content, subject to the 4 MiB total JSON request bound. Content is processed transiently, not saved or shared-cache stored. Each row reports exact, fallback, ambiguous or unmatched resolution. Ambiguous rows are not auto-added. Review fallback matches and use prepare_budget_handoff to continue on the website.

import_parts_list

Prepare a LEGO Cart Helper payload of at most 500 total lines from resolved provider links and explicit website handoff instructions. The user must open the handoff page, validate the payload, and confirm sending it to their installed extension. This tool cannot control a browser, fill a cart or check out.

prepare_cart_helper

Estimate a supplied budget of at most 500 total lines using each line selectedProviderId, or the first provider when null. Return known subtotal and missing quantities, never imply an incomplete subtotal is a complete price. For parts, consider a separate find_set_savings call.

quote_budget

Search parts by query, category or color. Optional price bounds and availability require providerId and currencyId; country checks the provider country. Results include separate prices when a provider is selected. IDs identify catalog parts, not retailer element numbers.

search_parts

Search and paginate item prices for one provider and currency, sorted by recorded price. For Set results, optional language selects official name presentation (default English); it is invalid for Part results. Discover providers per currency and availability filters with get_catalog_options. Availability filters use the same normalized values as returned prices: available, unavailable, preorder, backorder or unknown. Unknown does not mean out of stock. Returns item metadata alongside prices. Metadata filters, price bounds and provider-country checks compose before pagination. This is not price-history search.

search_prices

Search sets by query, theme, year, size, group or all required part IDs. Optional language selects an official set-name language (en, pt-PT, es, fr, de, it, da); omitted means English. Search falls back to English only when the requested language has zero total matches. Results report total, searchLanguage and searchFallback. Optional price bounds and availability require providerId and currencyId; country checks that provider country, not delivery coverage. Price filters apply before pagination. Results include separate prices when a provider is selected and matching part quantities when parts are requested.

search_sets

Compute and return a revised copy of a supplied parts budget of at most 500 total lines. Supports add, remove, quantity, provider, clear, set replacement and undo operations on the returned list only. Never saves, clears or changes a stored budget, browser-local budget, cart or order. Retains UUIDs and replacement history in the returned data for later undo.

transform_budget