kronan-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kronan-mcp Search for gluten-free bread in Reykjavik"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
Checkout |
|
Orders |
|
Shopping notes |
|
Product lists |
|
Purchase stats |
|
Account |
|
Related MCP server: Willys MCP Server
Install
npm install -g kronan-mcpOr run directly with npx (no install needed):
npx kronan-mcpGetting 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 schemaAuth 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 testsTests
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 testAvailable Tools
33 toolsadd_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
Scored across 33 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for SkuVault — products, inventory, sales, purchase orders and stock adjustments.
MCP server for Product Management
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceAn 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-
- AlicenseNot gradedqualityDmaintenanceAn MCP server for Sweden's largest grocery chain Willys. Enables controlling your shopping cart, browsing orders, searching products, and getting AI-powered recommendations from any MCP client.5MIT
- AlicenseAqualityBmaintenanceA 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.141MIT
- AlicenseNot gradedqualityCmaintenanceMCP 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.5Apache 2.0