MCP-Server
rakentaja-outlet
fi.rakentajaoutlet/rakentaja-outlet
Was dieses MCP kann
Searches a Finnish electrical and construction-supplies catalog, provides product and stock details, explains store policies, and creates cart links.
Funktionen
Tools
5
Tools
create_cart_link
Create a pre-filled shopping cart URL for Rakentaja Outlet.
Given a list of product IDs and quantities, returns a URL that the
user can open in their browser. When they open the link, the items
are added to their browser cart session, and they are redirected
either to the cart page (default) or directly to checkout.
This tool is FULLY SIDE-EFFECT-FREE: it does not create the cart on
the server, does not touch any database, and does not modify any
state. The cart materializes only when the user chooses to open the
URL. This is a deliberate security design â the user always
approves cart contents visibly before the state change happens.
Args:
items: List of {"product_id": int, "quantity": int} dicts.
Maximum 20 items, maximum quantity 50 per line.
Use `search_catalog` + `get_product_details` to find IDs first.
checkout: If True, the link takes the user directly to checkout
(skipping the cart review page). Default False â user sees
the cart first, which is safer and more transparent.
Returns:
JSON with:
- url: the browser URL to give the user. Contains all cart items
as query parameters. Opening it will populate their cart.
- items: deduplicated items list that will be added (same product_id
appearing multiple times is merged with combined quantity)
- total_lines: number of unique products in the link
- total_quantity: sum of quantities across all products
- checkout: echoed checkout flag
- disclaimer: legal notice about approval flow
On error, raises MCP ToolError â response has isError:true with
structured JSON: {"error": {"code": "empty_items" | "too_many_items"
| "invalid_item" | "quantity_too_large" | "products_not_found"
| "backend_unavailable", "message": "...", "field": null,
"retryable": true|false}}. The StructuredErrorMiddleware ensures
consistent format across all tools.
Example:
create_cart_link(items=[
{"product_id": 9437, "quantity": 2},
{"product_id": 4927, "quantity": 1},
])
â {"url": "https://rakentajaoutlet.fi/mcp-backend/lisaa-kori?items=9437:2,4927:1", ...}
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', 'required': ['items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['product_id', 'quantity'], 'properties': {'quantity': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Quantity to add (1-50)'}, 'product_id': {'type': 'integer', 'minimum': 1, 'description': 'Product ID from search_catalog results'}}, 'description': 'One line in the cart URL.'}, 'maxItems': 20, 'minItems': 1, 'description': 'Cart items (1-20 lines)'}, 'checkout': {'type': 'boolean', 'default': False, 'description': 'If True, link goes directly to checkout; otherwise to cart review page'}}}
Ausgabeschema
{'type': 'object', '$defs': {'CartItemRef': {'type': 'object', 'title': 'CartItemRef', 'required': ['product_id', 'quantity'], 'properties': {'quantity': {'type': 'integer', 'title': 'Quantity'}, 'product_id': {'type': 'integer', 'title': 'Product Id'}}, 'description': 'Yksi kori-linkin tuoterivi (normalisoitu, deduplikoitu).'}}, 'title': 'CreateCartLinkResult', 'required': ['url', 'items', 'total_lines', 'total_quantity', 'checkout', 'disclaimer'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'description': 'Browser URL to give the user â\x80\x94 opening it populates their cart'}, 'items': {'type': 'array', 'items': {'$ref': '#/$defs/CartItemRef'}, 'title': 'Items', 'description': 'Deduplicated cart items'}, 'checkout': {'type': 'boolean', 'title': 'Checkout', 'description': 'If true, link takes user directly to checkout'}, 'disclaimer': {'type': 'string', 'title': 'Disclaimer'}, 'total_lines': {'type': 'integer', 'title': 'Total Lines', 'description': 'Number of unique products in link'}, 'total_quantity': {'type': 'integer', 'title': 'Total Quantity', 'description': 'Sum of quantities across all products'}}, 'description': 'Return type for create_cart_link (successful case).'}
get_product_details
Get full details for a single Rakentaja Outlet product.
Fetches both the product record and a real-time availability check
in parallel. Use this after `search_catalog` returns a product ID
to show the user complete information (full description, all images,
current stock).
Args:
product_id: Product ID from `search_catalog` results (integer).
Returns:
JSON with product details:
- id, name, sku, ean, brand, category
- description (full HTML/text), description_short
- price_gross (incl. 25.5% VAT), price_net, vat_percent, currency
- available_for_order (bool), availability_status ("in_stock" |
"supplier_stock" | "out_of_stock"), estimated_delivery_min_days,
estimated_delivery_max_days
- in_stock, stock_quantity, supplier_in_stock, supplier_stock_quantity
(raw fields â prefer available_for_order + availability_status)
- weight_kg, unit
- product_url (direct link to product page)
- image_url (main image), images (list of all image URLs)
- availability: fresh stock check result (may be more current than
stock_quantity if inventory changed since catalog was cached)
- disclaimer: legal notice that prices are indicative
On error, raises MCP ToolError â response has isError:true with
structured JSON: {"error": {"code": "not_found" | "invalid_argument"
| "backend_unavailable", "message": "...", "field": null|str,
"retryable": true|false}}. The StructuredErrorMiddleware ensures
the format is consistent across all tools.
Notes:
- Prices include Finnish 25.5% VAT. Business buyers see price_net
for VAT-registered net price.
- Pass `product_url` to the user for viewing or adding to cart â
do not attempt to add to cart via this tool (use create_cart_link).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['product_id'], 'properties': {'product_id': {'type': 'integer', 'minimum': 1, 'description': 'Product ID from search_catalog results'}}}
Ausgabeschema
{'type': 'object', '$defs': {'AvailabilityInfo': {'type': 'object', 'title': 'AvailabilityInfo', 'required': ['product_id', 'in_stock', 'stock_quantity', 'supplier_in_stock', 'supplier_stock_quantity'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Name', 'default': None}, 'unit': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Unit', 'default': None}, 'in_stock': {'type': 'boolean', 'title': 'In Stock'}, 'product_id': {'type': 'integer', 'title': 'Product Id'}, 'stock_quantity': {'type': 'integer', 'title': 'Stock Quantity'}, 'supplier_in_stock': {'type': 'boolean', 'title': 'Supplier In Stock'}, 'supplier_stock_quantity': {'type': 'integer', 'title': 'Supplier Stock Quantity'}}, 'description': 'Reaaliaikainen saatavuus (get_product_details:in `availability`-kentässä).'}}, 'title': 'ProductDetails', 'required': ['id', 'name', 'price_gross', 'price_net', 'available_for_order', 'availability_status', 'in_stock', 'stock_quantity', 'supplier_in_stock', 'supplier_stock_quantity', 'product_url', 'description', 'disclaimer'], 'properties': {'id': {'type': 'integer', 'title': 'Id', 'description': 'Product ID (use with get_product_details for full info)'}, 'ean': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ean', 'default': None}, 'sku': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sku', 'default': None}, 'name': {'type': 'string', 'title': 'Name'}, 'unit': {'type': 'string', 'title': 'Unit', 'default': 'kpl'}, 'brand': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Brand', 'default': None}, 'images': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Images', 'description': 'All product image URLs'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'currency': {'type': 'string', 'const': 'EUR', 'title': 'Currency', 'default': 'EUR'}, 'in_stock': {'type': 'boolean', 'title': 'In Stock'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Image Url', 'default': None}, 'price_net': {'type': 'number', 'title': 'Price Net', 'description': 'Net price for VAT-registered business buyers'}, 'weight_kg': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Weight Kg', 'default': None}, 'disclaimer': {'type': 'string', 'title': 'Disclaimer'}, 'description': {'type': 'string', 'title': 'Description', 'description': 'Full product description (may contain HTML)'}, 'price_gross': {'type': 'number', 'title': 'Price Gross', 'description': 'Gross price incl. 25.5% Finnish VAT'}, 'product_url': {'type': 'string', 'title': 'Product Url', 'description': 'Direct link to product page â\x80\x94 pass this to the user'}, 'vat_percent': {'type': 'number', 'title': 'Vat Percent', 'default': 25.5}, 'availability': {'anyOf': [{'$ref': '#/$defs/AvailabilityInfo'}, {'type': 'null'}], 'default': None, 'description': 'Fresh availability check (may be more current than stock_quantity)'}, 'stock_quantity': {'type': 'integer', 'title': 'Stock Quantity'}, 'description_short': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Description Short', 'default': None}, 'supplier_in_stock': {'type': 'boolean', 'title': 'Supplier In Stock'}, 'availability_status': {'enum': ['in_stock', 'supplier_stock', 'out_of_stock'], 'type': 'string', 'title': 'Availability Status', 'description': 'Detailed status: in_stock = own warehouse, supplier_stock = from supplier'}, 'available_for_order': {'type': 'boolean', 'title': 'Available For Order', 'description': 'Whether customer can order this â\x80\x94 TRUE if in own stock OR supplier stock available'}, 'supplier_stock_quantity': {'type': 'integer', 'title': 'Supplier Stock Quantity'}, 'estimated_delivery_max_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Max Days', 'default': None, 'description': 'Hitain toimitusarvio arkipäivinä (null = ei saatavilla)'}, 'estimated_delivery_min_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Min Days', 'default': None, 'description': 'Nopein toimitusarvio arkipäivinä (null = ei saatavilla)'}}, 'description': 'get_product_details -tuloksen tuote (täysi description + kuvat + availability).'}
search_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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number (>= 1)'}, 'sort': {'enum': ['name', 'price_asc', 'price_desc', 'newest'], 'type': 'string', 'default': 'name'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Max products to return (1-50)'}, 'query': {'type': 'string', 'default': '', 'description': 'Free-text search term'}, 'category_id': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Category ID (see https://rakentajaoutlet.fi/api/categories for the list)'}, 'in_stock_only': {'type': 'boolean', 'default': True}}}
Ausgabeschema
{'type': 'object', '$defs': {'ProductSummary': {'type': 'object', 'title': 'ProductSummary', 'required': ['id', 'name', 'price_gross', 'price_net', 'available_for_order', 'availability_status', 'in_stock', 'stock_quantity', 'supplier_in_stock', 'supplier_stock_quantity', 'product_url', 'description'], 'properties': {'id': {'type': 'integer', 'title': 'Id', 'description': 'Product ID (use with get_product_details for full info)'}, 'ean': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ean', 'default': None}, 'sku': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sku', 'default': None}, 'name': {'type': 'string', 'title': 'Name'}, 'unit': {'type': 'string', 'title': 'Unit', 'default': 'kpl'}, 'brand': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Brand', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'currency': {'type': 'string', 'const': 'EUR', 'title': 'Currency', 'default': 'EUR'}, 'in_stock': {'type': 'boolean', 'title': 'In Stock'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Image Url', 'default': None}, 'price_net': {'type': 'number', 'title': 'Price Net', 'description': 'Net price for VAT-registered business buyers'}, 'weight_kg': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Weight Kg', 'default': None}, 'description': {'type': 'string', 'title': 'Description', 'description': 'Product description (max 200 chars â\x80\x94 check description_truncated for full text availability)'}, 'price_gross': {'type': 'number', 'title': 'Price Gross', 'description': 'Gross price incl. 25.5% Finnish VAT'}, 'product_url': {'type': 'string', 'title': 'Product Url', 'description': 'Direct link to product page â\x80\x94 pass this to the user'}, 'vat_percent': {'type': 'number', 'title': 'Vat Percent', 'default': 25.5}, 'stock_quantity': {'type': 'integer', 'title': 'Stock Quantity'}, 'supplier_in_stock': {'type': 'boolean', 'title': 'Supplier In Stock'}, 'availability_status': {'enum': ['in_stock', 'supplier_stock', 'out_of_stock'], 'type': 'string', 'title': 'Availability Status', 'description': 'Detailed status: in_stock = own warehouse, supplier_stock = from supplier'}, 'available_for_order': {'type': 'boolean', 'title': 'Available For Order', 'description': 'Whether customer can order this â\x80\x94 TRUE if in own stock OR supplier stock available'}, 'description_truncated': {'type': 'boolean', 'title': 'Description Truncated', 'default': False, 'description': 'If TRUE, full description is longer â\x80\x94 use get_product_details to fetch it'}, 'supplier_stock_quantity': {'type': 'integer', 'title': 'Supplier Stock Quantity'}, 'estimated_delivery_max_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Max Days', 'default': None, 'description': 'Hitain toimitusarvio arkipäivinä (null = ei saatavilla)'}, 'estimated_delivery_min_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Min Days', 'default': None, 'description': 'Nopein toimitusarvio arkipäivinä (null = ei saatavilla)'}}, 'description': 'search_catalog-tulosten yksi tuote (lyhyt description).'}}, 'title': 'SearchCatalogResult', 'required': ['products', 'total', 'page', 'per_page', 'total_pages', 'disclaimer'], 'properties': {'page': {'type': 'integer', 'title': 'Page'}, 'total': {'type': 'integer', 'title': 'Total', 'description': 'Total matching products across all pages'}, 'per_page': {'type': 'integer', 'title': 'Per Page'}, 'products': {'type': 'array', 'items': {'$ref': '#/$defs/ProductSummary'}, 'title': 'Products'}, 'disclaimer': {'type': 'string', 'title': 'Disclaimer'}, 'total_pages': {'type': 'integer', 'title': 'Total Pages'}, 'suggested_queries': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Suggested Queries', 'default': None, 'description': 'Alternative queries that would return results â\x80\x94 populated when total=0'}}, 'description': 'Return type for search_catalog.'}
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number (>= 1)'}, 'sort': {'enum': ['name', 'price_asc', 'price_desc', 'newest'], 'type': 'string', 'default': 'name'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Max products to return (1-50)'}, 'query': {'type': 'string', 'default': '', 'description': 'Free-text search term'}, 'category_id': {'anyOf': [{'type': 'integer', 'minimum': 1}, {'type': 'null'}], 'default': None, 'description': 'Category ID (see https://rakentajaoutlet.fi/api/categories for the list)'}, 'in_stock_only': {'type': 'boolean', 'default': True}}}
Ausgabeschema
{'type': 'object', '$defs': {'ProductSummary': {'type': 'object', 'title': 'ProductSummary', 'required': ['id', 'name', 'price_gross', 'price_net', 'available_for_order', 'availability_status', 'in_stock', 'stock_quantity', 'supplier_in_stock', 'supplier_stock_quantity', 'product_url', 'description'], 'properties': {'id': {'type': 'integer', 'title': 'Id', 'description': 'Product ID (use with get_product_details for full info)'}, 'ean': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ean', 'default': None}, 'sku': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sku', 'default': None}, 'name': {'type': 'string', 'title': 'Name'}, 'unit': {'type': 'string', 'title': 'Unit', 'default': 'kpl'}, 'brand': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Brand', 'default': None}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Category', 'default': None}, 'currency': {'type': 'string', 'const': 'EUR', 'title': 'Currency', 'default': 'EUR'}, 'in_stock': {'type': 'boolean', 'title': 'In Stock'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Image Url', 'default': None}, 'price_net': {'type': 'number', 'title': 'Price Net', 'description': 'Net price for VAT-registered business buyers'}, 'weight_kg': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Weight Kg', 'default': None}, 'description': {'type': 'string', 'title': 'Description', 'description': 'Product description (max 200 chars â\x80\x94 check description_truncated for full text availability)'}, 'price_gross': {'type': 'number', 'title': 'Price Gross', 'description': 'Gross price incl. 25.5% Finnish VAT'}, 'product_url': {'type': 'string', 'title': 'Product Url', 'description': 'Direct link to product page â\x80\x94 pass this to the user'}, 'vat_percent': {'type': 'number', 'title': 'Vat Percent', 'default': 25.5}, 'stock_quantity': {'type': 'integer', 'title': 'Stock Quantity'}, 'supplier_in_stock': {'type': 'boolean', 'title': 'Supplier In Stock'}, 'availability_status': {'enum': ['in_stock', 'supplier_stock', 'out_of_stock'], 'type': 'string', 'title': 'Availability Status', 'description': 'Detailed status: in_stock = own warehouse, supplier_stock = from supplier'}, 'available_for_order': {'type': 'boolean', 'title': 'Available For Order', 'description': 'Whether customer can order this â\x80\x94 TRUE if in own stock OR supplier stock available'}, 'description_truncated': {'type': 'boolean', 'title': 'Description Truncated', 'default': False, 'description': 'If TRUE, full description is longer â\x80\x94 use get_product_details to fetch it'}, 'supplier_stock_quantity': {'type': 'integer', 'title': 'Supplier Stock Quantity'}, 'estimated_delivery_max_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Max Days', 'default': None, 'description': 'Hitain toimitusarvio arkipäivinä (null = ei saatavilla)'}, 'estimated_delivery_min_days': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Estimated Delivery Min Days', 'default': None, 'description': 'Nopein toimitusarvio arkipäivinä (null = ei saatavilla)'}}, 'description': 'search_catalog-tulosten yksi tuote (lyhyt description).'}}, 'title': 'SearchCatalogResult', 'required': ['products', 'total', 'page', 'per_page', 'total_pages', 'disclaimer'], 'properties': {'page': {'type': 'integer', 'title': 'Page'}, 'total': {'type': 'integer', 'title': 'Total', 'description': 'Total matching products across all pages'}, 'per_page': {'type': 'integer', 'title': 'Per Page'}, 'products': {'type': 'array', 'items': {'$ref': '#/$defs/ProductSummary'}, 'title': 'Products'}, 'disclaimer': {'type': 'string', 'title': 'Disclaimer'}, 'total_pages': {'type': 'integer', 'title': 'Total Pages'}, 'suggested_queries': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Suggested Queries', 'default': None, 'description': 'Alternative queries that would return results â\x80\x94 populated when total=0'}}, 'description': 'Return type for search_catalog.'}
search_shop_policies_and_faqs
Search Rakentaja Outlet shop policies, FAQ, and store info.
Searches across 8 pages: About Us (tietoa-meista), FAQ
(usein-kysyttya), Delivery terms (toimitusehdot), Privacy Policy
(tietosuoja), Terms of Use (kayttoehdot), Return Form (peruutuslomake),
Payment Methods (maksutavat), AI Agent Guide (ai).
Use this tool when the user asks about:
- Delivery times and costs ("toimitusaika", "toimituskulu")
- Returns and refunds ("palautus", "peruutus", "hyvitys")
- Payment methods ("maksutavat", "lasku")
- Privacy or GDPR ("tietosuoja", "GDPR")
- Terms of use ("käyttöehdot")
- Company information ("Sanere Oy", "yhteystiedot", "Y-tunnus")
- Any general question about buying from the store
Args:
query: Free-text search term (Finnish). Case-insensitive.
Leave empty to get an overview of all policy pages.
limit: Maximum sections to return (1-10, default 5). Each section
is a paragraph or Q&A pair; longer content is truncated.
Returns:
JSON with:
- sections: list of matching sections, each with:
- page_slug: e.g. "usein-kysyttya"
- page_title: e.g. "Usein kysyttyä"
- page_url: full URL to the page
- heading: section heading if any
- text: matching text content (may be truncated)
- is_faq: True if this is a Q&A from the FAQ page
- total_matches: total sections matched
- query: echoed query
- available_pages: list of all policy page slugs
- disclaimer: legal reminder to check the full page
Notes:
- Policies are the authoritative source; if unclear, direct the
user to the page_url for the full text.
- Some FAQ entries are marked with FAQPage schema.org markup â
these show up as Google rich results.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Max sections to return (1-10)'}, 'query': {'type': 'string', 'default': '', 'description': 'Free-text search term (Finnish)'}}}
Ausgabeschema
{'type': 'object', '$defs': {'PolicySection': {'type': 'object', 'title': 'PolicySection', 'required': ['page_slug', 'page_title', 'page_url', 'heading', 'text', 'is_faq'], 'properties': {'text': {'type': 'string', 'title': 'Text', 'description': 'Section text or FAQ answer (may be truncated to 500 chars)'}, 'is_faq': {'type': 'boolean', 'title': 'Is Faq', 'description': 'TRUE if this is a Q&A pair from the FAQ page'}, 'heading': {'type': 'string', 'title': 'Heading', 'description': 'Section heading or FAQ question'}, 'page_url': {'type': 'string', 'title': 'Page Url'}, 'page_slug': {'type': 'string', 'title': 'Page Slug', 'description': 'Page identifier (e.g. "usein-kysyttya")'}, 'page_title': {'type': 'string', 'title': 'Page Title'}}, 'description': 'Yksi kauppaehto/FAQ-sektio.'}}, 'title': 'PolicySearchResult', 'required': ['sections', 'total_matches', 'query', 'available_pages', 'disclaimer'], 'properties': {'query': {'type': 'string', 'title': 'Query', 'description': 'Echoed query'}, 'sections': {'type': 'array', 'items': {'$ref': '#/$defs/PolicySection'}, 'title': 'Sections', 'description': 'Matching sections (limited by `limit`)'}, 'disclaimer': {'type': 'string', 'title': 'Disclaimer'}, 'total_matches': {'type': 'integer', 'title': 'Total Matches', 'description': 'Total sections matched (may be > len(sections) if limited)'}, 'available_pages': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Available Pages', 'description': 'All 8 policy page slugs'}}, 'description': 'Return type for search_shop_policies_and_faqs.'}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
search_shop_policies_and_faqs
17. September 2026 12:39
Hinzugefügt
create_cart_link
17. September 2026 12:39
Hinzugefügt
get_product_details
17. September 2026 12:39
Hinzugefügt
search_shop_catalog
17. September 2026 12:39
Hinzugefügt
search_catalog
17. September 2026 12:39
Entdecken
Ähnliche MCP-Server
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
SpellBook Finance
com.spellbook-finance/mcp
Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Digital Manager Guru
io.github.mcp-dir/guru-mcp
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
io.github.mcp-dir/pagarme-mcp
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
AgentLux
io.github.agentlux/agentlux
Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…