WB Readonly MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_PASSWORD | Yes | Password required for MCP clients to connect. | |
| WB_API_TOKEN | Yes | Personal Wildberries API token with read-only permissions. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wb_statusA | Начните здесь. Проверка конфигурации без запросов к WB. Никакие секреты не возвращаются. |
| wb_catalogA | Найти операции по русским словам или группе. Получите ID, затем вызовите wb_schema и wb_read. Пустой поиск перечисляет возможности постранично. |
| wb_schemaA | Точная схема path/query/body, ограничения, источник и дата. Прочитайте перед первым вызовом операции. Не придумывайте параметры. |
| wb_readA | Вызвать только операцию из проверенного каталога. Нельзя передать произвольный URL, метод или заголовок. Возвращает ограниченное превью и resultId; полный ответ доступен через wb_result. Это одна страница WB, не гарантированно вся выборка. |
| wb_resultA | Читает сохранённый ответ частями. arrayPointer — JSON Pointer массива, объекта или поля. Для длинного текста/base64 укажите путь к строке и textOffset. Вложенное превью ограничено: читайте точный путь для деталей. nextOffset относится только к сохранённому ответу, не к API WB. |
| wb_find_productA | Поиск своего товара по nmId, артикулу продавца, штрихкоду или названию. Для названия сканирует карточки ограниченными страницами; возвращает partial и nextCursor. Не выбирайте товар молча, если есть несколько кандидатов. |
| wb_product_profileC | Карточка, предмет, родительская категория, требования к характеристикам и цены. Категория определяется по найденной карточке. Доступ только к своему каталогу. |
| wb_sales_funnelC | Переходы, корзины, заказы, выкупы по заданным товарам. Данные обновляются с задержкой и могут пересчитываться. selectedPeriod и pastPeriod относятся к датам заказов. |
| wb_ads_auditA | Рассчитывает CTR, CPC и ДРР по сумме атрибутированных заказов WB. Это не прибыль и не ДРР по выкупам. До 50 кампаний и 31 дня на вызов; малые выборки не доказывают неэффективность. |
| wb_aggregateA | Локальные суммы, средние, группировка и фильтр по сохранённому результату. Поля задаются JSON Pointer. Пропуски не превращаются в нули. Расчёт касается только сохранённой страницы WB. |
| wb_stock_planA | Локальный прогноз по явно указанным остаткам, спросу и срокам. Передайте значения из WB с согласованными периодами. Ничего не заказывает и не создаёт поставку. |
| wb_unit_economicsB | Сценарный расчёт на одну выкупленную единицу из введённых затрат. Все суммы в одной валюте; налог и комиссия передаются денежными суммами. Не является итоговым финансовым отчётом WB. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| wb_daily_review | Ежедневный разбор кабинета без изменений WB |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| wb-guide | Инструкция для ИИ: поиск товаров, инструменты и корректная аналитика |
TDQS
Scored across 12 tools
Each tool has a clearly distinct purpose: discovery (catalog/schema), execution (read), result handling (result/aggregate), product-specific (find_product/product_profile), analytics (sales_funnel/ads_audit), and local calculations (stock_plan/unit_economics). Descriptions are explicit about boundaries and dependencies, so misselection is unlikely.
All tools share the wb_ prefix and use snake_case, but the suffix pattern mixes nouns (status, catalog, schema, result) and verbs (read, find_product). This is consistent in style but not strictly verb_noun; the naming is predictable and readable.
With 12 tools, the server is well-scoped for a read-only Wildberries API wrapper. Each tool serves a distinct function, and the count is within the ideal 3–15 range without being redundant.
The tool set covers the full read lifecycle: discovering operations (wb_catalog), understanding schemas (wb_schema), executing reads (wb_read), retrieving full results (wb_result), and performing local analysis (wb_aggregate, wb_stock_plan, wb_unit_economics). Product discovery, profile, and analytics are also covered. No critical gaps for the stated read-only purpose.