mpmentor-ru-mcp-readonly: read-only Wildberries and Ozon

mpmentor-ru-mcp-readonly

A local MCP server connects Codex and Claude Code to Wildberries, Ozon Seller and Ozon Performance with no write or delete tools

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

Extended access

Why this level

  • Wildberries and Ozon keys open store sales, orders and finances, although the server only reads them
  • Write protection rests on this server: other servers with the same key could change data
All reasons and checks
Russian stack

rang0oo/mpmentor-ru-mcp-readonly

Install

Manual install

git clone https://github.com/rang0oo/mpmentor-ru-mcp-readonly.git && cd mpmentor-ru-mcp-readonly && bash install.sh

On Windows run `install.bat` from the unpacked archive.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Wildberries and Ozon keys open store sales, orders and finances, although the server only reads them
  • Write protection rests on this server: other servers with the same key could change data

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

What it does

The server answers questions about sales, orders, stock in WB and FBS warehouses, products, prices, finances and advertising. The public entry point `readonly_mcp.server` has a fixed list of read tools: there are no `write_method`, `delete_method`, price setting, stock updates or cabinet switching. The generic `call_method` checks the method class and lets only reads through, and catalog methods are searched with `*_search_methods`. The `install.sh` installer for macOS and Linux or `install.bat` for Windows copies the app to `~/.marketplace-mcp/readonly-app`, creates a separate Python environment, registers the `marketplaces-ru-readonly` server in Codex and Claude Code and asks for keys with hidden input. There is also a `marketplaces-readonly` skill that runs the installation on request. This is an independent adaptation of the marketplaces-mcp-ru project.

Who it is for. Wildberries and Ozon sellers who want to ask an agent questions about their cabinets without risking changes to prices, stock and advertising.

Good fit when

  • You need Wildberries sales for the last seven days in a dialog
  • Stock in WB warehouses must be compared with your own FBS warehouse stock, changing nothing
  • Ozon FBS shipments waiting to be sent are gathered into a list
  • Ozon ad campaigns with high ACOS are reviewed separately

Not a fit when

  • You need to change prices, stock, cards or advertising: this version has no write tools
  • You need a Yandex Market or Avito cabinet: the server knows only Wildberries and Ozon
  • The key was issued without category reading: part of the methods will be unavailable

Example request

Compare stock in WB warehouses and my FBS warehouse for the week, changing nothing

MCP

Transport
stdio
Authentication
key is optional

Environment variables

WB_API_TOKEN secret
Wildberries token with read rights
OZON_CLIENT_ID
Ozon Seller Client ID
OZON_API_KEY secret
Ozon Seller API key
OZON_PERF_CLIENT_ID
Ozon Performance Client ID
OZON_PERF_CLIENT_SECRET secret
Ozon Performance secret

Limitations

It needs Python 3.10 or newer and Codex or Claude Code. If a platform cannot issue a strictly read-only key, only this server enforces the limit, so other servers of the source project must not run with the same key. Not all methods are available to every cabinet: token rights and subscriptions to some functions are needed, and coverage is described in `API_STATUS.md`. Keys are stored locally in `cabinets.json` with permissions 600. MIT license, the last commit in October 2026, no stars.

How to disable. Remove the `marketplaces-ru-readonly` server from Codex and Claude Code, delete the `~/.marketplace-mcp` folder and revoke keys in the Wildberries and Ozon cabinets.

FAQ

Can the server change prices or stock?

No. The public entry point has a fixed list of read tools, and `call_method` checks the method class and blocks writes.

Which keys are needed?

A WB token with read rights, Ozon Seller keys and, if needed, Ozon Performance. They are set through the installer with hidden input or the `WB_API_TOKEN`, `OZON_CLIENT_ID`, `OZON_API_KEY`, `OZON_PERF_CLIENT_ID`, `OZON_PERF_CLIENT_SECRET` variables.

How do I install for one client only?

With `bash install.sh --client codex` or `bash install.sh --client claude-code`. On Windows the same parameters follow `install.bat`.

How do I install through the skill?

Give Codex the repository link and ask it to install the `marketplaces-readonly` skill. After that the skill runs the built-in installer when asked to connect cabinets.

Where can I see API coverage?

In the `API_STATUS.md` file: it lists coverage freshness and method limits.

Discussion

No questions or reviews yet.

Wildberries and Ozon remote MCP server

Marketplace Claude Remote MCP Server

Russian stack

A self-hosted remote MCP server: an admin configures Wildberries and Ozon accounts, users connect through OAuth without their own keys

MCP serverExtended access
Russian stack

An MCP server with 9 read-only tools over the Ozon Seller API v3: products, FBS and FBO orders, analytics, finance and returns

MCP serverExtended access
Russian stack

MCP servers for Wildberries, Ozon, Yandex Market and Avito seller accounts via official APIs with write confirmation

MCP serverBroad access62Repository stars
Russian stack

An MCP server for the Ozon Seller API with a catalog of 441 methods, read and write access classes, and keys stored outside the repository

MCP serverBroad access3Repository stars
Russian stack

A read-only Wildberries MCP server: products, ads, orders, stock, finance and reviews, with writes blocked in code, not just prompts

MCP serverExtended access

README in short

The README covers the purpose, installation through a skill and directly, key entry, example requests, method limits and the write-protection design.

README badge

Report a problem