Каталог MCP
СДЭК MCP

СДЭК MCP

Name: СДЭК MCP
Availability: InStock
Author: theyahia

MCP сервер для работы с API СДЭК: 16 инструментов для расчета тарифов, управления заказами и отслеживания отправлений. Автоматизирует логистику в AI-ассистентах - от стоимости доставки до вызова курьера и печати квитанций.

README

16 инструментов

Версии

Установить сервер

cdek-mcp

MCP server for the CDEK delivery API (v2). 16 tools covering the full delivery lifecycle: tariff calculation, order management, shipment tracking, location search, courier pickup, barcode/receipt generation, and webhooks.

Tools (16)

Tariffs

Tool	Description
`calculate_tariff`	Calculate delivery cost and time for a specific tariff
`calculate_tariff_list`	Get all available tariffs with prices for a route

Orders

Tool	Description
`create_order`	Create a delivery order with sender, recipient, packages
`get_order`	Get order details and status by UUID
`delete_order`	Cancel/delete an order by UUID
`list_orders`	Search/filter orders by date range, IM number, or CDEK waybill

Tracking

Tool	Description
`track_shipment`	Track shipment by CDEK waybill number

Locations

Tool	Description
`get_cities`	Search city directory by name, postal code, or country
`get_regions`	Search region directory by country or name
`list_delivery_points`	Find pickup points and parcel lockers by city or GPS coordinates

Barcode & Print

Tool	Description
`generate_barcode`	Generate barcode/label for an order
`print_receipt`	Generate receipt/waybill PDF for an order

Инструменты были проиндексированы: 09.09.2026

calculate_tariff

Рассчитывает стоимость и сроки доставки СДЭК по конкретному тарифу, маршруту и параметрам груза. Используется для предварительной оценки перед созданием заказа. Требует код тарифа (136=склад-склад, 137=склад-дверь, 138=дверь-склад, 139=дверь-дверь). Для поиска кода города используется get_cities.

Параметры

from_locationobjectобязательный
Место отправления (code или postal_code обязательно)
packagesobject[]обязательный
Список мест (минимум 1)
tariff_codenumberобязательный
Код тарифа СДЭК (например 136=посылка склад-склад, 137=склад-дверь, 138=дверь-склад, 139=дверь-дверь)
to_locationobjectобязательный
Место назначения (code или postal_code обязательно)

calculate_tariff_list

Рассчитывает стоимость доставки СДЭК по всем доступным тарифам для маршрута. Используйте, когда нужно показать клиенту все варианты доставки с ценами и сроками, не зная заранее код тарифа.

Параметры

from_locationobjectобязательный
Место отправления (code или postal_code обязательно)
packagesobject[]обязательный
Список мест (минимум 1)
to_locationobjectобязательный
Место назначения (code или postal_code обязательно)

create_courier_pickup

Создаёт заявку на вызов курьера СДЭК для забора отправления. Требует UUID заказа и временной интервал. После создания можно отслеживать статус заявки через get_courier_pickup.

Параметры

commentstring
Комментарий для курьера
intake_datestringобязательный
Дата забора (YYYY-MM-DD)
intake_time_fromstringобязательный
Время забора с (HH:MM)
intake_time_tostringобязательный
Время забора до (HH:MM)
namestring
ФИО отправителя
order_uuidstringобязательный
UUID заказа для вызова курьера
phonestring
Телефон отправителя

create_order

Создает заказ на доставку СДЭК с указанием отправителя, получателя и мест. Перед созданием рекомендуется рассчитать стоимость через calculate_tariff. После создания заказ можно отслеживать через get_order или track_shipment.

Параметры

commentstring
Комментарий к заказу
from_locationobjectобязательный
Место отправления
packagesobject[]обязательный
Список мест
recipientobjectобязательный
Данные получателя
tariff_codenumberобязательный
Код тарифа СДЭК
to_locationobjectобязательный
Место назначения

create_webhook

Подписка на вебхуки СДЭК для получения уведомлений о смене статуса заказов (ORDER_STATUS) или готовности фото (DOWNLOAD_PHOTO). СДЭК будет отправлять POST-запросы на указанный HTTPS URL.

Параметры

typeenumобязательный
Тип вебхука: ORDER_STATUS (статусы заказов) или DOWNLOAD_PHOTO
urlstringобязательный
URL для получения уведомлений (HTTPS)

delete_order

Удаляет заказ СДЭК по UUID. Действует только для заказов, ещё не переданных в курьерскую службу. После удаления заказ нельзя восстановить.

Параметры

uuidstringобязательный
UUID заказа СДЭК для удаления

delete_webhook

Удаляет подписку на вебхуки СДЭК по UUID вебхука. Используется для отключения уведомлений или смены URL получателя (удалить старый и создать новый).

Параметры

uuidstringобязательный
UUID вебхука для удаления

generate_barcode

Генерирует штрихкод (этикетку) для заказа СДЭК по UUID. Поддерживает форматы A4, A5, A6 и до 10 копий. Ссылка на PDF появится в результатах get_order.

Параметры

copy_countinteger
Количество копий (1-10, по умолчанию 1)
formatenum
Формат печати (A4, A5, A6)
uuidstringобязательный
UUID заказа СДЭК для генерации штрихкода

get_cities

Поиск городов в справочнике СДЭК по названию, индексу или стране. Возвращает код города, регион и ФИАС. Используйте для получения city_code перед вызовом calculate_tariff или create_order.

Параметры

citystring
Название города (поиск по подстроке)
country_codesstring
Коды стран через запятую (например RU,KZ)
pageinteger
Номер страницы (с 0)
postal_codestring
Почтовый индекс
sizeinteger
Количество результатов (по умолчанию 50)

get_courier_pickup

Получает статус заявки на вызов курьера СДЭК по UUID заявки. Возвращает дату, время и историю статусов заявки.

Параметры

uuidstringобязательный
UUID заявки на вызов курьера

get_order

Получает полную информацию о заказе СДЭК по UUID. Возвращает статусы, номер накладной и детали доставки. Используется после create_order для проверки обработки заказа.

Параметры

uuidstringобязательный
UUID заказа СДЭК

get_regions

Получает справочник регионов СДЭК. Поддерживает фильтрацию по стране и названию региона, пагинацию. Используйте для построения иерархии локаций или фильтрации городов по региону.

Параметры

country_codesstring
Коды стран через запятую (например RU,KZ)
pageinteger
Номер страницы (с 0)
regionstring
Название региона (поиск по подстроке)
sizeinteger
Количество результатов

list_delivery_points

Ищет пункты выдачи (ПВЗ) и постаматы СДЭК по городу, индексу или GPS-координатам. При указании latitude+longitude+radius_km фильтрует и сортирует пункты по расстоянию. Возвращает адрес, время работы, наличие примерочной и способы оплаты.

Параметры

city_codenumber
Код города СДЭК
country_codestring
Код страны (по умолчанию RU)
latitudenumber
Широта точки отсчёта для гео-поиска (нужны также longitude и radius_km)
longitudenumber
Долгота точки отсчёта для гео-поиска (нужны также latitude и radius_km)
pageinteger
Номер страницы (с 0)
postal_codestring
Почтовый индекс
radius_kmnumber
Радиус поиска в км от (latitude, longitude). Фильтрация и сортировка по расстоянию на стороне клиента
sizeinteger
Количество результатов
typeenum
Тип пункта: PVZ (пункт выдачи), POSTAMAT (постамат), ALL

list_orders

Ищет и фильтрует заказы СДЭК по дате, номеру ИМ или накладной СДЭК. Поддерживает пагинацию. Используйте для получения списка заказов за период или поиска конкретного заказа.

Параметры

cdek_numberstring
Накладная СДЭК
date_invoice_fromstring
Дата начала периода (формат YYYY-MM-DDTHH:MM:SS±HH:MM)
date_invoice_tostring
Дата окончания периода
im_numberstring
Номер заказа интернет-магазина
pagenumber
Страница (0-based)
sizenumber
Кол-во записей (макс. 1000)

print_receipt

Печатает квитанцию (накладную) для заказа СДЭК в формате PDF. Опрашивает API до готовности файла (до 10 секунд) и возвращает ссылку для скачивания.

Параметры

copy_countinteger
Количество копий (1-10)
order_uuidstringобязательный
UUID заказа для печати квитанции

track_shipment

Отслеживает отправление СДЭК по номеру накладной (cdek_number). Возвращает полную историю статусов с датами и городами. Если известен только UUID заказа, используйте get_order.

Параметры

cdek_numberstringобязательный
Номер отправления СДЭК (например 1234567890)

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@theyahia/cdek-mcp"
  ],
  "env": {
    "CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
    "CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
    "CDEK_SANDBOX": "true"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 1
Форков на Github: 0
Загрузок: 2 083
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 03:35
Идентификатор: VPClXGzABvHTPHoi
Категории: E-commerce, Автоматизация приложений, Геолокационные сервисы, Инструменты для разработчиков, Путешествия и транспорт, 🇷🇺 Российские сервисы