io.github.dontsovcmc/cdek

List all goods from local catalog (~/.config/mcp-server-cdek/goods.json). Returns JSON array of goods with name, weight (kg), height/width/length (cm), price.

Add a new good to local catalog. Args: name: Product name (e.g. "Wi-Fi модем") weight: Weight per unit in kg (e.g. 0.17) height: Height in cm (e.g. 8) width: Width in cm (e.g. 7) length: Length in cm (e.g. 10) price: Declared value per unit in rubles (default 100.0)

Remove a good from local catalog by exact name. Args: name: Exact product name to remove

Show current CDEK server configuration (sender, PVZ, product defaults). Reads from ~/.config/mcp-server-cdek/config.json. Does not show API credentials.

Update a configuration value in ~/.config/mcp-server-cdek/config.json. Args: section: Config section — "sender", "my_pvz", or "product_defaults" key: Setting key. For sender: company, name, full_name, email, phone. For product_defaults: name, weight, height, width, length. For my_pvz: ignored (pass any value). value: New value (numbers are auto-converted for product_defaults)

Получение локации по координатам (GET /v2/location/coordinates). Args: latitude: Latitude (e.g. 55.7558) longitude: Longitude (e.g. 37.6173)

Регистрация заказа на доставку (POST /v2/orders). Создает в ИС СДЭК заказ на доставку. Работает асинхронно — статус ACCEPTED не гарантирует создание, результат проверяется через методы получения информации. Two directions: - "from_me": send from my warehouse/PVZ to recipient's PVZ (tariff 136) or door (tariff 137) - "to_me": receive from sender to my PVZ (returns, tariff 136). Requires my_pvz in config. If product parameters are not specified, defaults from goods catalog or config are used. Args: direction: "from_me" or "to_me" recipient_name: Recipient full name (получатель) recipient_phone: Phone in international format (e.g. "+79001234567") pvz: PVZ code (e.g. "MSK005") or address for PVZ search. For from_me warehouse delivery. address: Full delivery address for door delivery (from_me) or sender address (to_me) recipient_email: Email (optional) product_name: Product name (overrides defaults) weight: Weight per unit in kg (overrides defaults) height: Height in cm (overrides defaults) width: Width in cm (overrides defaults) length: Length in cm (overrides defaults) quantity: Number of items (default 1) price: Declared value per unit in rubles (overrides defaults)

Получение информации о заказе по UUID (GET /v2/orders/{uuid}). Возвращает детальную информацию о ранее созданном заказе по его идентификатору. Также позволяет получить информацию о заказах, созданных через другие каналы. Args: uuid: Order UUID (идентификатор заказа в ИС СДЭК)

Получение информации о заказе по номеру ИМ (GET /v2/orders?im_number=). Возвращает информацию о заказе по номеру в информационной системе клиента. Args: im_number: Order number in client's system (номер заказа в ИС Клиента)

Получение информации о заказе по номеру СДЭК (GET /v2/orders). Возвращает статус заказа, историю статусов и детали доставки. Также позволяет получить информацию о заказах, созданных через ЛК и другие каналы. Args: cdek_number: CDEK tracking number (e.g. 1234567890)

Формирование и скачивание ШК-места (POST /v2/print/barcodes). Формирует ШК-место в формате PDF для заказа и сохраняет файл. Args: cdek_number: CDEK tracking number output_path: Absolute path to save PDF (e.g. /tmp/1234567890.pdf)

Формирование и скачивание ШК-места с выбором формата (POST /v2/print/barcodes). Формирует ШК-место в формате PDF с указанным размером и сохраняет файл. Args: cdek_number: CDEK tracking number output_path: Absolute path to save PDF (e.g. /tmp/1234567890_label.pdf) format: Print format — A4 (4 per page), A5 (2 per page), A6 (default, ~70x120mm), A7 (small)

Формирование и скачивание квитанции к заказу (POST /v2/print/orders). Формирует квитанцию (накладную) в формате PDF и сохраняет файл. Args: cdek_number: CDEK tracking number output_path: Absolute path to save PDF (e.g. /tmp/1234567890_waybill.pdf)

Получение списка офисов СДЭК (GET /v2/deliverypoints). Возвращает список действующих ПВЗ и постаматов в городе. Рекомендуется обновлять список офисов раз в сутки. Args: city: City name (e.g. "Москва", "Санкт-Петербург") search: Optional address substring to filter (e.g. "Тверская")

Получение списка населенных пунктов (GET /v2/location/cities). Возвращает коды городов СДЭК, необходимые для других операций. Args: city: City name or part of it (e.g. "Новосиб")

Получение списка регионов (GET /v2/location/regions). Возвращает детальную информацию о регионах с возможностью фильтрации по стране. Args: country_codes: Country codes in ISO_3166-1_alpha-2 (e.g. "RU", "KZ"). Empty for all. size: Max number of results (default 5)

Получение почтовых индексов города (GET /v2/location/postalcodes). Args: city_code: CDEK city code (use cdek_cities to find it)

Удаление подписки по UUID (DELETE /v2/webhooks/{uuid}). Args: uuid: Webhook subscription UUID

Подбор локации по названию города (GET /v2/location/suggest/cities). Возвращает подсказки по подбору населенного пункта по его наименованию. Args: name: City name or prefix (e.g. "Моск") country_code: Country code in ISO_3166-1_alpha-2 (e.g. "RU"). Empty for all.

Список доступных тарифов (GET /v2/calculator/alltariffs). Возвращает все доступные и актуальные тарифы по договору. Args: lang: Language — "rus", "eng" or "zho" (default "rus")

Расчет по коду тарифа (POST /v2/calculator/tariff). Расчет стоимости и сроков доставки по конкретному тарифу с учетом весо-габаритных характеристик. Args: tariff_code: CDEK tariff code (e.g. 136 warehouse-warehouse, 137 warehouse-door) from_city: Sender city name (e.g. "Москва") to_city: Recipient city name (e.g. "Новосибирск") weight_kg: Package weight in kg length: Package length in cm (default 10) width: Package width in cm (default 10) height: Package height in cm (default 10)

Расчет по доступным тарифам (POST /v2/calculator/tarifflist). Расчет стоимости и сроков доставки по всем доступным тарифам между двумя городами. Args: from_city: Sender city name to_city: Recipient city name weight_kg: Package weight in kg length: Package length in cm (default 10) width: Package width in cm (default 10) height: Package height in cm (default 10)

Расчет по доступным тарифам и дополнительным услугам (POST /v2/calculator/tariffAndService). Расчет стоимости и сроков доставки по доступным тарифам с учетом дополнительных услуг. Args: from_city: Sender city name to_city: Recipient city name weight_kg: Package weight in kg length: Package length in cm (default 10) width: Package width in cm (default 10) height: Package height in cm (default 10)

Изменение заказа (PATCH /v2/orders). Изменение созданного ранее заказа. Возможно только при отсутствии движения груза на складе СДЭК (статус заказа "Создан"). At least one of uuid or cdek_number must be provided. Args: uuid: Order UUID (идентификатор в ИС СДЭК) cdek_number: CDEK tracking number (alternative to uuid) comment: New comment for the order delivery_point: New delivery point code

Удаление заказа (DELETE /v2/orders/{uuid}). Удаление возможно только при отсутствии движения груза на складе СДЭК (статус "Создан"). Args: uuid: Order UUID to delete

Регистрация клиентского возврата (POST /v2/orders/{uuid}/clientReturn). Оформление возврата для интернет-магазинов. Создается только для заказов в конечном статусе "Вручен". Отличие от обычного возврата: возврат оформляет сам клиент. Args: uuid: Order UUID (идентификатор прямого заказа) tariff_code: Tariff code for return delivery (e.g. 136)

Регистрация отказа (POST /v2/orders/{uuid}/refusal). Регистрация отказа от заказа и возврат в интернет-магазин. Заказ может быть отменен в любом статусе до "Вручен"/"Не вручен". Для статуса "Создан" рекомендуется использовать удаление заказа. Args: uuid: Order UUID to refuse

Получение информации о всех заявках по заказу (GET /v2/orders/{uuid}/intakes). Args: order_uuid: Order UUID

Получение информации о чеках (GET /v2/check). Информация о чеке по заказу или за выбранный день. Provide at least one filter: order_uuid, cdek_number, or date. Args: order_uuid: Order UUID cdek_number: CDEK tracking number date: Date in YYYY-MM-DD format (дата создания чека)

Регистрация заявки на вызов курьера (POST /v2/intakes). Вызов курьера для забора груза со склада с последующей доставкой до склада СДЭК. Рекомендуемый минимальный диапазон времени — не менее 3 часов. At least one of cdek_number or order_uuid must be provided. Args: intake_date: Pickup date YYYY-MM-DD (не более 31 дня от текущей) cdek_number: CDEK order number order_uuid: Order UUID (alternative to cdek_number) intake_time_from: Pickup time from HH:MM (default 09:00, не ранее 9:00) intake_time_to: Pickup time to HH:MM (default 18:00, не позднее 22:00) comment: Comment for the courier name: Cargo description

Изменение статуса заявки на вызов курьера (PATCH /v2/intakes). Изменяет статус заявки на "Требует обработки" с дополнительными статусами. Args: uuid: Intake request UUID status_code: New status code

Получение информации о заявке по UUID (GET /v2/intakes/{uuid}). Args: uuid: Intake request UUID

Удаление заявки на вызов курьера (DELETE /v2/intakes/{uuid}). Заявку можно удалить в любом статусе, отличном от финального. Args: uuid: Intake request UUID

Получение дат вызова курьера для НП (POST /v2/intakes/availableDays). Возвращает доступные даты для забора груза курьером со склада. Args: city: City name (e.g. "Москва") date: До какого числа включительно получить дни (по умолчанию: сегодня + 2 недели)

Регистрация договоренности о доставке (POST /v2/delivery). Фиксирует оговоренные с клиентом дату и время доставки (приезда курьера), а также позволяет изменить адрес доставки. At least one of cdek_number or order_uuid must be provided. Args: date: Delivery date YYYY-MM-DD (согласованная с получателем) cdek_number: CDEK order number order_uuid: Order UUID (alternative to cdek_number) time_from: Delivery time from HH:MM (обязательно для "до двери") time_to: Delivery time to HH:MM (обязательно для "до двери") comment: Comment for delivery delivery_point: Delivery point code (обязательно для "до склада")

Получение информации о договоренности о доставке (GET /v2/delivery/{uuid}). Args: uuid: Delivery UUID

Получение интервалов доставки (GET /v2/delivery/intervals). Возвращает доступные даты и временные интервалы для регистрации договоренности о доставке по уже созданному заказу. At least one of cdek_number or order_uuid must be provided. Args: cdek_number: CDEK order number order_uuid: Order UUID

Получение интервалов доставки до создания заказа (POST /v2/delivery/estimatedIntervals). Позволяет получить доступные интервалы доставки "до двери" до создания заказа. Args: to_city: Recipient city name from_city: Sender city name (e.g. "Москва") tariff_code: CDEK tariff code (default 136) date_time: Date-time ISO format (планируемая дата отправки) shipment_point: Shipment point code (для тарифов "от склада")

Добавление подписки на вебхуки (POST /v2/webhooks). Типы: ORDER_STATUS, PRINT_FORM, PREALERT_CLOSED, ACCOMPANYING_WAYBILL, ORDER_CHANGED, DELIVERY_COST_CHANGED, DELIVERY_PROBLEM, DELIVERY_DATE_CHANGED, ORDER_MODE_CHANGED, COURIER_INFO. Args: type: Webhook type (e.g. ORDER_STATUS, PRINT_FORM) url: URL to receive webhook events

Получение информации о подписках на вебхуки (GET /v2/webhooks).

Получение информации о подписке по UUID (GET /v2/webhooks/{uuid}). Args: uuid: Webhook subscription UUID

Получение информации о паспортных данных (GET /v2/passport). Информация о готовности передавать заказы на таможню по международным заказам. Provide at least one of cdek_number, order_uuid, or client. Args: cdek_number: CDEK tracking number order_uuid: Order UUID client: Client filter (если не передано — и по отправителю, и по получателю)

Получение заказов с готовыми фото (POST /v2/photoDocument). Возвращает перечень заказов со ссылками на готовые к скачиванию архивы с фото. Требуется подключенная фотоуслуга и настроенный фотопроект. Provide at least one filter: date range (period_begin/period_end) or cdek_numbers. Args: period_begin: Start date (YYYY-MM-DD) period_end: End date (YYYY-MM-DD) cdek_numbers: Comma-separated CDEK numbers (e.g. "1234567890,9876543210")

Скачивание готового архива с фото (GET /v2/photoDocument/{uuid}). Скачивает архив с фото документов в zip-формате. Args: uuid: Photo document request UUID output_path: Absolute path to save the zip archive

Регистрация преалерта (POST /v2/prealert). Информирование СДЭК о намерении передать заказы на склад. Реестр заказов, которые клиент собирается передать. Args: planned_date: Planned date YYYY-MM-DD (планируемая дата передачи) shipment_point: Shipment point code (код ПВЗ для передачи, e.g. "MSK005") cdek_numbers: Comma-separated CDEK numbers

Получение информации о преалерте (GET /v2/prealert/{uuid}). Args: uuid: Prealert UUID

Проверка доступности реверса (POST /v2/reverse/availability). Проверяет доступность обратной доставки до создания прямого заказа. При доступности возвращается пустой ответ с кодом 200. Args: tariff_code: CDEK tariff code (e.g. 136) from_city: Sender city name to_city: Recipient city name shipment_point: Shipment point code (для тарифов "от склада") delivery_point: Delivery point code (для тарифов "до склада")

Получение информации о реестрах наложенных платежей (GET /v2/registries). Реестры НП, по которым клиенту был переведен наложенный платеж в заданную дату. Args: date: Date in YYYY-MM-DD format

Получение ограничений по международным заказам (POST /v2/international/package/restrictions). Ограничения по направлению и тарифу для международного заказа. Args: tariff_code: CDEK tariff code (0 to omit) from_city: Origin city name to_city: Destination city name