
MoySklad MCP (RU) MCP server
MoySklad JSON API 1.2 in your AI assistant — schema-driven, safety-gated document writes.
2 stars52 downloads/wk
Reviews
Write oneNobody has reviewed MoySklad MCP (RU) yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MoySklad MCP (RU) tools (18, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_workflowReturn the full plan for one workflow: ordered steps (each naming a catalog operation_id and why), interpretation guidance, and common mistakes to avoid.
list_workflowsList ready-made analytical workflows (recipes) for this marketplace.
ms_build_documentPREVIEW any role document: resolve names to refs and show the EXACT body ms_create_document would send (money already kopecks). READS only; no write.
ms_build_purchaseorderPREVIEW a purchase order: resolve names to refs and show the EXACT body ms_create_purchaseorder would send (money already kopecks). Performs READS to resolve names; sends NO write. Inspect the body/summary before creating.
ms_create_documentwrite actionCreate ANY role document as a DRAFT (applicable=false — not posted, moves nothing). WRITE — requires confirm_write=true AND MOYSKLAD_ALLOW_WRITE=1. Posting is a separate destructive step (ms_post_document). One body shape fits every order-like document (live-verified 2026-06-26 on all 6 types).
ms_create_purchaseorderwrite actionCreate a purchase order as a DRAFT (applicable=false — not posted, moves nothing). WRITE — requires confirm_write=true. Posting is separate (ms_post_document). Writes also require MOYSKLAD_ALLOW_WRITE=1 (off by default).
ms_delete_documentwrite actionDELETE a document — e.g. remove a test draft to clean up. DESTRUCTIVE — requires both confirmations.
ms_get_counterpartiesCounterparties (customers and suppliers). Balance fields in kopecks.
ms_get_documentsList a role document by type. Document total in "sum" (kopecks).
ms_get_moneyCash balances by account/cashbox (kopecks). For cashflow over time use ms_call_method('ms_get_report_money_plotseries', ...) from the map.
ms_get_ordersList customer orders. Document total is "sum" (kopecks in raw API).
ms_get_productsList products/services/bundles (assortment) with prices and stock.
ms_get_profitProfitability by product (sale, cost, profit, margin). Money in kopecks.
ms_get_stockCurrent stock snapshot, grouped by product (fast /report/stock/all/current).
ms_get_storesWarehouses/stores (small dictionary). No money fields.
ms_get_turnoverTurnover by product: opening/income/outcome/closing in qty and money (kopecks).
ms_pingLive connectivity + auth check: GET assortment?limit=1.
ms_post_documentwrite actionPOST / провести a document: sets applicable=true, which MOVES STOCK AND MONEY in the books. DESTRUCTIVE — requires confirm_write=true AND i_understand_this_modifies_data=true. Separate from creation on purpose.
Public scan report
scanner v0.1.10 · 2026-10-03 · same rubric, same numbers if you re-run it
- Code scan30 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How MoySklad MCP (RU) compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 18
- the typical server has 7
- Tools that change things
- 22%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,688 servers
- Downloads a week
- 52
- more than 43% of 12,191 servers with a package
What its tools let an agent do: 14 read · 4 change
Install MoySklad MCP (RU) in Claude Code, Cursor or VS Code
claude mcp add moysklad-mcp-ru -- uvx moysklad-mcp-ru
What the publisher says
From the MoySklad MCP (RU) repository's README, as published. We do not edit it. Read it on GitHub
moysklad-mcp-ru: AI-доступ к МойСклад для Claude Code, Cursor, Codex и Cowork
🇬🇧 English version
Ведёте учёт в МойСклад — дайте ИИ прямой доступ к вашему аккаунту. Один
MCP-сервер над JSON API 1.2 МойСклад: остатки, товары, заказы, контрагенты,
отчёты (прибыль, обороты, деньги) и запись документов (приёмки, отгрузки,
заказы, счета, возвраты) — напрямую по API, без браузера. Числа приходят из
реального API, а не выдумываются моделью. Два гейта на запись не дают
случайно создать или провести документ в боевом учёте. Авто-пагинация,
мультикабинет, поиск по-русски. Для Claude Code, Cursor, Codex, Cowork и Claude
Desktop.
Быстрый старт, без установки в систему:
uvx moysklad-mcp-ruКлиенты, токен и способ «попроси своего ИИ поставить»: в разделе «Установка».
⚠️ alpha. Помогает с операционкой учёта, но это инструмент, а не замена
бухгалтера. Курированное ядро и срез записи выверены боем на тестовом кабинете;
импортированные из доки методы — карта для разведки (пути надёжны, тела
write-запросов сверяйте по доке или зовите через raw-инструменты). Подробности — в
разделе «Оговорки».
Зачем это нужно
Учёт живёт в МойСклад, а ИИ-ассистент обычно бесполезен: либо ходит через браузер и спотыкается, либо выдумывает цифры, которые звучат уверенно. moysklad-mcp-ru даёт агенту прямой доступ к JSON API 1.2 вашего аккаунта:
обороты — это ответ МойСклад, с источником и полями.
- Числа из реального API, а не из головы модели. Остатки, заказы, прибыль,
(двигает учёт) — отдельный destructive-шаг с подтверждением. Запись вообще выключена, пока её явно не включить и не направить на тестовый кабинет.
- Запись за двумя гейтами. Создание документа делает ЧЕРНОВИК; проведение
- Без браузера. Прямые HTTPS-вызовы по токену кабинета.
Скажите агенту обычными словами: «покажи остатки», «что пора дозаказать», «создай приёмку на 10 Рога от поставщика» — он подберёт метод или сценарий.
Что внутри
Не «один тул на эндпоинт», а 10 generic мета-тулов над каталогом — полное покрытие API при маленькой поверхности.
ваш ИИ-агент
│
▼
10 мета-тулов ──► каталог (endpoints.yaml) ──► общий core
search / describe / клиент · safety · ошибки
call / write / delete / пагинация · реестр
fetch_all / map / ... │
+ типизированные тулы (ms_get_stock, ms_create_document, …) ▼
МойСклад JSON API 1.2 (HTTPS)Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
MoySklad MCP (RU): common questions
- Is MoySklad MCP (RU) MCP server safe?
- Mostly: it is graded B (83/100). Read the MoySklad MCP (RU) safety report
- How do I install MoySklad MCP (RU)?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does MoySklad MCP (RU) need an API key?
- Yes. The registry entry asks for
MOYSKLAD_TOKEN. - Is MoySklad MCP (RU) maintained?
- The last commit was 34 days ago (2026-10-01). The latest release is v0.2.0.
- How does MoySklad MCP (RU) compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 18 (the typical server has 7); tools that change things 22% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.