wildberries-finances-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wildberries-finances-mcp-server get the weekly report for last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WB Finances MCP Server
MCP сервер для работы с API Wildberries Finances.
Описаны все ручки из OpenAPI спецификации, выставлены как
Tool(src/tools/api)Добавлены некоторые "кастомные"
Toolы (src/tools/custom)
Установка
npm installRelated MCP server: Wildberries API MCP Server
Настройка
Создайте файл
.envв корневой директории проекта(по примеру.env.example)Добавьте следующие переменные окружения:
WB_FINANCES_OAUTH_TOKEN=your_oauth_token_here
Запуск
Разработка
npm run devПродакшн
npm run build
npm startДебаг
npx @modelcontextprotocol/inspector node ./build/index.jsИспользование
Сервер предоставляет следующие инструменты:
getReportDetailByPeriod- Получение детализации по еженедельным отчётам реализацииgetTotalCommissionByPeriod- Подсчёт отчислений в пользу WB + НДС за периодgetDocumentCategories- Получение категорий документовgetDocumentList- Получение списка документовdownloadDocument- Загрузка одного документаdownloadDocumentsAll- Загрузка нескольких документовgenerateWeeklyReport- Генерация еженедельного отчёта
Конфиг для Goose
Добавьте в конфиг Гуся(~/.config/goose/config.yaml):
wildberries-finances-mcp:
args:
- /path/to/wildberries-finances-mcp-server/build/index.js
bundled: null
cmd: node
description: null
enabled: true
env_keys: []
envs: {}
name: wildberries-finances-mcp
timeout: 300
type: stdioКонфиг для Cline:
"wildberries-finances-mcp": {
"autoApprove": [],
"disabled": false,
"timeout": 300,
"command": "node",
"args": [
"/path/to/wildberries-finances-mcp-server/build/index.js"
],
"type": "stdio"
}Безопасность
API ключ должен храниться в переменных окружения
Не включайте файл
.envв систему контроля версийИспользуйте разные API ключи для разработки и продакшена
Available Tools
8 toolscalculateReportMetricsC
Вычисляет основные метрики по отчёту
Inputs: dateTo (required), dateFrom (required), limit, rrdid.
downloadDocumentB
Метод загружает один документ из списка документов продавца
Inputs: extension (required), serviceName (required).
downloadDocumentsAllB
Метод загружает несколько документов из списка документов продавца
Inputs: params (required).
generateWeeklyReportC
Еженедельный отчёт по продажам и комиссиям
Inputs: dateTo (required), dateFrom (required), limit, rrdid.
getDocumentCategoriesC
Метод предоставляет категории документов для получения списка документов продавца
Inputs: locale.
getDocumentListC
Метод предоставляет список документов продавца
Inputs: endTime (required), beginTime (required), sort, order, +3 more.
getReportDetailByPeriodB
Метод предоставляет детализации к еженедельным отчётам реализации.
Данные доступны с 29 января 2024 года.
Важно!
Вы можете выгрузить данные в Google Таблицы
Ограничение:
Максимум 1 запрос в минуту на один аккаунт продавца
Inputs: dateTo (required), dateFrom (required), limit, rrdid.
getTotalCommissionByPeriodC
Подсчёт отчислений в пользу WB + НДС за период
Inputs: dateTo (required), dateFrom (required), limit, rrdid.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools are clearly distinct, especially document tools (getDocumentCategories, getDocumentList, downloadDocument, downloadDocumentsAll). However, report-related tools (getReportDetailByPeriod, getTotalCommissionByPeriod, generateWeeklyReport, calculateReportMetrics) have overlapping purposes that could cause misselection, though descriptions help differentiate them.
All names are camelCase but use inconsistent verb prefixes (get, download, generate, calculate) and vary in structure (e.g., downloadDocumentsAll vs downloadDocument). This mixed convention reduces predictability, though the naming is still readable.
Eight tools is an appropriate size for the Wildberries finances domain. The tool count is well-scoped, covering both report analysis and document management without unnecessary duplication or overwhelming the user.
The tool set covers essential operations: retrieving report details, calculating commissions, generating weekly reports, computing metrics, and managing documents. However, there is no explicit tool for listing available report periods or fetching raw sales data, which creates a minor gap in the workflow.
Maintenance
Related MCP Connectors
Company finances for agents: transactions, invoices, bills, expenses, subscriptions, receipts.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
Invoicing, costs, KPiR, VAT and KSeF data from your Mobilna Faktura account (Poland).
Financial intelligence for AI: manage balances, transactions, payments, and more
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that simplifies interaction with Wildberries API, providing unified access to analytics, promotion statistics, sales funnel data, search queries, stock reports, and EVIRMA PRO report imports.MIT
- FlicenseNot gradedqualityDmaintenanceEnables access to Wildberries marketplace feedback and questions, allowing listing accounts, filtering feedbacks, viewing statistics and ratings, and posting answers, with secure token management and throttling.-
- AlicenseAqualityCmaintenanceEnables AI agents to read and work with Wildberries, Ozon, and Yandex Market seller accounts through typed tools, multi-account support, unified data schemas, rate limiting, audit, and encrypted credential storage.1751 npmMIT