Wildberries MCP

wildberries-mcp

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

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

Broad access

Why this level

  • Changes prices and stock in a live seller account
  • Creates and closes FBS supplies and publishes review replies
  • Holds the seller API token
All reasons and checks
Russian stack

theyahia/wildberries-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/theyahia-wildberries-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

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

  • Changes prices and stock in a live seller account
  • Creates and closes FBS supplies and publishes review replies
  • Holds the seller API token

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

What it does

The server connects a Wildberries seller account to the agent through 30 tools. The agent reads product cards, orders, sales, WB warehouse stock, sales reports, the funnel and paid storage, and runs ABC analysis. It can also change prices and stock, create FBS supplies and add orders to them, and reply to reviews and questions. Each request goes to the host of its API category, and the built-in rate limiter handles 409 penalties per category. The repo ships three simple Claude Code skills: today's orders, sales analytics and low-stock products.

Who it is for. For Wildberries sellers and their managers who want to query the seller account in plain language.

Good fit when

  • You need a sales summary and ABC analysis for a period
  • You need products that are running out of stock
  • You need to work through unanswered questions and reviews

Not a fit when

  • Price and stock changes must never happen without manual review
  • You need competitor analytics rather than your own account

Example request

Run an ABC analysis for the last 30 days and show the products that bring 80% of revenue

MCP

Transport
stdio
Authentication
API key

Environment variables

WB_API_TOKEN required, secret
Wildberries seller API token (JWT)
WB_TIMEOUT_MS
Request timeout in milliseconds, 30000 by default
PORT
Port for --http mode, 3000 by default

Limitations

Requires a seller API token with the right access categories; tokens last 180 days. Tools of a missing category return 401. Write tools change real prices, stock and supplies. Unofficial project, part of the author's WWmcp series.

How to disable. Delete the wildberries block from your MCP client config and, if installed globally, run npm uninstall -g @theyahia/wildberries-mcp.

FAQ

Why do some tools return 401?

The token lacks that access category. The error names the host, which tells you which category to enable.

Can it run over HTTP?

Yes, with --http it serves Streamable HTTP on the PORT variable, 3000 by default.

Discussion

No questions or reviews yet.

Russian stack

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

MCP serverBroad access5Repository stars
Russian stack

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

MCP serverBroad access2Repository stars
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

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

MCP serverExtended access

Wildberries MCP search server

Wildberries MCP Server

Russian stack

A lightweight MCP server for searching Wildberries products via its public JSON API: product card, price, reviews with no browser

MCP serverExtended access2Repository stars

Comparison with similar tools

Entries that share the main search query, and how they differ.

EntryOfficialAuthenticationRepository starsMain difference
Wildberries MCP (this entry)noAPI key16
A minimal Python Wildberries MCP servernoAPI key0single-file server
Wildberries API MCP server with Cloudflare deploynoAPI key0stock, CSV

Alternatives

Tools by other authors for the same tasks.

README in short

The Russian README covers a quick start via npm, a Claude Desktop config and Smithery installation. It maps each tool to the token category it needs and lists the Wildberries API hosts. A section explains how the server respects rate limits and handles 409 penalties. It ends with sample prompts and development commands. MIT licensed.

README badge

Report a problem

Foxx AIWildberries 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.