search_shop_catalog

fi.rakentajaoutlet/rakentaja-outlet · Verify this server

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.