Yandex Lavka MCP server
Unofficial MCP server for ordering Yandex Lavka groceries: search, cart, checkout.
20 stars31 downloads/wk
Reviews
Write oneNobody has reviewed Yandex Lavka yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yandex Lavka tools (17, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
active_ordersCurrently tracked orders with status and ETA. Read-only.
add_to_cartAdd a product to the cart (increments if already present). No charge.
cancel_orderwrite actionCancel an order by id (e.g. one returned by confirm_order/active_orders).
checkout_previewPreview the order: items, delivery fee, ETA, address, payment, TOTAL.
clear_cartwrite actionRemove everything from the cart. No charge.
confirm_orderwrite actionPlace the order and CHARGE the card. Irreversible — real money.
get_productGet details for one product: price, size, stock, description. Read-only.
lavka_statusShow whether the Lavka session and delivery location are configured.
list_addressesList your saved Lavka delivery addresses (by name). Read-only.
list_payment_methodsList the user's saved cards and which is the default. Read-only.
search_productsSearch the Lavka catalog at the current delivery location. Read-only.
set_delivery_addressSet delivery to ANY address by free text — works for a new city.
set_locationSet the delivery location (required before catalog/cart calls).
set_payment_methodChoose which saved card orders will charge (persists). Pass an `id` from list_payment_methods. Pass an empty string to revert to the account default.
update_cart_itemwrite actionSet the exact quantity of a cart item. quantity=0 removes it. No charge.
use_addressSwitch delivery to one of your saved addresses, matched by name.
view_cartShow the current cart contents and running total. Read-only.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan11 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 15 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
What the publisher says
From the Yandex Lavka repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.Dudude-bit/yandex-lavka-mcp -->
yandex-lavka-mcp
An MCP server that lets an AI assistant order groceries from Yandex Lavka — search products, build a cart, and place a real order — with an explicit human confirmation before any money is charged.
[!WARNING]
Unofficial. Yandex Lavka has no public API. This project talks to the same
private web API that lavka.yandex.ru uses, authenticated with your own
Yandex session cookies. It automates your own account, for your own shopping.
- Not affiliated with or endorsed by Yandex. Using it may violate Yandex's
Terms of Service, and the private API can change or be blocked at any time.
- confirmorder spends real money** on your card. Use at your own risk.
- Provided as is, without warranty (see LICENSE).
What it does
Money safety. Placing an order is a deliberate two-step flow: checkoutpreview returns the full summary and charges nothing; confirmorder(confirmed_total) refuses unless a preview was just run and you pass back the exact total it showed. Change the cart and the preview is invalidated — you must preview again.
3-D Secure. confirmorder submits the order and charges the on-file card, then polls payment status. If your bank requires 3-D Secure, paymentstatus comes back waituseraction and a redirecturl is returned — open it to finish paying (a headless charge cannot complete 3DS). cancelorder(order_id) cancels.
Multiple locations / cities. Catalog, prices and cart are location-scoped. useaddress("Дача") switches to a saved address; setdelivery_address("Казань, улица Баумана, 1", flat="12") works for any address in any city (it geocodes via Lavka's own address search).
How it's built
- Python 3.12+ · FastMCP · httpx.
- client.py — the async API client (session auth, CSRF, request building, trims huge payloads).
- endpoints.py — every API path in one place (overridable from config, no code change).
- server.py — the MCP tools the assistant sees.
The API sits under https://lavka.yandex.ru/api/v1/providers/ (plus /api/v1/orders/submit for placing orders). Requests need the CSRF token from the homepage HTML plus X-Lavka-Web- headers — the client handles this.
Setup
1. Install
uv venv && uv pip install -e .2. Provide your Yandex session (one time)
Log into Lavka in your browser first, then get the session cookies into ~/.config/yandex-lavka-mcp/config.json.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add yandex-lavka-mcp -- uvx yandex-lavka-mcp
Yandex Lavka: common questions
- Is Yandex Lavka MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Yandex Lavka safety report
- How do I install Yandex Lavka?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Yandex Lavka need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Yandex Lavka maintained?
- The last commit was 16 days ago (2026-09-10). The latest release is v0.1.1.
- What can I use instead of Yandex Lavka?
- Servers from other publishers that do the same job: Leclerc Drive MCP server, A1 Yandex KIT MCP server and Packrift MCP server. Compare all Yandex Lavka alternatives.
Alternatives to Yandex Lavka
Same job from other publishers: the closest match first, then the best rated.
- Leclerc DriveMCP server for E.Leclerc Drive — search products, manage cart, and order groceries from Claudenot reviewedGrowingB
- A1 Yandex KIT MCPA1 Yandex KIT MCP server for the Yandex KIT e-commerce API: products, orders, discounts, webhooks.not reviewedGrowingB
Packrift MCPHosted no-auth MCP for exact-spec packaging search, live price, stock, cart handoff, and no-match.not reviewedGrowingB