search_shop_catalog
Search the Okun Koneosa product catalog.
Okun Koneosa Oy (okunkoneosa.fi) is a Finnish industrial supplies store in Outokumpu, North Karelia. Around 6500 products: bearings, belts, seals, hydraulics, pneumatics, fasteners, hand tools, protective equipment and machine parts. Everything listed is physically in stock. Prices in EUR, including Finnish VAT 25.5%. Free shipping on orders over 150 EUR.
Args: query: Free-text search — matches product name, ordering number (SKU) or EAN code. Leave empty to browse a category. category_id: Restrict to one category. The category list is available at https://okunkoneosa.fi/api/v1/categories (a plain REST endpoint, not an MCP tool). in_stock_only: True by default. The shop only publishes products that are in stock, so this rarely changes the result. sort: "name" (default), "price_asc", "price_desc" or "newest". limit: Products per page, 1-50 (default 10). page: Page number for paging through larger result sets.
Returns: JSON with: - products: list of products, each with id, name, name_raw, sku, ean, brand, category, price_gross (incl. VAT), price_net, currency, unit, in_stock, stock_quantity, weight_kg, product_url, image_url and a shortened description (description_truncated tells if it was cut). - total, page, per_page, total_pages - disclaimer: prices and availability are confirmed at checkout
Notes:
- name is cleaned for reading; name_raw is the supplier's own
spelling, useful for exact matching against a supplier catalogue.
- image_url is null for most products — the shop is still collecting
product photography from suppliers. A missing image does not mean the
product is unavailable.
- Use get_product_details(id) for the full description and a fresh
stock check.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (>= 1) | |
| sort | No | name | |
| limit | No | 1-50 | |
| query | No | Free-text search term | |
| category_id | No | Category ID | |
| in_stock_only | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| total | Yes | Total matches across all pages | |
| per_page | Yes | ||
| products | No | ||
| disclaimer | Yes | ||
| total_pages | Yes | ||
| suggested_queries | No | Alternative spellings that DO return results — only present when total is 0 |