Каталог MCP
catrinmdonnelly/royalmail-mcp

catrinmdonnelly/royalmail-mcp

Name: catrinmdonnelly/royalmail-mcp
Availability: InStock
Author: catrinmdonnelly

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

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

README

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

Версии

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

royalmail-mcp

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

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

book_batch_and_label

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

Параметры

despatchDatestring
Планируемая дата отгрузки в формате YYYY-MM-DD. Не указывайте, если аккаунт не допускает заказы с будущей датой.
packageFormatenum
Формат упаковки для каждого заказа в партии.
senderobject
Адрес отправителя. Опустите, чтобы использовать адрес, сохранённый в вашем аккаунте Click & Drop.
servicestringобязательный
Услуга Royal Mail для каждого заказа в этой партии (например, "tracked-24", "tracked-48", "first-class", "special-delivery-1000"). Вызовите list_services для полного каталога.
shipmentsobject[]обязательный
Массив заказов для оформления. Каждая запись содержит один заказ со своим получателем, весом и ссылкой.

book_order

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

Параметры

despatchDatestring
Плановая дата отгрузки YYYY-MM-DD. Опустите это поле, если ваш аккаунт не позволяет оформлять заказы с будущей датой.
dimensionsobject
Размеры упаковки в мм (необязательно)
goodsDescriptionstring
Краткое описание содержимого.
notifyEmailstring
Адрес электронной почты для уведомлений о доставке
notifyPhonestring
Номер мобильного телефона для уведомлений о доставке SMS.
packageFormatenum
Формат пакета. Определяет доступные сервисы и цены.
recipientobjectобязательный
Получатель / адрес доставки
referencestring
Ваш внутренний номер заказа или код задания
requireSignatureboolean
Запрашивает подпись при доставке.
safePlacestring
Инструкции по безопасному месту, например «оставить на крыльце».
senderobject
Адрес отправителя. Опустите, чтобы использовать адрес, сохранённый в вашем аккаунте Click & Drop.
serviceenumобязательный
Сервис Royal Mail / Parcelforce. Если не указано, по умолчанию используется first-class (OLP1). Также принимаются коды Service Register в исходном виде (например, OLP1, TOLP24, PFE48).
shippingCostnumber
Стоимость доставки оплачивает получатель в фунтах стерлингов.
specialInstructionsstring
Особые инструкции по обращению
subtotalnumber
Промежуточный итог заказа в GBP (используется для таможни/страховки)
totalnumber
Сумма заказа в GBP
weightGramsnumberобязательный
Общий вес в граммах (например, 500 для 500 г)

cancel_order

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

Параметры

orderIdentifierstringобязательный
Идентификатор заказа (orderIdentifier) для отмены

get_label

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

Параметры

orderIdentifierstringобязательный
Идентификатор orderIdentifier, возвращаемый при бронировании заказа (или из ранее забронированного заказа).

list_services

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

Параметры

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

track_order

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

Параметры

orderIdentifierstringобязательный
orderIdentifier, возвращаемый при бронировании заказа

`0.2.0`основная	24.04.2026
`0.1.0`	22.04.2026

Выберите клиент, чтобы установить catrinmdonnelly/royalmail-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"catrinmdonnelly-royalmail-mcp-set4ag208p\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"royalmail-mcp\"],\"env\":{\"RM_API_KEY\":\"your-royal-mail-api-key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add catrinmdonnelly-royalmail-mcp-set4ag208p --env RM_API_KEY=your-royal-mail-api-key -- npx -y royalmail-mcp

Либо через JSON-конфиг:

claude mcp add-json catrinmdonnelly-royalmail-mcp-set4ag208p "{\"command\":\"npx\",\"args\":[\"-y\",\"royalmail-mcp\"],\"env\":{\"RM_API_KEY\":\"your-royal-mail-api-key\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add catrinmdonnelly-royalmail-mcp-set4ag208p --env RM_API_KEY=your-royal-mail-api-key -- npx -y royalmail-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.catrinmdonnelly-royalmail-mcp-set4ag208p]
command = "npx"
args = ["-y", "royalmail-mcp"]

[mcp_servers.catrinmdonnelly-royalmail-mcp-set4ag208p.env]
RM_API_KEY = "your-royal-mail-api-key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите catrinmdonnelly/royalmail-mcp, а в поле команды запуска — строку ниже:

npx -y royalmail-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например catrinmdonnelly-royalmail-mcp-set4ag208p.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: catrinmdonnelly-royalmail-mcp-set4ag208p
    command: npx
    args:
      - "-y"
      - "royalmail-mcp"
    env:
      RM_API_KEY: your-royal-mail-api-key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "catrinmdonnelly-royalmail-mcp-set4ag208p": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "your-royal-mail-api-key"
      }
    }
  }
}

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

{
  "command": "npx",
  "args": [
    "-y",
    "royalmail-mcp"
  ],
  "env": {
    "RM_API_KEY": "your-royal-mail-api-key"
  }
}

Нужен npx

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

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

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

Номер в рейтинге: #197
Звезд на Github: 3
Форков на Github: 0
Загрузок: 647
Язык реализации: JavaScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 21.10 в 04:06
Идентификатор: EdwK624d4BWzQRHs
Категории: E-commerce, Путешествия и транспорт

catrinmdonnelly/royalmail-mcp

royalmail-mcp

What it does

Example prompts

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

СДЭК MCP

aarsiv-groups/shipi-mcp-server

roamzy-io/mcp-server

skedgo/tripgo-mcp-server

patchistry/patchistry-mcp-server

forgemeshlabs/travel-mcp