search_shop_catalog
Search Rakentaja Outlet product catalog.
Rakentaja Outlet (rakentajaoutlet.fi) is a Finnish online store specializing in electrical and construction supplies at outlet prices (~4000 products). All prices in EUR including 25.5% Finnish VAT.
Args:
query: Free-text search — matches product name, SKU, EAN code, or
category name. Leave empty to browse without a search term.
category_id: Filter to products in a specific category (integer ID).
The full list of categories is available at
https://rakentajaoutlet.fi/api/categories — this is a public
REST endpoint, not an MCP tool. Combines with query if both given.
in_stock_only: If True (default), only show products currently in
stock (either in own warehouse or at supplier). Set to False
to include out-of-stock products in results.
sort: Sort order — "name" (default), "price_asc", "price_desc",
or "newest". Ignored when query is given; search results are
ordered by relevance instead.
limit: Maximum products to return (1-50, default 10). Use a small
limit for interactive queries; larger for bulk listing.
page: Page number for paginated results (default 1). Combine with
limit to page through results larger than the limit.
Returns: JSON with keys: - products: list of product summaries with: - id, name, category, brand, sku, ean, unit - price_gross (incl. 25.5% VAT), price_net, currency - description (max 200 chars, description_truncated=true for longer) - available_for_order: boolean — can the customer place an order? (TRUE if in own stock OR supplier stock available) - availability_status: "in_stock" | "supplier_stock" | "out_of_stock" - estimated_delivery_min_days / _max_days: delivery estimate (or null) - in_stock, stock_quantity, supplier_in_stock, supplier_stock_quantity (raw fields — prefer available_for_order + availability_status) - product_url, image_url - total: total matching products across all pages - page: current page number - per_page: products per page (== limit) - total_pages: total pages available - disclaimer: legal notice that prices are indicative and confirmed at checkout
Notes:
- Prices include Finnish 25.5% VAT (price_gross) and net price
(price_net) is shown for VAT-registered business buyers.
- product_url is a direct link to the product page — pass this to
the user for viewing or adding to cart.
- Use get_product_details(id) for full description and stock check.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (>= 1) | |
| sort | No | name | |
| limit | No | Max products to return (1-50) | |
| query | No | Free-text search term | |
| category_id | No | Category ID (see https://rakentajaoutlet.fi/api/categories for the list) | |
| in_stock_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| total | Yes | Total matching products across all pages | |
| per_page | Yes | ||
| products | Yes | ||
| disclaimer | Yes | ||
| total_pages | Yes | ||
| suggested_queries | No | Alternative queries that would return results — populated when total=0 |