catrinmdonnelly/royalmail-mcp

catrinmdonnelly/royalmail-mcp

от catrinmdonnelly
MCP сервер для управления отправлениями Royal Mail и Parcelforce: бронирование, отслеживание, отмена заказов и печать этикеток через Click & Drop API. Автоматизируйте доставку прямо из ИИ-ассистентов.

royalmail-mcp

npm version licence node CI

Book, label, track and cancel Royal Mail and Parcelforce shipments from any MCP-compatible AI such as Claude, Cursor, or Windsurf.

Verified against the live Click & Drop API (April 2026). Booking, tracking and cancellation tested end-to-end. Label retrieval verified against the spec for OBA accounts.

What it does

Exposes six tools to any AI that speaks MCP:

Tool What it does
book_order Create an order in Click & Drop. Returns an orderIdentifier.
book_batch_and_label Book many orders at once and get back a single merged PDF of every label, ready to print.
get_label Save the postage label to disk as a PDF. Requires an OBA account (see below).
track_order Current status, tracking number and despatch date.
cancel_order Cancel an order before it's manifested. No charge is applied.
list_services Every Royal Mail and Parcelforce service this MCP supports, with codes.

Under the hood it talks to https://api.parcel.royalmail.com/api/v1 using your Click & Drop API key.

Example prompts

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

Оформляет несколько заказов Royal Mail за один раз и возвращает единый объединённый PDF-файл со всеми этикетками, готовый к печати. Используйте это, когда пользователь вставляет список заказов или адресов. Все заказы используют одинаковый тип услуги, формат посылки и отправителя. Сохраняет объединённый PDF в ~/Downloads/parcel-toolkit/ (путь можно переопределить через PARCEL_TOOLKIT_LABELS_DIR).

Параметры
  • despatchDatestring

    Planned despatch date YYYY-MM-DD. Omit if the account does not allow future-dated orders.

  • packageFormatenum

    Package format for every order in the batch.

  • senderobject

    Sender address. Omit to use the address saved in your Click & Drop account.

  • servicestringобязательный

    Royal Mail service for every order in this batch (e.g. "tracked-24", "tracked-48", "first-class", "special-delivery-1000"). Call list_services for full catalogue.

  • shipmentsobject[]обязательный

    Array of orders to book. Each entry is one order with its own recipient, weight and reference.

book_order

Бронирует отправление Royal Mail через Click & Drop. Возвращает orderIdentifier, используемый для получения этикетки.

Параметры
  • despatchDatestring

    Planned despatch date YYYY-MM-DD. Omit if your account does not allow future-dated orders

  • dimensionsobject

    Package dimensions in mm (optional)

  • goodsDescriptionstring

    Brief description of contents

  • notifyEmailstring

    Email address for delivery notifications

  • notifyPhonestring

    Mobile number for SMS delivery notifications

  • packageFormatenum

    Package format. Determines which services are available and pricing

  • recipientobjectобязательный

    Recipient / delivery address

  • referencestring

    Your internal order or job reference

  • requireSignatureboolean

    Request signature on delivery

  • safePlacestring

    Safe place instructions e.g. "leave in porch"

  • senderobject

    Sender address. Omit to use the address saved in your Click & Drop account

  • serviceenumобязательный

    Royal Mail / Parcelforce service. Defaults to first-class (OLP1) if omitted. Raw Service Register codes (e.g. OLP1, TOLP24, PFE48) are also accepted.

  • shippingCostnumber

    Shipping cost charged to recipient in GBP

  • specialInstructionsstring

    Special handling instructions

  • subtotalnumber

    Order subtotal in GBP (used for customs/insurance)

  • totalnumber

    Order total in GBP

  • weightGramsnumberобязательный

    Total weight in grams (e.g. 500 for 500g)

cancel_order

Отменить заказ Royal Mail Click & Drop. Нужно сделать до того, как заказ будет сформирован или отправлен.

Параметры
  • orderIdentifierstringобязательный

    The orderIdentifier to cancel

get_label

Получить почтовую наклейку для заказа Royal Mail Click & Drop и сохранить на диск. Работает для любого заказа, который вы ранее оформили, передайте его orderIdentifier. Место сохранения по умолчанию: ~/Downloads/parcel-toolkit/, можно переопределить через переменную окружения PARCEL_TOOLKIT_LABELS_DIR.

Параметры
  • orderIdentifierstringобязательный

    The orderIdentifier returned when booking the order (or from a previously booked order).

list_services

Выводит список поддерживаемых служб Royal Mail и Parcelforce с их кодами Service Register. Доступность зависит от вашего аккаунта Click & Drop.

Параметры

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

track_order

Получить текущий статус и детали отслеживания для заказа Royal Mail Click & Drop.

Параметры
  • orderIdentifierstringобязательный

    The orderIdentifier returned when booking the order

Похожие MCP-сервера

СДЭК MCP

СДЭК MCP

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

TypeScript1
aarsiv-groups/shipi-mcp-server

aarsiv-groups/shipi-mcp-server

Shipi MCP сервер для управления доставкой через диалог с ИИ. Сравнивайте тарифы, создавайте отправления и отслеживайте грузы. Работает с FedEx, UPS, USPS и десятками других перевозчиков. Автоматизируйте логистику в Claude Desktop.

JavaScript1
skedgo/tripgo-mcp-server

skedgo/tripgo-mcp-server

MCP-сервер для интеграции с API TripGo: поиск транспортных локаций, отправлений и мультимодальное построение маршрутов. Полезен разработчикам ИИ-агентов для планирования поездок и анализа транспорта.

TypeScript5
forgemeshlabs/travel-mcp

forgemeshlabs/travel-mcp

MCP сервер для планирования путешествий без API-ключа: поиск аэропортов по коду IATA, сравнение маршрутов, подсказки по срокам вылета и сезонам, генерация внешних ссылок на бронирование. Полезен разработчикам и пользователям ИИ-агентов для быстрой оценки рейсов.

TypeScript1
pepabo/colormeshop-mcp

pepabo/colormeshop-mcp

MCP-сервер для японской e-commerce платформы Color Me Shop. Управляйте заказами, товарами, клиентами и купонами через естественный язык — просто опишите задачу ИИ (Claude, Cursor). Бесплатно для вс...

JavaScript1
mrslbt/rakuten-mcp

mrslbt/rakuten-mcp

MCP-сервер для Rakuten Web Service API: 28 read-only инструментов для поиска товаров, книг и путешествий. Полезен разработчикам, интегрирующим ИИ-ассистентов с японскими маркетплейсами.

TypeScript5
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин