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).

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

Параметры

  • 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.

  • packageFormatenum

    Package format for every order in the batch.

    letterlarge-lettersmall-parcelmedium-parcelparcel
  • senderobject

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

  • despatchDatestring

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

  • 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 для получения этикетки.

Оформите отправку Royal Mail через Click & Drop. Возвращает orderIdentifier для получения этикетки.

Параметры

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

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

    first-classfirst-class-signedsecond-classsecond-class-signedtracked-24tracked-24-signedtracked-24-agetracked-48tracked-48-signedtracked-48-agespecial-delivery-750special-delivery-1000special-delivery-2500parcelforce-10parcelforce-10-signedparcelforce-24parcelforce-24-signedparcelforce-48parcelforce-48-signedparcelforce-amparcelforce-am-signedparcelforce-48-largeparcelforce-48-large-signedparcelforce-irelandparcelforce-global-expressparcelforce-priority-europeparcelforce-priority-rowinternational-economyinternational-standardinternational-trackedinternational-tracked-heavierinternational-tracked-heavier-compinternational-tracked-signed
  • packageFormatenum

    Package format. Determines which services are available and pricing

    letterlarge-lettersmall-parcelmedium-parcelparcel
  • weightGramsnumberобязательный

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

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

    Recipient / delivery address

  • senderobject

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

  • referencestring

    Your internal order or job reference

  • subtotalnumber

    Order subtotal in GBP (used for customs/insurance)

  • shippingCostnumber

    Shipping cost charged to recipient in GBP

  • totalnumber

    Order total in GBP

  • despatchDatestring

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

  • requireSignatureboolean

    Request signature on delivery

  • safePlacestring

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

  • notifyEmailstring

    Email address for delivery notifications

  • notifyPhonestring

    Mobile number for SMS delivery notifications

  • dimensionsobject

    Package dimensions in mm (optional)

  • goodsDescriptionstring

    Brief description of contents

  • specialInstructionsstring

    Special handling instructions

cancel_order

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

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

Параметры

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

    The orderIdentifier to cancel

get_label

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

Получить почтовую наклейку для заказа 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.

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

Параметры

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

track_order

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

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

Параметры

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

    The orderIdentifier returned when booking the order

Другие проверенные MCP-сервера

blockrunai/blockrun-mcp

blockrunai/blockrun-mcp

официальный

BlockRun MCP — сервер реал-тайм данных для Claude: рынки, исследования, X/Twitter и крипто без API ключей. Оплата за вызов из USDC-кошелька, подходит трейдерам и аналитикам.

TypeScript475
posthog/mcp

posthog/mcp

официальный

MCP сервер для интеграции с PostHog — платформой продуктовой аналитики. Позволяет запрашивать данные о событиях, сессиях и пользователях через ИИ-ассистентов (Claude, Cursor, VS Code). Полезен продакт-менеджерам и разработчикам для быстрого анализа.

TypeScript151
MarkusPfundstein/mcp-obsidian

MarkusPfundstein/mcp-obsidian

MCP сервер для Obsidian через плагин Local REST API даёт инструменты для работы с хранилищем: чтение, поиск и изменение файлов. Идеально для интеграции заметок с AI-помощниками и автоматизации.

Python4102
mendableai/firecrawl-mcp-server

mendableai/firecrawl-mcp-server

Firecrawl MCP сервер для AI-агентов, которым нужен чистый контекст из живого веба. Ищет информацию, скрапит страницы в структурированные данные, кликает и навигирует. Работает с облаком и сам хостингом, поддерживает автоматические ретраи. Полезен разработчикам для исследований и автоматизации сбо...

JavaScript6988
ahujasid/blender-mcp

ahujasid/blender-mcp

BlenderMCP подключает Claude AI к Blender через Model Context Protocol, позволяя управлять 3D-сценами голосом или текстом. Создавайте, редактируйте объекты, применяйте материалы и выполняйте Python...

Python24437
can4hou6joeng4/boss-agent-cli

can4hou6joeng4/boss-agent-cli

BOSS Agent CLI — 为 AI Agent 设计的 BOSS 直聘本地辅助工具。支持职位搜索、福利筛选(双休、五险一金等)、候选池管理,输出 JSON 信封。默认低风险只读模式,合规安全,适合求职者与招聘者。

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

Лука Никитин