Skip to main content
Glama
theYahia

MoySklad MCP Server

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@theyahia/moysklad-mcp

MCP server for MoySklad (МойСклад) warehouse / ERP / CRM API. 60 tools covering the full trade and warehouse lifecycle: products & catalog, stock, counterparties, customer & purchase orders, shipments, supplies, stock moves, inventory, write-offs/enters, returns, invoices, payments & cash, reports, audit log, and webhooks.

npm license

Part of WWmcp — a set of MCP servers for emerging markets — and the russian-mcp series.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "moysklad": {
      "command": "npx",
      "args": ["-y", "@theyahia/moysklad-mcp"],
      "env": {
        "MOYSKLAD_TOKEN": "your-bearer-token"
      }
    }
  }
}

To use login/password instead of a token, replace the env block with:

"env": { "MOYSKLAD_LOGIN": "you@example.com", "MOYSKLAD_PASSWORD": "your-password" }

Claude Code

claude mcp add moysklad --env MOYSKLAD_TOKEN=your-bearer-token -- npx -y @theyahia/moysklad-mcp

Cursor / Windsurf

Add to MCP settings:

{
  "moysklad": {
    "command": "npx",
    "args": ["-y", "@theyahia/moysklad-mcp"],
    "env": { "MOYSKLAD_TOKEN": "your-bearer-token" }
  }
}

Related MCP server: Upgates MCP Server

Auth

Variable

Description

MOYSKLAD_TOKEN

Bearer token (preferred)

MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD

HTTP Basic auth

Get a token in MoySklad: Settings → Users → Access tokens (POST /security/token also works with Basic auth). Generating a new token revokes the previous one.

Required permissions: the user/token needs access to the entities you intend to use. Read tools need view rights; create/update tools need edit rights for that document type. Webhooks and some reports require a paid MoySklad plan.

Prices

The MoySklad API stores money in kopecks (1 ruble = 100 kopecks). This server converts automatically:

  • Input: pass prices/amounts in rubles (e.g. 1500.50)

  • Output: prices/amounts are returned in rubles

  • (The get_dashboard report is passed through verbatim, so its money values are still in kopecks.)

When a product carries a sale price, MoySklad requires a price type. The server attaches your account's default price type automatically (from list_price_types); pass price_type_href to choose a specific one.

Tools (60)

Products & catalog

Tool

Description

search_products

Search products by name or article

get_product

Get a product by UUID (raw for the full object)

create_product

Create a product (price type attached automatically)

update_prices

Update sale/buy/min prices

search_assortment

Unified search across products, variants, services, bundles

list_price_types

List price types (first is the default)

search_variants / search_bundles / search_services

Search modifications / kits / services

create_service

Create a service

Stock

Tool

Description

get_stock

Current stock (quantity, reserve, in-transit)

get_stock_by_store

Stock broken down by warehouse

get_stock_current

Fast current-stock snapshot

Counterparties

Tool

Description

get_counterparties

Search by name, INN, or phone

get_counterparty

Get full details (raw for the full object)

create_counterparty

Create customer/supplier

Orders & shipments

Tool

Description

create_customer_order / get_orders / get_customer_order / update_customer_order_status

Customer order lifecycle

create_purchase_order / get_purchase_orders

Purchase orders to suppliers

create_demand

Shipment (demand) linked to an order and warehouse

create_supply

Incoming supply (purchase receipt)

create_sales_return / create_purchase_return

Returns from customers / to suppliers

Warehouse documents

Tool

Description

create_move / get_moves

Stock transfer between warehouses

create_enter / get_enters

Stock enter (оприходование)

create_loss / get_losses

Write-off (списание)

create_inventory / get_inventories

Inventory count (инвентаризация)

Finance

Tool

Description

create_payment_in / create_payment_out

Incoming / outgoing bank payments

create_cash_in / create_cash_out

Cash receipt / expense orders

create_invoice_out / create_invoice_in / get_invoices_out

Sales / supplier invoices

Reports

Tool

Description

get_profit_report

Profit by product (revenue, cost, margin)

get_sales_report

Sales by product (quantity, revenue)

get_dashboard

Day/week/month dashboard metrics

get_turnover

Product turnover over a period

get_money_report

Current money balances by account/cash

Reference & audit

Tool

Description

list_stores / list_organizations

Warehouses / legal entities

list_employees / list_currencies / list_product_folders

Reference data

get_metadata

Entity metadata (states, attributes) — find order-state hrefs here

get_audit / get_entity_audit

Account event log / single-entity history

Webhooks & generic

Tool

Description

list_webhooks / create_webhook / update_webhook / delete_webhook

Manage webhooks (CREATE/UPDATE/DELETE/PROCESSED)

get_documents / get_document

Generic list/get for any entity type not covered above

HTTP Transport

HTTP_PORT=3000 npx @theyahia/moysklad-mcp
# or
npx @theyahia/moysklad-mcp --http 3000

Endpoints: POST /mcp (JSON-RPC), GET /health (status). CORS is off by default — the HTTP endpoint acts on your MoySklad token, so set MOYSKLAD_HTTP_CORS_ORIGIN only if a trusted browser origin needs it.

Configuration (env)

Variable

Default

Description

MOYSKLAD_TOKEN

—

Bearer token

MOYSKLAD_LOGIN / MOYSKLAD_PASSWORD

—

Basic auth

MOYSKLAD_RATE_BUCKET

20

Requests allowed per 3-second window

MOYSKLAD_MAX_CONCURRENT

5

Max parallel requests (MoySklad allows 5/user)

MOYSKLAD_HTTP_CORS_ORIGIN

—

Allowed CORS origin for the HTTP transport

HTTP_PORT

—

Start the Streamable HTTP transport on this port

Rate Limiting

MoySklad uses a weight-per-3-seconds model (≈45 units for a solution token, fewer for login/password, and the get_stock/get_stock_by_store reports cost 5 units each). The built-in limiter is a token bucket charged by request weight, kept conservative by default (MOYSKLAD_RATE_BUCKET=20) because the API can temporarily disable access after repeated 429s. It retries 429/5xx with backoff, honoring MoySklad's X-Lognex-Retry-After header. Solution-token users can raise the bucket toward 45.

Troubleshooting

Symptom

Cause / fix

Auth not configured

Set MOYSKLAD_TOKEN (or MOYSKLAD_LOGIN + MOYSKLAD_PASSWORD).

auth error 401/403

Token invalid/expired or the user lacks rights for that entity. A new token revokes old ones.

MoySklad HTTP 412 …

A required field is missing (e.g. an outgoing payment may need an expense item — pass expense_item_href). The error message includes the parameter.

Many 429 / slow

Lower request volume or rely on the built-in limiter; raise MOYSKLAD_RATE_BUCKET only with a solution token.

HTTP 415

The runtime isn't sending gzip — use Node ≥18 (its fetch handles gzip automatically).

Webhooks / some reports fail

Require a paid MoySklad plan.

E-commerce Stack

Service

MCP Server

What it does

MoySklad

@theyahia/moysklad-mcp

Warehouse, products, orders

CDEK

@theyahia/cdek-mcp

Delivery, tracking

DaData

@theyahia/dadata-mcp

Address validation

YooKassa

@theyahia/yookassa-mcp

Payments

Demo Prompts

"Show me all products with low stock (less than 10 units) and their current prices"

"Create a customer order for counterparty 'OOO Roga i Kopyta' with 50 units of 'Widget Pro' at 1500 rubles each, then create a shipment from the main warehouse"

"Move 20 units of SKU LP15 from the main warehouse to the store, then pull the profit report for this month"

Development

npm install        # installs deps + git hooks (husky)
npm run build      # tsc -> dist/
npm run lint       # eslint
npm run typecheck  # tsc --noEmit
npm test           # vitest (requires Node >=20)
npm run coverage   # vitest with coverage

The published runtime supports Node ≥18; the test tooling requires Node ≥20.

API Reference

Based on MoySklad JSON API 1.2.

License

MIT

Install Server
A
license - permissive license
C
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • @theyahia/wildberries-mcp

    theYahia
    A
    license
    B
    quality
    C
    maintenance
    Wildberries Seller API MCP server providing 15 tools for managing products, prices, stocks, orders, sales, warehouses, supplies, statistics, feedbacks, and ABC analysis with built-in rate limiting and 409 penalty protection.
    30
    57
    10
    MIT

  • Upgates MCP Server

    mcp-open
    A
    license
    -
    quality
    B
    maintenance
    MCP server for automating Upgates e-commerce shops via the Upgates API v2. Provides 34 tools for managing orders, products, customers, invoices, carts, coupons, webhooks, and configuration, with built-in GDPR anonymization and readonly mode.
    MIT

  • weeek-mcp

    MaxViksna
    A
    license
    C
    quality
    C
    maintenance
    MCP server for WEEEK Public API v1 enabling management of tasks, projects, boards, tags, custom fields, time tracking, and CRM entities.
    100
    27
    MIT

  • moysklad-mcp-ru

    ilyautov
    F
    license
    A
    quality
    A
    maintenance
    Provides AI assistants with direct access to the Moysklad (МойСклад) JSON API for reading inventory, products, orders, and reports, and creating/posted documents with safety controls.
    32
    1

View all related MCP servers

Related MCP Connectors

  • inflow

    MCP Server for agents to onboard, pay, and provision services autonomously with InFlow

  • Shopify

    Shopify MCP Pack — wraps the Shopify Admin REST API (2024-01)

  • PandaDoc MCP Server

    PandaDoc MCP server for creating, sending, signing, and tracking PandaDoc documents.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/moysklad-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server