Royalmail Mcp

royalmail-mcp

Claude、Cursor、Windsurf など、MCP 対応の AI から Royal Mail と Parcelforce の配送を予約し、ラベルを取得して、追跡・キャンセルできます。

実際の Click & Drop API で検証済みです（2026 年 4 月）。予約、追跡、キャンセルはエンドツーエンドでテスト済みです。ラベルの取得は OBA アカウント向け仕様に基づいて検証済みです。

できること

MCP に対応するあらゆる AI に、6 つのツールを提供します。

ツール	機能
book_order	Click & Drop に注文を作成します。orderIdentifier を返します。
book_batch_and_label	複数の注文を一括で予約し、すべてのラベルをまとめた印刷可能な PDF を取得します。
get_label	郵便ラベルを PDF としてディスクに保存します。OBA アカウントが必要です（下記参照）。
track_order	現在のステータス、追跡番号、発送日を取得します。
cancel_order	顕在化前の注文をキャンセルします。料金は発生しません。
list_services	この MCP が対応する Royal Mail と Parcelforce のすべてのサービスとコードを一覧表示します。

内部では、Click & Drop API キーを使って https://api.parcel.royalmail.com/api/v1 に接続します。

プロンプトの例

MCP を AI クライアントにインストールすると、次のように依頼できます。

「Alex Taylor 宛てに、マンチェスターの 45 High Street、M1 1AA へ 80 グラムのファーストクラスの手紙を送る予約をしてください。参照番号は ORDER-1842 にしてください。」

「この 3 件の注文を Tracked 48 で発送し、orderIdentifier を教えてください。」（住所のリストを貼り付けます）

「この住所宛てに、補償額 £1,000 の Special Delivery by 1pm を予約してから、ラベルを取得してください。」

「注文 1004 をキャンセルしてください。お客様から間違った郵便番号が送られてきました。」

「500g の小包で、署名付きの最も安いサービスは何ですか？」（AI が list_services を呼び出して判断します）

「注文 1002、1003、1004 を追跡して、それぞれの状況を要約してください。」

「この 10 件の注文を Royal Mail Tracked 24 ですべて予約して、印刷できる PDF を 1 つ作成してください。」（AI が book_batch_and_label を呼び出し、統合 PDF のパスを返します）

AI が住所の解析、サービスの選択、エラーからの復旧を行います。ビジネス上の判断はお客様が行います。

ビジネス向けワークフローのアイデア

この MCP を任意の AI エージェントに連携すると、実際の配送業務を自動化できます。

• 毎日の注文処理。 毎朝、AI が Shopify、WooCommerce、またはスプレッドシートから新しい注文を読み込み、適切なサービスで Royal Mail の配送を予約し、追跡番号をお客様に送信します。
• カスタマーサービスの振り分け。 お客様から「荷物はどこですか？」というメールが届くと、AI が track_order を呼び出し、最新の状況をわかりやすい言葉で要約して返信文を作成します。
• 返品対応。 お客様から返品の依頼があった場合、AI が依頼内容を読み取り、適切な返品サービスを予約し、印刷可能なラベルをスタッフの作業なしでお客様にメール送信します。
• 複数配送業者の比較。 apc-mcp と併用すると、AI が予約時に Royal Mail と APC を比較し、配送先ごとに最も安い、または最も速い方法を選択します。
• 大量注文の一括処理。 セールや定期購入ボックスの発送時に、数百件の注文を含む CSV を AI に渡します。AI は適切なサービスと補償レベルで一括予約し、結果の概要を提示します。
• チェックアウト時の配送料見積もり。 お客様からチェックアウト時に配送料を尋ねられた場合、AI が重量と郵便番号に合ったサービスを選び、料金を計算して数秒で回答します。

互換性

stdio トランスポートに対応している MCP クライアントであれば、どれでも使用できます。

• Claude Desktop
• Cursor
• Windsurf
• Claude Code
• Zed

ChatGPT、Smithery など、リモート接続のみの MCP クライアントには HTTP トランスポートが必要ですが、現時点では含まれていません。必要な場合は、優先して対応できるよう issue を作成してください。

インストール

npm install -g royalmail-mcp

または、インストールせずに実行します。

npx royalmail-mcp

設定

Click & Drop → Settings → API credentials から API キーを取得し、次のように設定します。

RM_API_KEY=your-royal-mail-api-key
RM_BASE_URL=https://api.parcel.royalmail.com/api/v1

サーバーの隣にある .env ファイル、または MCP クライアントの設定（以下を参照）で設定してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

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

Cursor

~/.cursor/mcp.json に追加します。

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

対応サービス

キー	Royal Mail サービス	コード
first-class	1st Class	OLP1
first-class-signed	Signed For 1st Class	OLP1SF
second-class	2nd Class	OLP2
tracked-24	Tracked 24	TOLP24
tracked-48	Tracked 48	TOLP48
special-delivery-750	Special Delivery by 1pm (£750)	SD1OLP
special-delivery-1000	Special Delivery by 1pm (£1,000)	SD2OLP
special-delivery-2500	Special Delivery by 1pm (£2,500)	SD3OLP
parcelforce-24	Parcelforce express24	PFE24
parcelforce-48	Parcelforce express48	PFE48
international-tracked	International Tracked	ITROLP

署名付きサービス、年齢確認サービス、Parcelforce の国際サービスなど、ほかにも 22 種類あります。全リストを確認するには、list_services を実行してください。

わかりやすいキー（first-class）または Service Register のコード（OLP1）のどちらでも指定できます。どちらも使用できます。アカウントで利用できるサービスは、Click & Drop → Settings → Shipping services で有効になっているサービスによって異なります。

制限事項

ラベルの発行には OBA アカウントが必要です

get_label は、請求書払いのビジネスアカウントである Royal Mail Online Business Account（OBA） の利用者のみが使用できます。通常の従量課金制 Click & Drop アカウントで get_label を実行すると、403 Forbidden (Feature not available) が返されます。

注文の作成、追跡、キャンセルは、すべてのアカウントタイプで利用できます。OBA をお持ちでなくても、この MCP で注文の作成を自動化し、Click & Drop の UI から手動でラベルを印刷できます。

auth.parcel.royalmail.com/register/oba から OBA に登録できます。

OBA 利用者：auto-apply-postage を有効にしてください

OBA をご利用の場合は、Click & Drop → Settings で 「Apply postage automatically on orders imported via API」 にもチェックを入れてください。有効にしないと、注文は下書きのままになり、get_label は "Label generation only available for orders with postage applied status" を返します。

セキュリティ

API キーを使うと、Click & Drop アカウントに完全にアクセスできます。パスワードと同様に取り扱ってください。

• .env を git にコミットしないでください。このリポジトリの .gitignore では、すでに除外されています。
• チャットメッセージや共有ドキュメントにキーを貼り付けないでください。
• キーが漏えいした場合は、Click & Drop → Settings → API credentials で新しいキーに切り替えてください。

プライバシーとデータの取り扱い

この MCP はすべてお使いのマシン上で実行されます。顧客データ、認証情報、API 通信が、作者が所有または運営するサーバーを経由することはありません。

データの流れは次のとおりです。

• AI アシスタントに提供する配送情報は、お使いのアカウントを通じて AI プロバイダー（Claude を使用している場合は Anthropic など）に送信されます。
• 発送依頼は、API キーを使用して Royal Mail Click & Drop に送信されます。
• ラベルはローカルディスクの ~/Downloads/parcel-toolkit/ に保存されます（PARCEL_TOOLKIT_LABELS_DIR 環境変数で変更できます）。

英国の事業者としてこのツールを使用する場合、UK GDPR におけるデータ管理者はお客様です。実務上の推奨事項は次のとおりです。

1. Anthropic とのデータ処理契約を締結できるよう、一般向けの Claude.ai ではなく、Claude Team、Claude Enterprise、または Claude API を直接使用してください。一般向けプランでは、最低限、プライバシー設定で「Claude の改善に協力する」をオフにしてください。
2. 決済プロバイダーやメールサービスと同様に、プライバシーポリシーに Anthropic と Royal Mail を副処理者として記載してください。
3. 追加の法的確認なしに、特別カテゴリーのデータ（健康情報、生体情報、子どものデータ）にこのツールを使用することは避けてください。
4. このソフトウェアは MIT ライセンスのもと、現状有姿で提供されます。作者はデータ処理者ではなく、お客様のコンプライアンス上の義務について一切責任を負いません。それらの義務はデータ管理者であるお客様が負います。

貢献

github.com/catrinmdonnelly/royalmail-mcp で、Issue やプルリクエストを歓迎します。Royal Mail が API を変更した場合や、お使いのアカウントの種類に固有の問題が発生した場合は、送信したリクエスト本文と受け取ったレスポンスを添えて Issue を作成してください（先に API キーを削除してください）。

関連する MCP

APC Overnight については、apc-mcp をご覧ください。

免責事項

このプロジェクトは Royal Mail Group Ltd. と提携、承認、または後援されていません。「Royal Mail」、「Parcelforce」、「Click & Drop」は、それぞれの所有者の商標です。ご自身の責任でご使用ください。

ライセンス

MIT。LICENSE をご覧ください。