# kronan-mcp

Connects your coding assistant to the Icelandic Krónan grocery API. It lets the model search store items, build carts, and track deliveries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: sandsower
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sandsower/kronan-mcp
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/kronan-mcp

## What it does

This server exposes 25 tools through the Model Context Protocol to interface with Krónan Snjallverslun. The assistant can look up catalog items, modify checkout lines, inspect purchase history, and organize shopping notes. All product prices use whole integer numbers in ISK without decimals.

Setup needs an API token starting with `act_`. You generate this credential inside the Krónan account settings page, which requires an Icelandic electronic ID (Audkenni) to log in. Without that electronic identity, you cannot use this integration. Outgoing error messages automatically scrub the token so keys do not leak into model context.

The backend enforces a rate quota of 200 requests within 200 seconds. When hitting status 429, the client tells the assistant to pause. Methods like `set_order_substitution` and `set_line_completion` toggle values rather than setting them idempotently. Never retry timed-out toggle actions without querying current status first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `KRONAN_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add kronan-mcp -e KRONAN_ACCESS_TOKEN=<KRONAN_ACCESS_TOKEN> -- npx -y kronan-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add kronan-mcp --env KRONAN_ACCESS_TOKEN=<KRONAN_ACCESS_TOKEN> -- npx -y kronan-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kronan-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kronan-mcp"
            ],
            "env": {
                "KRONAN_ACCESS_TOKEN": "<KRONAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kronan-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kronan-mcp"
            ],
            "env": {
                "KRONAN_ACCESS_TOKEN": "<KRONAN_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e KRONAN_ACCESS_TOKEN=<KRONAN_ACCESS_TOKEN> kronan-mcp npx -y kronan-mcp
```
Replace <…> with your own values

## When to use it
- look up groceries and categories in the Krónan inventory
- place specific SKU quantities into the online checkout
- organize and update private grocery lists
- monitor placed orders and tweak replacement settings

## Example prompts
- Check Krónan for whole milk and list the prices
- Put 2 units of SKU 02500188 into my shopping checkout
- List my latest grocery purchases and order details

## Similar
- [texas-grocery](https://affpapa.org/en/nevibecode/mcp/texas-grocery.md) — MCP server · ★ 68
- [firecrawl-shop](https://affpapa.org/en/nevibecode/skills/firecrawl-shop.md) — skill · 31400 installs
- [Continente MCP](https://affpapa.org/en/nevibecode/mcp/continente-mcp.md) — MCP server · ★ 24
- [StackTheDeal Deals](https://affpapa.org/en/nevibecode/mcp/stackthedeal-deals.md) — MCP server
- [getcheapgames](https://affpapa.org/en/nevibecode/mcp/getcheapgames.md) — MCP server
- [vedurstofa-mcp](https://affpapa.org/en/nevibecode/mcp/vedurstofa-mcp.md) — MCP server · ★ 5

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md