royalmail-mcp

Claude、Cursor、WindsurfなどのMCP互換AIから、Royal MailおよびParcelforceの配送予約、ラベル発行、追跡、キャンセルを行います。

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

機能

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

内部的には、Click & Drop APIキーを使用して https://api.parcel.royalmail.com/api/v1 と通信します。

Related MCP server: UK Property Intelligence

プロンプト例

AIクライアントにMCPをインストールすると、以下のような指示が可能になります：

「Alex Taylor（住所：45 High Street, Manchester M1 1AA、重量：80g）宛てに1st Classの郵便物を予約して。参照番号はORDER-1842にして。」

「これら3つの注文をTracked 48で発送して、orderIdentifierを教えて。」 （住所リストを貼り付け）

「Special Delivery by 1pm（補償額£1,000）でこの住所に予約して、ラベルを取得して。」

「注文1004をキャンセルして。顧客が郵便番号を間違えたため。」

「500gの小包に最適な、署名が必要な最安のサービスは何？」 （AIが list_services を呼び出して判断）

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

「ここに10件の注文がある。すべてRoyal Mail Tracked 24で予約して、印刷用のPDFを1つ作成して。」 （AIが book_batch_and_label を呼び出し、結合されたPDFのパスを返す）

AIが住所の解析、サービスの選択、エラー復旧を処理します。ビジネス上の判断はユーザーが行います。

ビジネス向けのワークフロー案

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"
      }
    }
  }
}

サポートされているサービス

その他、署名付きバリエーション、年齢確認サービス、Parcelforce国際便など22種類以上に対応しています。全リストは list_services を実行してください。

フレンドリーキー（first-class）または生のサービスレジスターコード（OLP1）のどちらでも指定可能です。どちらも機能します。アカウントで使用可能なサービスは、Click & Dropの「Settings → Shipping services」で有効になっているものに依存します。

制限事項

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

get_label は、Royal Mailの Online Business Account (OBA)（請求書払いビジネスアカウント）を持つ顧客のみ利用可能です。標準の都度払い（Pay-as-you-go）Click & Dropアカウントでは、get_label で 403 Forbidden (Feature not available) が返されます。

予約、追跡、キャンセルはすべてのアカウントタイプで動作します。OBAをお持ちでない場合でも、このMCPを通じて注文作成を自動化し、Click & DropのUIで手動でラベルを印刷することは可能です。

OBAへの登録は auth.parcel.royalmail.com/register/oba から行ってください。

OBAユーザー：自動送料適用を有効にする

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 で変更可能）。

英国のビジネスでこれを使用する場合、ユーザーは英国GDPRに基づくデータ管理者となります。実務上の推奨事項：

1. コンシューマー向けのClaude.aiではなく、Claude Team、Claude Enterprise、またはClaude APIを直接使用し、Anthropicとのデータ処理契約（DPA）が締結されている状態にしてください。コンシューマー向けプランの場合は、少なくともプライバシー設定で「Help improve Claude」をオフにしてください。

2. プライバシーポリシーにおいて、決済プロバイダーやメールサービスと同様に、AnthropicとRoyal Mailをサブプロセッサーとして記載してください。

3. 法的レビューなしに、特別なカテゴリのデータ（健康、生体認証、子供のデータ）にこのツールを使用することは避けてください。

4. 本ソフトウェアはMITライセンスの下で現状のまま提供されます。作者はデータ処理者ではなく、ユーザーのコンプライアンス義務について一切の責任を負いません。これらはデータ管理者であるユーザーの責任となります。

貢献

Issueやプルリクエストは github.com/catrinmdonnelly/royalmail-mcp で歓迎します。Royal MailがAPIを変更した場合や、アカウントタイプ特有のエッジケースに遭遇した場合は、送信したリクエストボディと受信したレスポンス（APIキーは削除してください）を添えてIssueを作成してください。

関連MCP

APC Overnightについては apc-mcp を参照してください。

免責事項

本プロジェクトはRoyal Mail Group Ltd.と提携、推奨、後援されていません。「Royal Mail」、「Parcelforce」、「Click & Drop」は各所有者の商標です。自己責任で使用してください。

ライセンス

MIT。 LICENSE を参照してください。