Summary
MoySklad (МойСклад) JSON API 1.2 for trade and warehouse management: assortment and products, stock reports, counterparties, customer orders, shipments, supplies, invoices, stores and profit and turnover reports. Access token.
Guided setup
Connect MoySklad to Cursor in 2 minutes
Start a free trial on AnythingMCP Cloud, connect MoySklad in the guided setup, then add your MCP URL to Cursor. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for MoySklad
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → MoySklad, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
MoySklad + Cursor
MoySklad (МойСклад) JSON API 1.2 for trade and warehouse management: assortment and products, stock reports, counterparties, customer orders, shipments, supplies, invoices, stores and profit and turnover reports. Access token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
MOYSKLAD_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- In MoySklad open the settings (Настройки) and the section for access tokens (Токены), create a token for the user the AI should act as, and copy it. It is shown only once.
- Paste it into
MOYSKLAD_TOKEN.
Without that section a token can also be issued with the login and password: a POST to /security/token with HTTP Basic answers access_token (this revokes the earlier tokens of the user). The token acts with the rights of its user, so a user with read-only rights makes a read-only connector.
The connector sends Authorization: Bearer, Accept-Encoding: gzip and Accept: application/json;charset=utf-8 on every call. MoySklad refuses calls without gzip with 415 and no body.
Where to start: moysklad_get_employee_context shows the user and its rights. moysklad_list_assortment searches everything that can be sold, moysklad_get_current_stock gives stock numbers fast, and moysklad_list_customer_orders lists orders.
Catalogue: moysklad_list_assortment, moysklad_list_products, moysklad_get_product, moysklad_create_product, moysklad_update_product, moysklad_list_product_folders.
Stock: moysklad_get_stock_report (all stores, with cost and sale price), moysklad_get_stock_by_store (per store) and moysklad_get_current_stock (ids and one number, no paging, good for frequent checks). The two extended reports count as 5 requests each.
Counterparties: moysklad_list_counterparties, moysklad_get_counterparty, moysklad_create_counterparty, moysklad_update_counterparty.
Documents: moysklad_list_customer_orders, moysklad_get_customer_order, moysklad_get_customer_order_metadata (statuses), moysklad_create_customer_order, moysklad_update_customer_order; moysklad_list_demands and moysklad_get_demand (shipments); moysklad_list_supplies and moysklad_get_supply (goods received); moysklad_list_invoices_out and moysklad_get_invoice_out. References: moysklad_list_stores, moysklad_list_organizations.
Reports: moysklad_get_profit_by_product, moysklad_get_profit_by_counterparty, moysklad_get_turnover, moysklad_get_dashboard.
Paging: lists return at most 1000 rows per call (limit, default here 100) from offset; meta.size is the total and meta.nextHref is present while more rows follow. With expand the limit is 100: a larger limit makes MoySklad ignore the expand. Document lines beyond the first 1000 are read through the positions of the document.
Money and dates: all amounts and prices are in kopecks (minor units): 150000 means 1500.00. Dates are YYYY-MM-DD HH:MM:SS in Moscow time. Ids are UUIDs.
References (meta): another object is referenced as an object with meta holding href, type and mediaType, never by a bare id. Every row carries its own meta: copy it when a tool asks for a reference (store, state, the assortment of an order line). In list filters a reference is its href; in the short stock report it is the bare id.
Filters: filter joins conditions with ;. Operators: =, !=, >, <, >=, <=, ~ contains, ~= starts with, =~ ends with. search is a full-text search. order sorts, e.g. moment,desc.
Limits: a user token gets 45 units per 3 seconds and each request costs several units (4 from 1 December 2026, so about 11 requests per 3 seconds; the two extended stock reports cost 5). At most 5 calls of one user in parallel. A 429 carries X-Lognex-Retry-After in milliseconds. MoySklad switches API access off for users that keep sending failing calls (more than 200 identical failing requests a minute), so do not retry errors in a loop. Deleting objects and payments is not part of this connector.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Cursor
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart Cursor.
- Open Cursor → Settings → MCP and check that
anythingmcpis listed and connected. - Start chatting — the agent can now call the
MoySkladtools.
Available tools
| Tool | What it does |
|---|---|
moysklad_get_employee_context | Read the employee the token belongs to: name, email, the account, and the permissions per entity. Use it to check the token and what it may… |
moysklad_list_assortment | List everything that can be sold in one list: products, variants (modifications), services, bundles and consignments, each with id, meta… |
moysklad_list_products | List products: id, name, code, article, description, productFolder, uom, salePrices, buyPrice and minPrice in kopecks, barcodes, vat… |
moysklad_get_product | Read one product with its prices in kopecks, barcodes, units, folder, supplier, custom fields (attributes) and tracking settings. Read-only |
moysklad_create_product | Create a product with a name and optionally code, article, description, VAT, weight and purchase price. Returns the product with its id and… |
moysklad_update_product | Update a product: only the fields given change. Returns the updated product. MoySklad blocks a user that sends more than 100 updates of the… |
moysklad_list_product_folders | List product groups (folders): id, name, pathName (the path of parent groups), code, description and archived. Returns meta (size, limit… |
moysklad_get_stock_report | Extended stock report per item over all stores: name, code, article, stock, reserve, inTransit and quantity (available), price (cost) and… |
moysklad_get_stock_by_store | Stock report per item and store: each row has the item meta and stockByStore with name, stock, reserve and inTransit per store. Each call… |
moysklad_get_current_stock | Short stock report for frequent checks: only assortmentId (and storeId with scope bystore) with one number, in a single answer without… |
moysklad_list_counterparties | List counterparties (customers and suppliers): id, name, code, companyType, inn, kpp, legalTitle, phone, email, actualAddress, tags… |
moysklad_get_counterparty | Read one counterparty with legal details (inn, kpp, legalAddress), contacts, bank accounts, tags, discounts, price type and custom fields.… |
moysklad_create_counterparty | Create a counterparty (customer or supplier) with a name and optionally type, tax numbers, addresses, phone, email and tags. Returns the… |
moysklad_update_counterparty | Update a counterparty: only the fields given change; a given tags list replaces the old one. Returns the updated counterparty |
moysklad_list_customer_orders | List customer orders: id, name (the order number), moment, sum, payedSum, shippedSum, invoicedSum and reservedSum in kopecks, applicable… |
moysklad_get_customer_order | Read one customer order: number, moment, sums in kopecks, counterparty (agent), organization, store, state, shipment address, comment and… |
moysklad_get_customer_order_metadata | Read the metadata of customer orders: the states (statuses) with id, name, stateType and meta, and the custom fields (attributes). The… |
moysklad_create_customer_order | Create a customer order for an organization (your legal entity) and a counterparty, with order lines. Returns the order with its id, number… |
moysklad_update_customer_order | Update a customer order: comment, planned shipment date, status, store or the draft flag. Only the fields given change. To change order… |
moysklad_list_demands | List demands (shipments to customers): id, name, moment, sum and payedSum in kopecks, agent, organization, store, state, the customer order… |
moysklad_get_demand | Read one demand (shipment): number, moment, sum in kopecks, counterparty, store, consignee and carrier details and the linked customer… |
moysklad_list_supplies | List supplies (goods received from suppliers): id, name, moment, sum and payedSum in kopecks, agent (the supplier), organization, store… |
moysklad_get_supply | Read one supply (goods receipt): number, moment, sum in kopecks, supplier, store, the incoming document number and overhead costs. Add… |
moysklad_list_invoices_out | List invoices issued to customers: id, name, moment, sum, payedSum and shippedSum in kopecks, agent, organization, paymentPlannedMoment and… |
moysklad_get_invoice_out | Read one invoice issued to a customer: number, moment, sum and payedSum in kopecks, counterparty, organization with its bank account and… |
moysklad_list_stores | List stores (warehouses): id, name, code, address, pathName for nested stores, archived and meta. The meta is what orders and report… |
moysklad_list_organizations | List your organizations (legal entities): id, name, legalTitle, inn, kpp, legalAddress, companyType and meta. An order always needs one.… |
moysklad_get_profit_by_product | Profit report per product, service and bundle for a period: sellQuantity, sellPrice, sellCost, sellSum, sellCostSum, returnQuantity… |
moysklad_get_profit_by_counterparty | Profit report per customer for a period: demandsCount, demandsSum, averageReceipt, returnsCount, returnsSum, discountsSum, balance… |
moysklad_get_turnover | Turnover report per item for a period: stock at the start (onPeriodStart), income, outcome and stock at the end (onPeriodEnd), each with… |
moysklad_get_dashboard | Key figures for today, the last week or the last month: sales (count, amount, movementAmount), orders (count, amount, movementAmount) and… |
Example prompts
- "What is the current stock of all products in the main warehouse?"
- "Which customer orders from this week are not shipped yet?"
- "Show the profit by product for October."
- "Create a customer order for ООО Ромашка: 10 pieces of the product Чайник 1,7 л."
- "Which counterparties bought the most last quarter?"
FAQ
Where does the token come from? In MoySklad, settings (Настройки), access tokens (Токены): create a token for the user the AI should act as and copy it, it is shown once. The token has the rights of that user, so a user with read-only rights makes a read-only connector.
What does it cover? The assortment and products with folders, stock reports overall, per store and the fast current stock, counterparties, customer orders with their statuses, shipments (demands), supplies, outgoing invoices, stores, organizations, and the profit, turnover and dashboard reports. Amounts are in kopecks and dates in Moscow time. Deleting objects and payments are not part of the connector.
Which tools write, and what installs switched off? Products, counterparties and customer orders can be created and updated. Nothing installs switched off; the AI shows each write and waits for your confirmation.
Does Cursor support custom MCP servers on the free tier? Yes — MCP is available on Hobby, Pro and Business plans.
Next steps
Was this guide helpful?