pyaterochka-mcp

Local MCP server for product search, cart and delivery with Pyaterochka

  • 4 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • MCP can trigger real orders and charges after confirmation.
  • Works with private APIs and payment methods.
  • Handles personal data and user session tokens.
All reasons and checks
Russian stack

shi-kirill/pyaterochka-mcp

Install

Services

Manual install

cd pyaterochka-mcp
python3 -m venv .venv
.venv/bin/pip install -e '.[dev,capture]'

Install dependencies in a Python 3.12+ virtual environment.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • MCP can trigger real orders and charges after confirmation.
  • Works with private APIs and payment methods.
  • Handles personal data and user session tokens.

This is third-party code. Review the repository files before installing.

What it does

pyaterochka-mcp is a local MCP server for automating shopping, product search, cart management and delivery checkout with Pyaterochka. The server runs only on your machine, does not send telemetry and stores no centralized data. It uses private APIs and can interact with an authorized Chrome tab or directly via HTTP. Real orders are submitted only after explicit user confirmation.

Who it is for. For developers and researchers automating shopping and delivery with Pyaterochka via MCP clients.

Good fit when

  • You need to automate product search, cart assembly and delivery checkout with Pyaterochka via MCP.
  • You require a local server with no data sent to third parties.
  • You want to integrate with Codex or another MCP client for shopping automation.

Not a fit when

  • Do not use if the service terms prohibit automation or private API access.
  • Not suitable for users without a Pyaterochka or X5ID account.
  • Do not use if you require official support or a stable public API.

Example request

In Codex, add the server with:
codex mcp add pyaterochka -- /absolute/path/to/pyaterochka-mcp/.venv/bin/pyaterochka-mcp
Then call the pyaterochka_status tool to check connectivity.

MCP

Transport
stdio
Authentication
not required

Limitations

The project uses private APIs, which may violate service terms and lead to blocking. MCP runs locally only, is not affiliated with X5 Group and does not guarantee interface stability. Order placement requires Pyaterochka and X5ID authorization. Real order submission is disabled by default. Authorization and payment method handling require caution — MCP can trigger real charges after explicit confirmation.

How to disable. Stop the MCP server process and remove local configuration files. To fully clean up, delete the virtual environment and project folder.

FAQ

Is it safe to use pyaterochka-mcp for order placement?

MCP uses two-step order confirmation and keeps all data local. Handling private APIs and payment methods requires caution. Real order submission is disabled by default.

Can I use MCP without a Pyaterochka account?

No, you need to be authorized with Pyaterochka and X5ID to use it.

Discussion

No questions or reviews yet.

Russian stack

Three MCP servers that search products on Wildberries, Ozon and Yandex Market through Apify actors, with caching and compact output for agent context

MCP serverExtended access5Repository stars
Russian stack

An MCP server with typed read access to Wildberries, Ozon and Yandex Market accounts: one schema for three platforms, multi-account support

MCP serverExtended access
Russian stack

A single-marketplace distribution of the marketplaces-mcp-ru core just for Avito: 64 API methods via a method catalog instead of a hundred separate tools

MCP serverBroad access2Repository stars
Russian stack

An MCP server for the Lamoda Seller Partner API with a 155-method catalog and a safety gate before writes, an alpha never verified against a live account

MCP serverBroad access

README in short

pyaterochka-mcp is a local MCP server for automating shopping, product search, cart management and delivery checkout with Pyaterochka. The project is not affiliated with X5 Group, uses private APIs and runs only on your machine. All cart and order operations require explicit user confirmation, and real order submission is disabled by default. MCP sends no telemetry, stores no centralized data and supports integration with Codex and other MCP clients. It works via an authorized Chrome tab or direct HTTP client with imported cookies.

README badge

Report a problem

Foxx AIpyaterochka-mcp
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.