About K Ruoka MCP
K Ruoka MCP is an MCP server in the Search category: mCP server for managing K-Plussa account's K-Ruoka (Finnish grocery) shopping cart from an AI assistant: search products and stores, read the cart, add items, change quantities, remove, clear.
Install
git clone https://github.com/nikosavola/k-ruoka-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (13)
add_to_cart(store_id?, ean, quantity?, unit?, local_store_id?, allow_substitutes?)By EAN. `quantity` is the resulting amount, not an increment. Defaults to 1, `unit` to `kpl`.
Parameters not published.
auth_status(store_id?)Whether the stored session is still signed in.
Parameters not published.
cancel_login()Gives up on a login in progress and closes its browser.
Parameters not published.
clear_cart(store_id?)Empties the cart. Not undoable.
Parameters not published.
get_cart(store_id?)Read-only. The only source of `itemId` values.
Parameters not published.
get_personal_offers(store_id?)Read-only. The account's personal OmaPlussa-edut offers. Every offer seen so far was already on the Plussa card -- pass an available listed EAN to `add_to_cart` to redeem it.
Parameters not published.
login_status()`waiting`, `signedIn`, `failed` or `notStarted`.
Parameters not published.
remove_from_cart(store_id?, item_id)No description in manifest
Parameters not published.
search_products(store_id?, query, limit?)Read-only. Finds EANs by name, which is what `add_to_cart` needs. Search in Finnish.
Parameters not published.
search_stores(query, limit?)Read-only. Finds the `store_id` every other tool needs.
Parameters not published.
Show all 13 tools
set_default_store(store_id)Sets the store used when later calls omit `store_id`. Scoped to this server process, not persisted across restarts.
Parameters not published.
start_login(port?)Opens a browser for the user to sign in, and returns the instructions to relay.
Parameters not published.
update_cart_item(store_id?, item_id, quantity, unit?)Sets an exact quantity. 0 removes. `unit` defaults to the item's existing one.
Parameters not published.
Ask AI
Ask AI about K Ruoka MCP
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.