rakentaja-outlet

Finnish e-commerce for electrical & construction supplies.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

    What data it sees

    Do you need an account

    No: the server works without sign-in

    Finnish e-commerce for electrical & construction supplies. Read-only MCP with 4 tools.

    How to connect

    How to connect rakentaja-outlet to Claude

    The server address to paste into Claude settings:

    https://rakentajaoutlet.fi/mcp

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect rakentaja-outlet to ChatGPT

    The server address to paste into ChatGPT settings:

    https://rakentajaoutlet.fi/mcp

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect rakentaja-outlet to Cursor

    The server address to paste into Cursor settings:

    https://rakentajaoutlet.fi/mcp

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (5)

    Raw names from tools/list. Only developers need these.

    search_catalogSearch 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_
    search_shop_catalogSearch 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_
    get_product_detailsGet 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).
    create_cart_linkCreate 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":
    search_shop_policies_and_faqsSearch 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.