МойСклад MCP: Documentation

Connection

npx -y @theyahia/moysklad-mcp (stdio) or HTTP_PORT=3000 npx @theyahia/moysklad-mcp (Streamable HTTP, POST /mcp). Auth: MOYSKLAD_TOKEN (Bearer, preferred — Settings → Users → Access tokens) or MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD (Basic).

Capabilities

60 tools: products and catalog (search_products, get_product, create_product, update_prices, search_assortment, search_variants/search_bundles/search_services), stock (get_stock, get_stock_by_store, get_stock_current), counterparties (get_counterparties, get_counterparty, create_counterparty), orders and shipments (create_customer_order, create_purchase_order, create_demand, create_supply, create_sales_return/create_purchase_return), warehouse documents (create_move, create_enter, create_loss, create_inventory), finance (create_payment_in/create_payment_out, create_cash_in/create_cash_out, create_invoice_out/create_invoice_in), reports (get_profit_report, get_sales_report, get_dashboard, get_turnover, get_money_report), reference data and audit (get_metadata, get_audit), webhooks (list_webhooks/create_webhook/update_webhook/delete_webhook).

Amounts are always passed and returned in rubles — conversion to the API's kopecks happens inside the server.

Agent flow

"Show product X's stock across warehouses", "create a customer order and ship it from the warehouse", "pull this month's profit report by product".

Limits

Rate limit is weight-per-3-seconds (default budget 20 out of ~45 for a solution token); on repeated 429s the server waits and retries on its own. Webhooks and some reports require a paid MoySklad plan.

Note

A community project (theYahia), not an official MoySklad product.