MCP.Market

MoySklad MCP (RU) MCP server

by ilyautov·io.github.ilyautov/moysklad-mcp-ru·v0.2.0·2 stars

MoySklad JSON API 1.2 in your AI assistant — schema-driven, safety-gated document writes.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

2 stars52 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • get_workflow

    Return the full plan for one workflow: ordered steps (each naming a catalog operation_id and why), interpretation guidance, and common mistakes to avoid.

  • list_workflows

    List ready-made analytical workflows (recipes) for this marketplace.

  • ms_build_document

    PREVIEW 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_purchaseorder

    PREVIEW 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 action

    Create 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 action

    Create 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 action

    DELETE a document — e.g. remove a test draft to clean up. DESTRUCTIVE — requires both confirmations.

  • ms_get_counterparties

    Counterparties (customers and suppliers). Balance fields in kopecks.

  • ms_get_documents

    List a role document by type. Document total in "sum" (kopecks).

  • ms_get_money

    Cash balances by account/cashbox (kopecks). For cashflow over time use ms_call_method('ms_get_report_money_plotseries', ...) from the map.

  • ms_get_orders

    List customer orders. Document total is "sum" (kopecks in raw API).

  • ms_get_products

    List products/services/bundles (assortment) with prices and stock.

  • ms_get_profit

    Profitability by product (sale, cost, profit, margin). Money in kopecks.

  • ms_get_stock

    Current stock snapshot, grouped by product (fast /report/stock/all/current).

  • ms_get_stores

    Warehouses/stores (small dictionary). No money fields.

  • ms_get_turnover

    Turnover by product: opening/income/outcome/closing in qty and money (kopecks).

  • ms_ping

    Live connectivity + auth check: GET assortment?limit=1.

  • ms_post_documentwrite action

    POST / провести 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

no findings
  • 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
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

More from ilyautov →