Skip to main content
Glama
kronan-mcp

kronan-mcp

by sandsower

kronan-mcp

MCP server for the Krónan grocery store API. Claude can browse products, manage shopping notes, handle checkout, and track orders from Krónan's Snjallverslun (smart store) in Iceland.

Tools

25 tools over the Model Context Protocol:

Category

Tools

Products

search_products, get_product, get_category_products, list_categories

Checkout

get_checkout, add_checkout_lines

Orders

list_orders, get_order, delete_order_lines, set_order_substitution, lower_order_quantity

Shopping notes

get_shopping_note, add_shopping_note_line, change_shopping_note_line, reorder_shopping_note_lines, delete_shopping_note_line, set_line_completion, clear_shopping_note, check_store_order_eligibility, apply_store_product_order, list_archived_lines, delete_archived_line

Product lists

list_product_lists, create_product_list, get_product_list, update_product_list, delete_product_list, clear_product_list, sort_product_list, update_product_list_item

Purchase stats

list_purchase_stats, set_purchase_stat_ignored

Account

get_me

Related MCP server: Willys MCP Server

Install

npm install -g kronan-mcp

Or run directly with npx (no install needed):

npx kronan-mcp

Getting a token

Tokens are created in the Krónan Snjallverslun user settings. You need an account with Audkenni (Iceland's electronic ID) login. Go to your user or customer group settings page and create an access token. Tokens are prefixed with act_.

Usage with Claude Code

Add to your project's .claude/settings.local.json or global ~/.claude/settings.json:

{
  "mcpServers": {
    "kronan": {
      "command": "npx",
      "args": ["kronan-mcp"],
      "env": {
        "KRONAN_ACCESS_TOKEN": "act_your_token_here"
      }
    }
  }
}

Then ask Claude things like:

  • "Search for milk on Krónan"

  • "What's in my shopping note?"

  • "Add 2x of SKU 02500188 to my checkout"

  • "Show my recent orders"

Architecture

src/
├── client.ts   HTTP client wrapping all Krónan API endpoints
├── index.ts    MCP server registering tools via @modelcontextprotocol/sdk
└── types.ts    TypeScript interfaces matching the OpenAPI schema

Auth is Authorization: AccessToken <token> on every request. Rate limit is 200 requests per 200 seconds per user. The client detects 429 responses and tells the caller to wait.

All prices are integers in ISK (no decimals). 230 means 230 kr.

Errors go through a typed KronanApiError with status codes. The token is scrubbed from error messages so it doesn't leak to the LLM. Auth failures and rate limits get their own user-facing messages.

set_order_substitution and set_line_completion use read-then-toggle patterns. They're not idempotent. Don't retry on timeout without checking current state first.

API reference

Full OpenAPI schema at openapi-schema.yaml.

Development

npm install && npm run build   # Build from source
npm run dev                    # Watch mode (recompiles on change)
npm test                       # Run tests
npm run test:watch             # Watch mode tests

Tests

31 tests on the HTTP client: constructor validation, error paths (429, timeouts, JSON parse failures), token scrubbing, toggle method validation, eligibility endpoint edge cases.

npm test

Available Tools

33 tools
add_checkout_linesA

Add product lines to the active checkout. Set replace=true to replace all existing lines.

Inputs: lines (required), replace.

add_shopping_note_lineA

Add a line to the shopping note. Provide exactly one of text (freeform) or sku (linked product), not both.

Inputs: sku, text, quantity.

apply_store_product_orderB

Reorder shopping note lines to match the store's aisle layout for efficient in-store shopping

Inputs: no named parameters.

change_shopping_note_lineB

Update the text or quantity of an existing shopping note line

Inputs: token (required), text, quantity.

check_store_order_eligibilityB

Check if the shopping note contains products that can be ordered from a store

Inputs: no named parameters.

clear_product_listA

Remove all items from a product list without deleting the list itself

Inputs: token (required).

clear_shopping_noteA

Delete all lines from the shopping note (the note itself is preserved)

Inputs: no named parameters.

create_product_listC

Create a new product list

Inputs: name (required), description.

delete_archived_lineB

Remove a specific archived shopping note line

Inputs: token (required).

delete_order_linesA

Remove specific lines from an order by their IDs. Service lines and the last remaining line cannot be deleted.

Inputs: token (required), lineIds (required).

delete_product_listB

Permanently delete a product list and all its items

Inputs: token (required).

delete_shopping_note_lineC

Remove a line from the shopping note

Inputs: token (required).

get_category_productsA

Get paginated product listing for a category (48 per page)

Inputs: slug (required), page.

get_checkoutA

Get the active smart checkout (auto-creates if none exists)

Inputs: no named parameters.

get_meA

Get the current authenticated identity (user or customer group)

Inputs: no named parameters.

get_orderB

Get full order details including lines with product thumbnails

Inputs: token (required).

get_productA

Get full product details including price, discounts, tags, availability

Inputs: sku (required).

get_product_listB

Get a product list with all items including product details and pricing

Inputs: token (required).

get_shopping_noteA

Get the shopping note (auto-creates if none exists)

Inputs: no named parameters.

list_archived_linesB

List previously completed and archived shopping note lines

Inputs: no named parameters.

list_categoriesA

Get the full 3-level category tree

Inputs: no named parameters.

list_ordersB

List orders, most recent first

Inputs: type, limit, offset.

list_product_listsC

List saved product lists

Inputs: limit, offset.

list_purchase_statsB

List previously purchased products with frequency data, ordered by most recent purchase

Inputs: limit, offset, includeIgnored.

lower_order_quantityA

Reduce the quantity of specific order lines. Quantity can only be lowered. Set to 0 to remove.

Inputs: token (required), lineIds (required), quantity (required).

reorder_shopping_note_linesB

Reorder shopping note lines by passing their tokens in desired order

Inputs: linesTokens (required).

search_productsA

Search for products in the smart store selection. Returns products available for home delivery.

Inputs: query (required), page, sortBy, pageSize, +1 more.

set_line_completionA

Mark a shopping note line as completed or uncompleted. Uses a toggle endpoint: fetches current state and only toggles if needed. WARNING: Not idempotent due to toggle semantics. Do NOT retry on timeout — check current state first.

Inputs: token (required), completed (required).

set_order_substitutionA

Set whether substitution is allowed for specific order lines. Uses a toggle endpoint: fetches current state and only toggles lines that differ. WARNING: Not idempotent due to toggle semantics. Do NOT retry on timeout — check current state first.

Inputs: token (required), lineIds (required), substitution (required).

set_purchase_stat_ignoredB

Hide or unhide a product from purchase history

Inputs: id (required), isIgnored (required).

sort_product_listB

Sort items in the product list by store departments

Inputs: token (required).

update_product_listB

Update the name or description of a product list

Inputs: token (required), name, description.

update_product_list_itemA

Add a product by SKU or update its quantity in a product list. Set quantity to 0 to remove.

Inputs: sku (required), token (required), quantity (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 33 tools

    Disambiguation5/5

    Each tool targets a specific resource and action (e.g., product lists vs. shopping notes vs. orders vs. checkout), with clear boundaries. Even though there are many tools, their purposes do not overlap.

    Naming Consistency5/5

    All tools follow a consistent `verb_noun` pattern in snake_case (e.g., `create_product_list`, `add_checkout_lines`), making it easy to predict tool behavior from its name.

    Tool Count2/5

    With 33 tools, the server is over-scoped. While each tool serves a distinct purpose, the count exceeds the recommended 3–15 range and makes the surface cumbersome for an agent to navigate.

    Completeness5/5

    The tool set covers the full lifecycle of a grocery shopping workflow: browsing products, managing lists and notes, placing orders, handling checkout, and tracking purchase stats. No obvious gaps for the intended domain.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for programmatically interacting with the Oda grocery shopping platform. It enables users to search for products, browse results, and manage their shopping cart contents through natural language.
      22
      -
    • A
      license
      A
      quality
      B
      maintenance
      A local MCP server for grocery shopping, enabling product search, specials, and browsing across NZ supermarkets, with cart and order history for Countdown/Woolworths via browser-assisted login.
      14
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server that manages a K-Ruoka (Finnish grocery) shopping cart: read cart, add/update/remove items, clear cart, search products and stores. It uses a real Chrome browser to authenticate via cookies, enabling cart management through natural language.
      5
      Apache 2.0