SkillFoxx

Read-only Wildberries dashboard MCP

WB Readonly MCP

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

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

Extended access

Why this level

  • Runs a Node server that calls 181 Wildberries API operations with a seller token
  • Reads orders, financial reports and ad budgets, while writes are blocked by an allowlist in code
All reasons and checks
Russian stack

zimuspro156-lab/mcp-wb-readonlyAuthor:zimuspro156-lab

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/wb-readonly-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

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

  • Runs a Node server that calls 181 Wildberries API operations with a seller token
  • Reads orders, financial reports and ad budgets, while writes are blocked by an allowlist in code

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

What it does

The server gives an agent 12 tools and access to 181 allowed Wildberries API operations across 13 sections: product cards and prices, ad campaigns with bids and negative phrases, FBS, DBS, DBW and FBW orders and supplies, warehouse stock, financial reports and documents, buyer reviews and questions, tariffs and seller rating. Write operations are excluded at the code level: a call is only allowed for an exact operation, method, path and domain combination from a fixed catalog/allowlist.json, the agent cannot set an arbitrary URL or method, and creating or re-running WB's background reports is excluded too. Separate tools compute ad CTR, CPC and ROAS-style spend ratio, a stock replenishment scenario, and unit economics for one sold item from entered costs. It deploys on your own VPS with external access via Cloudflare and OAuth 2.0 with PKCE login for ChatGPT; Cursor can run it locally over stdio.

Who it is for. For Wildberries sellers and managers who want a full dashboard view with no risk of the agent accidentally changing anything.

Good fit when

  • You want a broad dashboard view: products, ads, orders, stock, finance, reviews
  • You need writes excluded in server code, not just in a prompt instruction
  • You want remote access from ChatGPT and local access from Cursor from one server

Not a fit when

  • You need write operations: this server does not change prices, bids, order status or review replies
  • You have no VPS to deploy on: the project does not offer managed cloud hosting

Example request

Break down product 123456789: its card, price, stock and latest ad stats

MCP

Transport
http, stdio
Authentication
OAuth

Environment variables

WB_READ_ONLY_TOKEN required, secret
A personal WB token with the needed API categories; either permission mode works

Limitations

The operation catalog is based on a Wildberries API snapshot from August 19, 2026 with added schemas; part of WB's documentation was unavailable during development, and the provenance is documented separately. One operation, FBS auto-return settings, is disabled due to an incomplete schema. Tests use stubbed WB responses, so verifying with a real dashboard token is still up to the user. A Docker setup is prepared but not verified by an actual build; the main install path is systemd services on a Linux VPS. Ready ZIP and PDF files come back as stored content with no automatic unpacking or OCR.

How to disable. Stop the server's systemd service on the VPS and disconnect the app from ChatGPT, or remove it from your Cursor configuration.

FAQ

Can the AI change a price or stock through this server?

No, write operations are excluded in code via a fixed allowlist, not just forbidden in a model prompt.

Do I need a write-capable token?

No, a read-only token works; the token's own permissions do not widen the MCP's method set, since the server only allows reads regardless.

Discussion

No questions or reviews yet.

All Wildberries tools

Wildberries MCP

wildberries-mcp

Russian stack

MCP server for the Wildberries seller API: products, prices, stock, orders, FBS supplies, analytics, reviews and ads

MCP serverBroad access16
Russian stack

Wildberries Seller API MCP server: cards, prices, promotions, ads, orders, supplies, reviews and finance across several stores

MCP serverBroad access8
Russian stack

A local Wildberries Seller API MCP server built from a 279-method OpenAPI catalog, with calls defaulting to dry-run

MCP serverBroad access
Russian stack

An MCP server covering all seventeen Wildberries Seller API hosts: sales, stock, product cards, prices, financial reports and reviews

MCP serverBroad access4

README in short

The README explains the Cloudflare-and-tunnel architecture in detail, gives a table of what a manager can read across eight areas, separately and thoroughly justifies why writes are unavailable with a list of code-level restrictions, lists twelve MCP tools, a developer quick start, and an honest section on the current version's limits including the API snapshot date and unverified parts.

README badge

Report a problem