# fi.rakentajaoutlet/rakentaja-outlet (remote · rakentajaoutlet.fi)

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

- Trust score: 73/100 (medium)
- Change this week: +8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `rakentajaoutlet.fi`: 73/100 (this document), [markdown](https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet.md), [page](https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet)

## Channel facts

- Endpoint: `https://rakentajaoutlet.fi/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 58/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2180 tokens (~545/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 95/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 82% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http fi-rakentajaoutlet-rakentaja-outlet https://rakentajaoutlet.fi/mcp
```

### Codex

```toml
[mcp_servers.fi-rakentajaoutlet-rakentaja-outlet]
url = "https://rakentajaoutlet.fi/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fi-rakentajaoutlet-rakentaja-outlet": {
      "type": "remote",
      "url": "https://rakentajaoutlet.fi/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add fi-rakentajaoutlet-rakentaja-outlet --url https://rakentajaoutlet.fi/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  fi-rakentajaoutlet-rakentaja-outlet:
    url: "https://rakentajaoutlet.fi/mcp"
```

### Other

```json
{
  "mcpServers": {
    "fi-rakentajaoutlet-rakentaja-outlet": {
      "type": "http",
      "url": "https://rakentajaoutlet.fi/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 72, +5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 67, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 65, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 65)

First indexed and scored.

## MCP tools (4)

### `search_catalog` (~685 tokens)

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…

Input parameters:

- `category_id`: Category ID (see https://rakentajaoutlet.fi/api/categories for the list)
- `in_stock_only` (boolean)
- `limit` (integer): Max products to return (1-50)
- `page` (integer): Page number (>= 1)
- `query` (string): Free-text search term
- `sort` (string)

Output parameters:

- `disclaimer` (string)
- `page` (integer)
- `per_page` (integer)
- `products` (array)
- `suggested_queries`: Alternative queries that would return results — populated when total=0
- `total` (integer): Total matching products across all pages
- `total_pages` (integer)

### `get_product_details` (~432 tokens)

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).

Input parameters:

- `product_id` (integer, required): Product ID from search_catalog results

Output parameters:

- `availability`: Fresh availability check (may be more current than stock_quantity)
- `availability_status` (string): Detailed status: in_stock = own warehouse, supplier_stock = from supplier
- `available_for_order` (boolean): Whether customer can order this — TRUE if in own stock OR supplier stock available
- `brand`
- `category`
- `currency` (string)
- `description` (string): Full product description (may contain HTML)
- `description_short`
- `disclaimer` (string)
- `ean`
- `estimated_delivery_max_days`: Hitain toimitusarvio arkipäivinä (null = ei saatavilla)
- `estimated_delivery_min_days`: Nopein toimitusarvio arkipäivinä (null = ei saatavilla)
- `id` (integer): Product ID (use with get_product_details for full info)
- `image_url`
- `images` (array): All product image URLs
- `in_stock` (boolean)
- `name` (string)
- `price_gross` (number): Gross price incl. 25.5% Finnish VAT
- `price_net` (number): Net price for VAT-registered business buyers
- `product_url` (string): Direct link to product page — pass this to the user
- `sku`
- `stock_quantity` (integer)
- `supplier_in_stock` (boolean)
- `supplier_stock_quantity` (integer)
- `unit` (string)
- `vat_percent` (number)
- `weight_kg`

### `create_cart_link` (~558 tokens)

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":…

Input parameters:

- `checkout` (boolean): If True, link goes directly to checkout; otherwise to cart review page
- `items` (array, required): Cart items (1-20 lines)

Output parameters:

- `checkout` (boolean): If true, link takes user directly to checkout
- `disclaimer` (string)
- `items` (array): Deduplicated cart items
- `total_lines` (integer): Number of unique products in link
- `total_quantity` (integer): Sum of quantities across all products
- `url` (string): Browser URL to give the user — opening it populates their cart

### `search_shop_policies_and_faqs` (~505 tokens)

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.

Input parameters:

- `limit` (integer): Max sections to return (1-10)
- `query` (string): Free-text search term (Finnish)

Output parameters:

- `available_pages` (array): All 8 policy page slugs
- `disclaimer` (string)
- `query` (string): Echoed query
- `sections` (array): Matching sections (limited by `limit`)
- `total_matches` (integer): Total sections matched (may be > len(sections) if limited)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet#diagnostics

## Score history

- 2026-08-03: 73
- 2026-08-02: 73
- 2026-08-01: 72
- 2026-07-31: 72
- 2026-07-30: 67
- 2026-07-29: 67
- 2026-07-28: 66
- 2026-07-27: 65
- 2026-07-26: 65

## Links

- Remote endpoint: https://rakentajaoutlet.fi/mcp
- Website: https://rakentajaoutlet.fi/sivu/ai
- Changelog RSS feed: https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet/changelog.json
- HTML version of this page: https://verifymcp.io/servers/fi-rakentajaoutlet-rakentaja-outlet/rakentajaoutlet