Инструменты MCP

Инструменты, которые MCP-сервер Wasyt (POST /mcp) даёт ИИ-ассистенту. Все только читают данные и ограничены компаниями директора (своя компания и филиалы). Как подключиться — в разделе «Подключение MCP».

Инструмент	Назначение
list-products-tool	Список товаров
list-services-tool	Список услуг
list-categories-tool	Дерево категорий
list-sales-tool	Список продаж
get-sale-tool	Карточка продажи
list-purchases-tool	Список приходов
get-purchase-tool	Карточка прихода
list-writeoffs-tool	Список списаний
list-transfers-tool	Список перемещений
list-inventories-tool	Список инвентаризаций
list-cashboxes-tool	Список касс
list-cashbox-transactions-tool	Движения по кассам
list-client-debts-tool	Долги клиентов
list-suppliers-tool	Список поставщиков
list-supplier-transactions-tool	Движения по поставщикам
list-companies-tool	Компания и филиалы
list-employees-tool	Сотрудники
list-clients-tool	Клиенты
list-stocks-tool	Склады
list-stock-products-tool	Остатки на складах
get-dashboard-stats-tool	Статистика дашборда
get-billing-info-tool	Подписка Wasyt

Список товаров

TOOLlist-products-tool

Товары компаний директора с категорией, брендом, единицей измерения и текущей ценой. Поиск по названию или штрихкоду, фильтр по категории и компании.

Параметры

Параметр	Тип	Обязательно	Описание
search	string	Нет	Поиск по названию или штрихкоду.
category_id	integer	Нет	ID категории (см. list-categories-tool).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-products-tool",
        "arguments": {
            "search": "…",
            "category_id": 1
        }
    }
}

Список услуг

TOOLlist-services-tool

Продаваемые услуги (не физические товары) с ценой, единицей и категорией. Поиск по названию, фильтр по категории и компании.

Параметры

Параметр	Тип	Обязательно	Описание
search	string	Нет	Поиск по названию услуги.
category_id	integer	Нет	ID категории (см. list-categories-tool).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-services-tool",
        "arguments": {
            "search": "…",
            "category_id": 1
        }
    }
}

Дерево категорий

TOOLlist-categories-tool

Дерево категорий товаров компании директора. ID категорий используются в фильтрах list-products-tool и list-services-tool.

Параметры

Без параметров.

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-categories-tool",
        "arguments": {}
    }
}

Список продаж

TOOLlist-sales-tool

Продажи (чеки POS) с суммами, статусом, клиентом, кассой и складом, новые сверху. Фильтр по периоду, статусу и компании.

Параметры

Параметр	Тип	Обязательно	Описание
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
status	string	Нет	Статус продажи. Допустимые значения: in_progress, completed, partial_returned, full_returned, canceled
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-sales-tool",
        "arguments": {
            "date_from": "2026-09-01",
            "date_to": "2026-09-01"
        }
    }
}

Карточка продажи

TOOLget-sale-tool

Одна продажа целиком: строки чека (включая услуги), разбивка оплат по типам и связанный долг клиента, если продажа была в долг.

Параметры

Параметр	Тип	Обязательно	Описание
sale_id	integer	Да	ID продажи (см. list-sales-tool).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get-sale-tool",
        "arguments": {
            "sale_id": 1
        }
    }
}

Список приходов

TOOLlist-purchases-tool

Приходы товара от поставщиков с поставщиком, складом, суммами и статусом, новые сверху. Фильтр по поставщику, складу, статусу, валюте, периоду и компании.

Параметры

Параметр	Тип	Обязательно	Описание
supplier_id	integer	Нет	ID поставщика.
stock_id	integer	Нет	ID склада-получателя.
status	string	Нет	Статус прихода. Допустимые значения: waiting_for_confirmation, completed, canceled
currency	string	Нет	Валюта. Допустимые значения: uzs, usd, eur, rub
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-purchases-tool",
        "arguments": {
            "supplier_id": 1,
            "stock_id": 1
        }
    }
}

Карточка прихода

TOOLget-purchase-tool

Один приход целиком: поставщик, склад, суммы и статус, плюс каждая строка товара с количеством и ценами.

Параметры

Параметр	Тип	Обязательно	Описание
purchase_id	integer	Да	ID прихода (см. list-purchases-tool).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get-purchase-tool",
        "arguments": {
            "purchase_id": 1
        }
    }
}

Список списаний

TOOLlist-writeoffs-tool

Списания товара, включая возвраты поставщику; source_type показывает, списано со склада или по приходу. Фильтр по периоду, статусу, источнику и компании.

Параметры

Параметр	Тип	Обязательно	Описание
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
status	string	Нет	Статус списания. Допустимые значения: waiting_for_confirmation, completed, canceled
source_type	string	Нет	Источник: stock — со склада, purchase — возврат поставщику, inventory — по инвентаризации. Допустимые значения: stock, purchase, inventory
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-writeoffs-tool",
        "arguments": {
            "date_from": "2026-09-01",
            "date_to": "2026-09-01"
        }
    }
}

Список перемещений

TOOLlist-transfers-tool

Перемещения между складами, в том числе между филиалами: откуда и куда, статус и данные о завершении. Фильтр по периоду, статусу, складам и компании.

Параметры

Параметр	Тип	Обязательно	Описание
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
status	string	Нет	Статус перемещения. Допустимые значения: waiting_for_confirmation, completed, canceled
stock_from_id	integer	Нет	ID склада-отправителя.
stock_to_id	integer	Нет	ID склада-получателя.
company_id	integer	Нет	ID компании — отправителя или получателя. По умолчанию — все компании директора.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-transfers-tool",
        "arguments": {
            "date_from": "2026-09-01",
            "date_to": "2026-09-01"
        }
    }
}

Список инвентаризаций

TOOLlist-inventories-tool

Инвентаризации складов с ожидаемым и фактическим количеством и разницей в деньгах. Фильтр по периоду, статусу, типу, складу и компании.

Параметры

Параметр	Тип	Обязательно	Описание
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
status	string	Нет	Статус инвентаризации. Допустимые значения: in_progress, completed, canceled
type	string	Нет	partial — часть товаров, full — весь склад. Допустимые значения: partial, full
stock_id	integer	Нет	ID склада.
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-inventories-tool",
        "arguments": {
            "date_from": "2026-09-01",
            "date_to": "2026-09-01"
        }
    }
}

Список касс

TOOLlist-cashboxes-tool

Кассы с текущими остатками по типам оплаты и валютам. Фильтр по типу кассы и компании.

Параметры

Параметр	Тип	Обязательно	Описание
type	string	Нет	Тип кассы: main — основная, sale — продажная (POS). Допустимые значения: main, sale
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-cashboxes-tool",
        "arguments": {
            "type": "main",
            "company_id": 1
        }
    }
}

Движения по кассам

TOOLlist-cashbox-transactions-tool

Журнал движения денег по кассам: доходы от продаж, расходы, инкассации, конвертации, оплаты поставщикам и погашения долгов клиентов. Новые сверху.

Параметры

Параметр	Тип	Обязательно	Описание
cashbox_id	integer	Нет	ID кассы (см. list-cashboxes-tool).
type	string	Нет	income — поступление, outcome — расход. Допустимые значения: income, outcome
payment_type	string	Нет	Тип оплаты: банк, карта, наличные или системный. Допустимые значения: bank, card, cash, system
currency	string	Нет	Валюта. Допустимые значения: uzs, usd, eur, rub
status	string	Нет	Статус транзакции. Допустимые значения: pending, on_hold, completed, canceled
source_type	string	Нет	Источник: перевод между кассами, смена, погашение долга, инкассация, конвертация, внешний кредит, статья дохода/расхода, продажа или оплата поставщику. Допустимые значения: cashbox, cashbox_shift, client_debt, collection, conversion, external_credit, reason, sale, supplier
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-cashbox-transactions-tool",
        "arguments": {
            "cashbox_id": 1,
            "type": "income"
        }
    }
}

Долги клиентов

TOOLlist-client-debts-tool

Долговая тетрадь: клиент, продажа, по которой возник долг, суммы и срок. remaining_amount — сколько клиент ещё должен: исходная сумма минус погашения и списания возвратами товара.

Параметры

Параметр	Тип	Обязательно	Описание
client_id	integer	Нет	ID клиента (см. list-clients-tool).
status	string	Нет	Статус долга. Допустимые значения: active, partially_repaid, expired, repaid
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-client-debts-tool",
        "arguments": {
            "client_id": 1,
            "status": "active"
        }
    }
}

Список поставщиков

TOOLlist-suppliers-tool

Поставщики с контактами и текущим балансом по валютам. Положительный баланс — компания должна поставщику, отрицательный — поставщик должен компании.

Параметры

Параметр	Тип	Обязательно	Описание
search	string	Нет	Поиск по названию, ФИО, телефону или ИНН.
type	string	Нет	person — физлицо, entity — юрлицо. Допустимые значения: person, entity
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-suppliers-tool",
        "arguments": {
            "search": "…",
            "type": "person"
        }
    }
}

Движения по поставщикам

TOOLlist-supplier-transactions-tool

Журнал расчётов с поставщиками: income увеличивает долг компании перед поставщиком (например, приход), outcome — оплата поставщику. Новые сверху.

Параметры

Параметр	Тип	Обязательно	Описание
supplier_id	integer	Нет	ID поставщика (см. list-suppliers-tool).
type	string	Нет	income — долг перед поставщиком растёт, outcome — оплата поставщику. Допустимые значения: income, outcome
currency	string	Нет	Валюта. Допустимые значения: uzs, usd, eur, rub
date_from	string	Нет	Созданные не раньше этой даты (YYYY-MM-DD).
date_to	string	Нет	Созданные не позже этой даты (YYYY-MM-DD).
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-supplier-transactions-tool",
        "arguments": {
            "supplier_id": 1,
            "type": "income"
        }
    }
}

Компания и филиалы

TOOLlist-companies-tool

Компания директора и её филиалы с реквизитами, головной компанией и директором. Отключённый филиал (мягко удалённый) не выводится без include_disabled.

Параметры

Параметр	Тип	Обязательно	Описание
include_disabled	boolean	Нет	Включить отключённые филиалы. По умолчанию выключено.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-companies-tool",
        "arguments": {
            "include_disabled": true,
            "page": 1
        }
    }
}

Сотрудники

TOOLlist-employees-tool

Сотрудники и директора компаний с профилем, ролью и компанией. Поиск по логину, телефону или ФИО.

Параметры

Параметр	Тип	Обязательно	Описание
type	string	Нет	Только директора (director) или только сотрудники (employee). По умолчанию — оба. Допустимые значения: director, employee
search	string	Нет	Поиск по логину, телефону или ФИО.
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-employees-tool",
        "arguments": {
            "type": "director",
            "search": "…"
        }
    }
}

Клиенты

TOOLlist-clients-tool

Клиенты с контактами, полом, датой рождения и бонусным балансом, новые сверху. Поиск по имени или телефону.

Параметры

Параметр	Тип	Обязательно	Описание
search	string	Нет	Поиск по ФИО или основному телефону.
gender	string	Нет	Пол клиента. Допустимые значения: male, female
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-clients-tool",
        "arguments": {
            "search": "…",
            "gender": "male"
        }
    }
}

Склады

TOOLlist-stocks-tool

Склады компаний с доступностью и общим количеством товара на остатке.

Параметры

Параметр	Тип	Обязательно	Описание
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-stocks-tool",
        "arguments": {
            "company_id": 1,
            "page": 1
        }
    }
}

Остатки на складах

TOOLlist-stock-products-tool

Текущие остатки: количество каждого товара на каждом складе. Фильтр по складу, поиск по названию или штрихкоду, можно скрыть нулевые остатки.

Параметры

Параметр	Тип	Обязательно	Описание
stock_id	integer	Нет	ID склада (см. list-stocks-tool).
search	string	Нет	Поиск по названию или штрихкоду.
only_in_stock	boolean	Нет	true — только строки с остатком больше нуля.
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.
page	integer	Нет	Номер страницы, с 1.
per_page	integer	Нет	Записей на странице (не больше 50, по умолчанию 15).

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list-stock-products-tool",
        "arguments": {
            "stock_id": 1,
            "search": "…"
        }
    }
}

Статистика дашборда

TOOLget-dashboard-stats-tool

Показатели дашборда: totals — число продаж и выручка по валютам за сегодня, месяц и выбранный период; top_products — топ-10 товаров по сумме; debtors — клиенты с долгами, самые просроченные сверху.

Параметры

Параметр	Тип	Обязательно	Описание
metric	string	Да	Какой показатель вернуть. Допустимые значения: totals, top_products, debtors
date_from	string	Нет	Начало периода (YYYY-MM-DD). Для totals добавляет свой период, для top_products по умолчанию — начало месяца. debtors его не учитывает.
date_to	string	Нет	Конец периода (YYYY-MM-DD), по умолчанию сегодня.
company_id	integer	Нет	ID компании. По умолчанию — все компании, доступные директору.

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get-dashboard-stats-tool",
        "arguments": {
            "metric": "totals",
            "date_from": "2026-09-01",
            "date_to": "2026-09-01"
        }
    }
}

Подписка Wasyt

TOOLget-billing-info-tool

Собственная подписка компании на Wasyt, баланс кошелька и последние 15 платёжных операций. У филиалов своей подписки нет — данные всегда берутся по головной компании.

Параметры

Без параметров.

Пример вызова

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get-billing-info-tool",
        "arguments": {}
    }
}