Kiuki Agentic Commerce — MCP Server

Shop Kiuki — the UK grocery marketplace with AI shopping built in — from any MCP-compatible agent. Search thousands of grocery products across multiple independent vendors, build a multi-vendor cart, and complete checkout, all via natural-language tool calls.

Why Kiuki through MCP?

• Multi-vendor, single cart. Comparison-shop across independent UK food producers and check out in one session.
• Payment delegation is first-class. Agents holding a tokenised payment method (Stripe SPT, payment_method_id) can complete the order without a human-in-the-loop magic-link step.
• Semantic search. Queries are routed through Google Cloud Retail AI, so natural-language intent ("low-sugar organic granola, gluten-free") returns relevance-ranked hits, not keyword matches.

Tools (12)

| Tool | Description | |------|-------------| | search_products | Semantic product search via Google Retail AI | | browse_category | List products in a category | | get_product | Product detail (price, stock, gtin, seller) | | create_checkout | Start a checkout session with one or more items | | get_checkout | Retrieve session state | | update_checkout | Modify items / fulfillment address / selected shipping option | | complete_checkout | Finalise with a Stripe Shared Payment Token or payment_method_id | | cancel_checkout | Cancel a pending session | | place_order | Shortcut: create → complete in one call | | get_order | Order status and tracking | | subscribe_webhook | Subscribe to order.completed / order.failed / checkout.abandoned / inventory.updated / delivery.status | | unsubscribe_webhook | Remove a webhook |

Install

Option 1 — Smithery (recommended)

Smithery handles install, config, and keeps the server up to date.

npx @smithery/cli install @kiuki/kiuki-agentic-mcp --client claude

The CLI will prompt for your KIUKI_API_KEY. Request one from [email protected].

Supported clients: claude (Claude Desktop), cursor, windsurf, vscode.

Option 2 — Claude Code plugin

For Claude Code users. Ships the MCP + a few friendly slash commands (/kiuki:search, /kiuki:checkout, /kiuki:order).

/plugin marketplace add kiukicom/kiuki-agentic-mcp
/plugin install kiuki@kiukicom

You'll be prompted for your KIUKI_API_KEY once at install; it's stored in your system keychain.

Option 3 — npx (no install)

npx @kiuki/kiuki-agentic-mcp

Option 4 — Manual (Claude Desktop)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kiuki": {
      "command": "npx",
      "args": ["-y", "@kiuki/kiuki-agentic-mcp"],
      "env": {
        "KIUKI_API_URL": "https://api.kiuki.com",
        "KIUKI_API_KEY": "your-api-secret"
      }
    }
  }
}

Restart Claude Desktop. Ask it: "what organic granolas do you have under £5?"

Configuration

| Env var | Required | Default | Description | |---------|----------|---------|-------------| | KIUKI_API_KEY | yes | — | Sent as X-Api-Secret header. | | KIUKI_API_URL | no | https://api.kiuki.com | Override for staging or self-hosted. |

Powered by

• Kiuki backend — Go microservices + GCP
• Search — Google Cloud Retail AI
• Payments — Stripe (supports Shared Payment Tokens)
• Fulfilment — DespatchCloud

Resources

• Kiuki API docs
• OpenAPI 3.1 spec
• llms.txt
• Smithery listing

License

MIT © Kiuki