Kronan Mcp

io.github.sandsowerPublished by GitHub account sandsowerv1.0.1Updated Oct 24, 2026

MCP server for the Krónan grocery store API (Iceland)

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Icelandic Krónan grocery API, letting an assistant search products, manage shopping notes and lists, and handle checkout and orders.

What you can do
Search and read products, product details and categories in the Krónan smart store catalog, with prices in ISK integers. Manage shopping notes: add, change, reorder, delete and complete lines, clear the note, and check store order eligibility. Manage product lists: create, read, update, delete, clear, sort and edit list items. Handle checkout and orders: view checkout, add checkout lines, list and read orders, delete order lines, set substitutions and lower quantities. Review purchase statistics and account details.
When to use it
Useful for someone with a Krónan Snjallverslun account in Iceland who wants an assistant to help plan grocery shopping, build or edit shopping notes and product lists, and review or adjust orders through conversation.
Requirements
Runs locally over stdio via npm (kronan-mcp) or npx, so Node.js is needed. Requires a Krónan Snjallverslun account with Audkenni electronic ID login and an access token (act_ prefix) created in the user or customer group settings, supplied through the KRONAN_ACCESS_TOKEN environment variable. Network access to the Krónan API is required.
Before you install
The KRONAN_ACCESS_TOKEN is a secret tied to a real grocery account; keep it out of shared config files. Many tools write or delete data, including checkout lines, order lines, shopping notes and product lists, and some changes may affect real orders. set_order_substitution and set_line_completion are not idempotent, so avoid retrying on timeout without checking current state. Requests are rate limited to 200 per 200 seconds.

Installation

In SourceWeft

  1. Open Kronan Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

CategoryTools
Productssearch_products, get_product, get_category_products, list_categories
Checkoutget_checkout, add_checkout_lines
Orderslist_orders, get_order, delete_order_lines, set_order_substitution, lower_order_quantity
Shopping notesget_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 listslist_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 statslist_purchase_stats, set_purchase_stat_ignored
Accountget_me

Install

bash
npm install -g kronan-mcp

Or run directly with npx (no install needed):

bash
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:

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

bash
npm install && npm run build   # Build from sourcenpm run dev                    # Watch mode (recompiles on change)npm test                       # Run testsnpm 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.

bash
npm test

Source: README.md at commit ba8ec21

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts