Server definition
- Hash
- sha256:3d60cf486c604b4ffc51874e3027c4574c715196c192397556dbef5f5f0621f9
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Create a pre-filled shopping cart URL for Rakentaja Outlet.\n\nGiven a list of product IDs and quantities, returns a URL that the\nuser can open in their browser. When they open the link, the items\nare added to their browser cart session, and they are redirected\neither to the cart page (default) or directly to checkout.\n\nThis tool is FULLY SIDE-EFFECT-FREE: it does not create the cart on\nthe server, does not touch any database, and does not modify any\nstate. The cart materializes only when the user chooses to open the\nURL. This is a deliberate security design — the user always\napproves cart contents visibly before the state change happens.\n\nArgs:\n items: List of {\"product_id\": int, \"quantity\": int} dicts.\n Maximum 20 items, maximum quantity 50 per line.\n Use `search_catalog` + `get_product_details` to find IDs first.\n checkout: If True, the link takes the user directly to checkout\n (skipping the cart review page). Default False — user sees\n the cart first, which is safer and more transparent.\n\nReturns:\n JSON with:\n - url: the browser URL to give the user. Contains all cart items\n as query parameters. Opening it will populate their cart.\n - items: deduplicated items list that will be added (same product_id\n appearing multiple times is merged with combined quantity)\n - total_lines: number of unique products in the link\n - total_quantity: sum of quantities across all products\n - checkout: echoed checkout flag\n - disclaimer: legal notice about approval flow\n\n On error, raises MCP ToolError → response has isError:true with\n structured JSON: {\"error\": {\"code\": \"empty_items\" | \"too_many_items\"\n | \"invalid_item\" | \"quantity_too_large\" | \"products_not_found\"\n | \"backend_unavailable\", \"message\": \"...\", \"field\": null,\n \"retryable\": true|false}}. The StructuredErrorMiddleware ensures\n consistent format across all tools.\n\nExample:\n create_cart_link(items=[\n {\"product_id\": 9437, \"quantity\": 2},\n {\"product_id\": 4927, \"quantity\": 1},\n ])\n → {\"url\": \"https://rakentajaoutlet.fi/mcp-backend/lisaa-kori?items=9437:2,4927:1\", ...}",
"inputSchema": {
"properties": {
"checkout": {
"default": false,
"description": "If True, link goes directly to checkout; otherwise to cart review page",
"type": "boolean"
},
"items": {
"description": "Cart items (1-20 lines)",
"items": {
"description": "One line in the cart URL.",
"properties": {
"product_id": {
"description": "Product ID from search_catalog results",
"minimum": 1,
"type": "integer"
},
"quantity": {
"description": "Quantity to add (1-50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"product_id",
"quantity"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "create_cart_link",
"outputSchema": {
"$defs": {
"CartItemRef": {
"description": "Yksi kori-linkin tuoterivi (normalisoitu, deduplikoitu).",
"properties": {
"product_id": {
"title": "Product Id",
"type": "integer"
},
"quantity": {
"title": "Quantity",
"type": "integer"
}
},
"required": [
"product_id",
"quantity"
],
"title": "CartItemRef",
"type": "object"
}
},
"description": "Return type for create_cart_link (successful case).",
"properties": {
"checkout": {
"description": "If true, link takes user directly to checkout",
"title": "Checkout",
"type": "boolean"
},
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"items": {
"description": "Deduplicated cart items",
"items": {
"$ref": "#/$defs/CartItemRef"
},
"title": "Items",
"type": "array"
},
"total_lines": {
"description": "Number of unique products in link",
"title": "Total Lines",
"type": "integer"
},
"total_quantity": {
"description": "Sum of quantities across all products",
"title": "Total Quantity",
"type": "integer"
},
"url": {
"description": "Browser URL to give the user — opening it populates their cart",
"title": "Url",
"type": "string"
}
},
"required": [
"url",
"items",
"total_lines",
"total_quantity",
"checkout",
"disclaimer"
],
"title": "CreateCartLinkResult",
"type": "object"
}
},
{
"description": "Get full details for a single Rakentaja Outlet product.\n\nFetches both the product record and a real-time availability check\nin parallel. Use this after `search_catalog` returns a product ID\nto show the user complete information (full description, all images,\ncurrent stock).\n\nArgs:\n product_id: Product ID from `search_catalog` results (integer).\n\nReturns:\n JSON with product details:\n - id, name, sku, ean, brand, category\n - description (full HTML/text), description_short\n - price_gross (incl. 25.5% VAT), price_net, vat_percent, currency\n - available_for_order (bool), availability_status (\"in_stock\" |\n \"supplier_stock\" | \"out_of_stock\"), estimated_delivery_min_days,\n estimated_delivery_max_days\n - in_stock, stock_quantity, supplier_in_stock, supplier_stock_quantity\n (raw fields — prefer available_for_order + availability_status)\n - weight_kg, unit\n - product_url (direct link to product page)\n - image_url (main image), images (list of all image URLs)\n - availability: fresh stock check result (may be more current than\n stock_quantity if inventory changed since catalog was cached)\n - disclaimer: legal notice that prices are indicative\n\n On error, raises MCP ToolError → response has isError:true with\n structured JSON: {\"error\": {\"code\": \"not_found\" | \"invalid_argument\"\n | \"backend_unavailable\", \"message\": \"...\", \"field\": null|str,\n \"retryable\": true|false}}. The StructuredErrorMiddleware ensures\n the format is consistent across all tools.\n\nNotes:\n - Prices include Finnish 25.5% VAT. Business buyers see price_net\n for VAT-registered net price.\n - Pass `product_url` to the user for viewing or adding to cart —\n do not attempt to add to cart via this tool (use create_cart_link).",
"inputSchema": {
"properties": {
"product_id": {
"description": "Product ID from search_catalog results",
"minimum": 1,
"type": "integer"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "get_product_details",
"outputSchema": {
"$defs": {
"AvailabilityInfo": {
"description": "Reaaliaikainen saatavuus (get_product_details:in `availability`-kentässä).",
"properties": {
"in_stock": {
"title": "In Stock",
"type": "boolean"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"product_id": {
"title": "Product Id",
"type": "integer"
},
"stock_quantity": {
"title": "Stock Quantity",
"type": "integer"
},
"supplier_in_stock": {
"title": "Supplier In Stock",
"type": "boolean"
},
"supplier_stock_quantity": {
"title": "Supplier Stock Quantity",
"type": "integer"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unit"
}
},
"required": [
"product_id",
"in_stock",
"stock_quantity",
"supplier_in_stock",
"supplier_stock_quantity"
],
"title": "AvailabilityInfo",
"type": "object"
}
},
"description": "get_product_details -tuloksen tuote (täysi description + kuvat + availability).",
"properties": {
"availability": {
"anyOf": [
{
"$ref": "#/$defs/AvailabilityInfo"
},
{
"type": "null"
}
],
"default": null,
"description": "Fresh availability check (may be more current than stock_quantity)"
},
"availability_status": {
"description": "Detailed status: in_stock = own warehouse, supplier_stock = from supplier",
"enum": [
"in_stock",
"supplier_stock",
"out_of_stock"
],
"title": "Availability Status",
"type": "string"
},
"available_for_order": {
"description": "Whether customer can order this — TRUE if in own stock OR supplier stock available",
"title": "Available For Order",
"type": "boolean"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"currency": {
"const": "EUR",
"default": "EUR",
"title": "Currency",
"type": "string"
},
"description": {
"description": "Full product description (may contain HTML)",
"title": "Description",
"type": "string"
},
"description_short": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description Short"
},
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"ean": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ean"
},
"estimated_delivery_max_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Hitain toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Max Days"
},
"estimated_delivery_min_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Nopein toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Min Days"
},
"id": {
"description": "Product ID (use with get_product_details for full info)",
"title": "Id",
"type": "integer"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Url"
},
"images": {
"description": "All product image URLs",
"items": {
"type": "string"
},
"title": "Images",
"type": "array"
},
"in_stock": {
"title": "In Stock",
"type": "boolean"
},
"name": {
"title": "Name",
"type": "string"
},
"price_gross": {
"description": "Gross price incl. 25.5% Finnish VAT",
"title": "Price Gross",
"type": "number"
},
"price_net": {
"description": "Net price for VAT-registered business buyers",
"title": "Price Net",
"type": "number"
},
"product_url": {
"description": "Direct link to product page — pass this to the user",
"title": "Product Url",
"type": "string"
},
"sku": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sku"
},
"stock_quantity": {
"title": "Stock Quantity",
"type": "integer"
},
"supplier_in_stock": {
"title": "Supplier In Stock",
"type": "boolean"
},
"supplier_stock_quantity": {
"title": "Supplier Stock Quantity",
"type": "integer"
},
"unit": {
"default": "kpl",
"title": "Unit",
"type": "string"
},
"vat_percent": {
"default": 25.5,
"title": "Vat Percent",
"type": "number"
},
"weight_kg": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight Kg"
}
},
"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"
],
"title": "ProductDetails",
"type": "object"
}
},
{
"description": "Search Rakentaja Outlet product catalog.\n\nRakentaja Outlet (rakentajaoutlet.fi) is a Finnish online store specializing\nin electrical and construction supplies at outlet prices (~4000 products).\nAll prices in EUR including 25.5% Finnish VAT.\n\nArgs:\n query: Free-text search — matches product name, SKU, EAN code, or\n category name. Leave empty to browse without a search term.\n category_id: Filter to products in a specific category (integer ID).\n The full list of categories is available at\n https://rakentajaoutlet.fi/api/categories — this is a public\n REST endpoint, not an MCP tool. Combines with query if both given.\n in_stock_only: If True (default), only show products currently in\n stock (either in own warehouse or at supplier). Set to False\n to include out-of-stock products in results.\n sort: Sort order — \"name\" (default), \"price_asc\", \"price_desc\",\n or \"newest\". Ignored when query is given; search results are\n ordered by relevance instead.\n limit: Maximum products to return (1-50, default 10). Use a small\n limit for interactive queries; larger for bulk listing.\n page: Page number for paginated results (default 1). Combine with\n `limit` to page through results larger than the limit.\n\nReturns:\n JSON with keys:\n - products: list of product summaries with:\n - id, name, category, brand, sku, ean, unit\n - price_gross (incl. 25.5% VAT), price_net, currency\n - description (max 200 chars, description_truncated=true for longer)\n - available_for_order: boolean — can the customer place an order?\n (TRUE if in own stock OR supplier stock available)\n - availability_status: \"in_stock\" | \"supplier_stock\" | \"out_of_stock\"\n - estimated_delivery_min_days / _max_days: delivery estimate (or null)\n - in_stock, stock_quantity, supplier_in_stock, supplier_stock_quantity\n (raw fields — prefer available_for_order + availability_status)\n - product_url, image_url\n - total: total matching products across all pages\n - page: current page number\n - per_page: products per page (== limit)\n - total_pages: total pages available\n - disclaimer: legal notice that prices are indicative and confirmed\n at checkout\n\nNotes:\n - Prices include Finnish 25.5% VAT (price_gross) and net price\n (price_net) is shown for VAT-registered business buyers.\n - product_url is a direct link to the product page — pass this to\n the user for viewing or adding to cart.\n - Use `get_product_details(id)` for full description and stock check.",
"inputSchema": {
"properties": {
"category_id": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Category ID (see https://rakentajaoutlet.fi/api/categories for the list)"
},
"in_stock_only": {
"default": true,
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Max products to return (1-50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number (>= 1)",
"minimum": 1,
"type": "integer"
},
"query": {
"default": "",
"description": "Free-text search term",
"type": "string"
},
"sort": {
"default": "name",
"enum": [
"name",
"price_asc",
"price_desc",
"newest"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_catalog",
"outputSchema": {
"$defs": {
"ProductSummary": {
"description": "search_catalog-tulosten yksi tuote (lyhyt description).",
"properties": {
"availability_status": {
"description": "Detailed status: in_stock = own warehouse, supplier_stock = from supplier",
"enum": [
"in_stock",
"supplier_stock",
"out_of_stock"
],
"title": "Availability Status",
"type": "string"
},
"available_for_order": {
"description": "Whether customer can order this — TRUE if in own stock OR supplier stock available",
"title": "Available For Order",
"type": "boolean"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"currency": {
"const": "EUR",
"default": "EUR",
"title": "Currency",
"type": "string"
},
"description": {
"description": "Product description (max 200 chars — check description_truncated for full text availability)",
"title": "Description",
"type": "string"
},
"description_truncated": {
"default": false,
"description": "If TRUE, full description is longer — use get_product_details to fetch it",
"title": "Description Truncated",
"type": "boolean"
},
"ean": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ean"
},
"estimated_delivery_max_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Hitain toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Max Days"
},
"estimated_delivery_min_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Nopein toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Min Days"
},
"id": {
"description": "Product ID (use with get_product_details for full info)",
"title": "Id",
"type": "integer"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Url"
},
"in_stock": {
"title": "In Stock",
"type": "boolean"
},
"name": {
"title": "Name",
"type": "string"
},
"price_gross": {
"description": "Gross price incl. 25.5% Finnish VAT",
"title": "Price Gross",
"type": "number"
},
"price_net": {
"description": "Net price for VAT-registered business buyers",
"title": "Price Net",
"type": "number"
},
"product_url": {
"description": "Direct link to product page — pass this to the user",
"title": "Product Url",
"type": "string"
},
"sku": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sku"
},
"stock_quantity": {
"title": "Stock Quantity",
"type": "integer"
},
"supplier_in_stock": {
"title": "Supplier In Stock",
"type": "boolean"
},
"supplier_stock_quantity": {
"title": "Supplier Stock Quantity",
"type": "integer"
},
"unit": {
"default": "kpl",
"title": "Unit",
"type": "string"
},
"vat_percent": {
"default": 25.5,
"title": "Vat Percent",
"type": "number"
},
"weight_kg": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight Kg"
}
},
"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"
],
"title": "ProductSummary",
"type": "object"
}
},
"description": "Return type for search_catalog.",
"properties": {
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"page": {
"title": "Page",
"type": "integer"
},
"per_page": {
"title": "Per Page",
"type": "integer"
},
"products": {
"items": {
"$ref": "#/$defs/ProductSummary"
},
"title": "Products",
"type": "array"
},
"suggested_queries": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Alternative queries that would return results — populated when total=0",
"title": "Suggested Queries"
},
"total": {
"description": "Total matching products across all pages",
"title": "Total",
"type": "integer"
},
"total_pages": {
"title": "Total Pages",
"type": "integer"
}
},
"required": [
"products",
"total",
"page",
"per_page",
"total_pages",
"disclaimer"
],
"title": "SearchCatalogResult",
"type": "object"
}
},
{
"description": "Search Rakentaja Outlet product catalog.\n\nRakentaja Outlet (rakentajaoutlet.fi) is a Finnish online store specializing\nin electrical and construction supplies at outlet prices (~4000 products).\nAll prices in EUR including 25.5% Finnish VAT.\n\nArgs:\n query: Free-text search — matches product name, SKU, EAN code, or\n category name. Leave empty to browse without a search term.\n category_id: Filter to products in a specific category (integer ID).\n The full list of categories is available at\n https://rakentajaoutlet.fi/api/categories — this is a public\n REST endpoint, not an MCP tool. Combines with query if both given.\n in_stock_only: If True (default), only show products currently in\n stock (either in own warehouse or at supplier). Set to False\n to include out-of-stock products in results.\n sort: Sort order — \"name\" (default), \"price_asc\", \"price_desc\",\n or \"newest\". Ignored when query is given; search results are\n ordered by relevance instead.\n limit: Maximum products to return (1-50, default 10). Use a small\n limit for interactive queries; larger for bulk listing.\n page: Page number for paginated results (default 1). Combine with\n `limit` to page through results larger than the limit.\n\nReturns:\n JSON with keys:\n - products: list of product summaries with:\n - id, name, category, brand, sku, ean, unit\n - price_gross (incl. 25.5% VAT), price_net, currency\n - description (max 200 chars, description_truncated=true for longer)\n - available_for_order: boolean — can the customer place an order?\n (TRUE if in own stock OR supplier stock available)\n - availability_status: \"in_stock\" | \"supplier_stock\" | \"out_of_stock\"\n - estimated_delivery_min_days / _max_days: delivery estimate (or null)\n - in_stock, stock_quantity, supplier_in_stock, supplier_stock_quantity\n (raw fields — prefer available_for_order + availability_status)\n - product_url, image_url\n - total: total matching products across all pages\n - page: current page number\n - per_page: products per page (== limit)\n - total_pages: total pages available\n - disclaimer: legal notice that prices are indicative and confirmed\n at checkout\n\nNotes:\n - Prices include Finnish 25.5% VAT (price_gross) and net price\n (price_net) is shown for VAT-registered business buyers.\n - product_url is a direct link to the product page — pass this to\n the user for viewing or adding to cart.\n - Use `get_product_details(id)` for full description and stock check.",
"inputSchema": {
"properties": {
"category_id": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Category ID (see https://rakentajaoutlet.fi/api/categories for the list)"
},
"in_stock_only": {
"default": true,
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Max products to return (1-50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number (>= 1)",
"minimum": 1,
"type": "integer"
},
"query": {
"default": "",
"description": "Free-text search term",
"type": "string"
},
"sort": {
"default": "name",
"enum": [
"name",
"price_asc",
"price_desc",
"newest"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_shop_catalog",
"outputSchema": {
"$defs": {
"ProductSummary": {
"description": "search_catalog-tulosten yksi tuote (lyhyt description).",
"properties": {
"availability_status": {
"description": "Detailed status: in_stock = own warehouse, supplier_stock = from supplier",
"enum": [
"in_stock",
"supplier_stock",
"out_of_stock"
],
"title": "Availability Status",
"type": "string"
},
"available_for_order": {
"description": "Whether customer can order this — TRUE if in own stock OR supplier stock available",
"title": "Available For Order",
"type": "boolean"
},
"brand": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Brand"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category"
},
"currency": {
"const": "EUR",
"default": "EUR",
"title": "Currency",
"type": "string"
},
"description": {
"description": "Product description (max 200 chars — check description_truncated for full text availability)",
"title": "Description",
"type": "string"
},
"description_truncated": {
"default": false,
"description": "If TRUE, full description is longer — use get_product_details to fetch it",
"title": "Description Truncated",
"type": "boolean"
},
"ean": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ean"
},
"estimated_delivery_max_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Hitain toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Max Days"
},
"estimated_delivery_min_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Nopein toimitusarvio arkipäivinä (null = ei saatavilla)",
"title": "Estimated Delivery Min Days"
},
"id": {
"description": "Product ID (use with get_product_details for full info)",
"title": "Id",
"type": "integer"
},
"image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Url"
},
"in_stock": {
"title": "In Stock",
"type": "boolean"
},
"name": {
"title": "Name",
"type": "string"
},
"price_gross": {
"description": "Gross price incl. 25.5% Finnish VAT",
"title": "Price Gross",
"type": "number"
},
"price_net": {
"description": "Net price for VAT-registered business buyers",
"title": "Price Net",
"type": "number"
},
"product_url": {
"description": "Direct link to product page — pass this to the user",
"title": "Product Url",
"type": "string"
},
"sku": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sku"
},
"stock_quantity": {
"title": "Stock Quantity",
"type": "integer"
},
"supplier_in_stock": {
"title": "Supplier In Stock",
"type": "boolean"
},
"supplier_stock_quantity": {
"title": "Supplier Stock Quantity",
"type": "integer"
},
"unit": {
"default": "kpl",
"title": "Unit",
"type": "string"
},
"vat_percent": {
"default": 25.5,
"title": "Vat Percent",
"type": "number"
},
"weight_kg": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Weight Kg"
}
},
"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"
],
"title": "ProductSummary",
"type": "object"
}
},
"description": "Return type for search_catalog.",
"properties": {
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"page": {
"title": "Page",
"type": "integer"
},
"per_page": {
"title": "Per Page",
"type": "integer"
},
"products": {
"items": {
"$ref": "#/$defs/ProductSummary"
},
"title": "Products",
"type": "array"
},
"suggested_queries": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Alternative queries that would return results — populated when total=0",
"title": "Suggested Queries"
},
"total": {
"description": "Total matching products across all pages",
"title": "Total",
"type": "integer"
},
"total_pages": {
"title": "Total Pages",
"type": "integer"
}
},
"required": [
"products",
"total",
"page",
"per_page",
"total_pages",
"disclaimer"
],
"title": "SearchCatalogResult",
"type": "object"
}
},
{
"description": "Search Rakentaja Outlet shop policies, FAQ, and store info.\n\nSearches across 8 pages: About Us (tietoa-meista), FAQ\n(usein-kysyttya), Delivery terms (toimitusehdot), Privacy Policy\n(tietosuoja), Terms of Use (kayttoehdot), Return Form (peruutuslomake),\nPayment Methods (maksutavat), AI Agent Guide (ai).\n\nUse this tool when the user asks about:\n - Delivery times and costs (\"toimitusaika\", \"toimituskulu\")\n - Returns and refunds (\"palautus\", \"peruutus\", \"hyvitys\")\n - Payment methods (\"maksutavat\", \"lasku\")\n - Privacy or GDPR (\"tietosuoja\", \"GDPR\")\n - Terms of use (\"käyttöehdot\")\n - Company information (\"Sanere Oy\", \"yhteystiedot\", \"Y-tunnus\")\n - Any general question about buying from the store\n\nArgs:\n query: Free-text search term (Finnish). Case-insensitive.\n Leave empty to get an overview of all policy pages.\n limit: Maximum sections to return (1-10, default 5). Each section\n is a paragraph or Q&A pair; longer content is truncated.\n\nReturns:\n JSON with:\n - sections: list of matching sections, each with:\n - page_slug: e.g. \"usein-kysyttya\"\n - page_title: e.g. \"Usein kysyttyä\"\n - page_url: full URL to the page\n - heading: section heading if any\n - text: matching text content (may be truncated)\n - is_faq: True if this is a Q&A from the FAQ page\n - total_matches: total sections matched\n - query: echoed query\n - available_pages: list of all policy page slugs\n - disclaimer: legal reminder to check the full page\n\nNotes:\n - Policies are the authoritative source; if unclear, direct the\n user to the page_url for the full text.\n - Some FAQ entries are marked with FAQPage schema.org markup —\n these show up as Google rich results.",
"inputSchema": {
"properties": {
"limit": {
"default": 5,
"description": "Max sections to return (1-10)",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"query": {
"default": "",
"description": "Free-text search term (Finnish)",
"type": "string"
}
},
"type": "object"
},
"name": "search_shop_policies_and_faqs",
"outputSchema": {
"$defs": {
"PolicySection": {
"description": "Yksi kauppaehto/FAQ-sektio.",
"properties": {
"heading": {
"description": "Section heading or FAQ question",
"title": "Heading",
"type": "string"
},
"is_faq": {
"description": "TRUE if this is a Q&A pair from the FAQ page",
"title": "Is Faq",
"type": "boolean"
},
"page_slug": {
"description": "Page identifier (e.g. \"usein-kysyttya\")",
"title": "Page Slug",
"type": "string"
},
"page_title": {
"title": "Page Title",
"type": "string"
},
"page_url": {
"title": "Page Url",
"type": "string"
},
"text": {
"description": "Section text or FAQ answer (may be truncated to 500 chars)",
"title": "Text",
"type": "string"
}
},
"required": [
"page_slug",
"page_title",
"page_url",
"heading",
"text",
"is_faq"
],
"title": "PolicySection",
"type": "object"
}
},
"description": "Return type for search_shop_policies_and_faqs.",
"properties": {
"available_pages": {
"description": "All 8 policy page slugs",
"items": {
"type": "string"
},
"title": "Available Pages",
"type": "array"
},
"disclaimer": {
"title": "Disclaimer",
"type": "string"
},
"query": {
"description": "Echoed query",
"title": "Query",
"type": "string"
},
"sections": {
"description": "Matching sections (limited by `limit`)",
"items": {
"$ref": "#/$defs/PolicySection"
},
"title": "Sections",
"type": "array"
},
"total_matches": {
"description": "Total sections matched (may be > len(sections) if limited)",
"title": "Total Matches",
"type": "integer"
}
},
"required": [
"sections",
"total_matches",
"query",
"available_pages",
"disclaimer"
],
"title": "PolicySearchResult",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:3d60cf486c604b4ffc51874e3027c4574c715196c192397556dbef5f5f0621f9 | sha256sum