Royalmail Mcp

Name: Royalmail Mcp
Author: catrinmdonnelly

@catrinmdonnelly

Royalmail Mcp について

Connect any MCP-compatible AI to Royal Mail and Parcelforce shipping. This server exposes five tools that let Claude, Cursor or any MCP client book orders, fetch postage labels, track shipments and cancel bookings through the official Click & Drop API.

#royal-mail #parcelforce #shipping #uk #click-and-drop #ecommerce #logistics #fulfillment #parcel #courier #mcp #nodejs #tracking #labels #postage #api-integration

基本情報

カテゴリ

開発者ツール

トランスポート

stdio

公開者

catrinmdonnelly

投稿者

C Donnelly

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

Book a Royal Mail shipment via Click & Drop. Returns an orderIdentifier used to retrieve the label.

Get the shipping label for a Royal Mail Click & Drop order and save it to disk. Works for any order you have previously booked — pass its orderIdentifier. Default save location is ~/Downloads/parcel-toolkit/, overridable via the PARCEL_TOOLKIT_LABELS_DIR env var.

Book multiple Royal Mail orders at once and return a single merged PDF containing every label, ready to print. Use this when the user pastes a list of orders/addresses. All orders share the same service, package format and sender. Saves the merged PDF to ~/Downloads/parcel-toolkit/ (overridable via PARCEL_TOOLKIT_LABELS_DIR).

Get the current status and tracking details for a Royal Mail Click & Drop order.

Cancel a Royal Mail Click & Drop order. Must be done before the order is manifested/despatched.

List supported Royal Mail and Parcelforce services with their Service Register codes. Availability depends on your Click & Drop account.

概要

What is Royalmail Mcp?

Royalmail Mcp is a Model Context Protocol server that enables AI assistants to book, label, track, and cancel Royal Mail and Parcelforce shipments via the Click & Drop API. It is designed for businesses and developers using MCP-compatible AI clients like Claude, Cursor, or Windsurf.

How to use Royalmail Mcp?

Install globally with npm install -g royalmail-mcp or run directly with npx royalmail-mcp. Set the environment variables RM_API_KEY (your Click & Drop API key) and RM_BASE_URL (default https://api.parcel.royalmail.com/api/v1) in a .env file or your MCP client’s configuration. Add the server to your MCP client config (e.g., Claude Desktop or Cursor) as shown in the README, then ask the AI to book, track, or cancel shipments.

Key features of Royalmail Mcp

Five tools: book_order, get_label, track_order, cancel_order, and list_services
Supports Royal Mail and Parcelforce services, including tracked, signed, and international options
Labels returned as base64-encoded PDF (requires an OBA account)
Order cancellation available before manifestation (no charge)
Works with any MCP client that supports stdio transport

Use cases of Royalmail Mcp

Automate daily order fulfilment by booking shipments and posting tracking numbers back to customers
Triage customer service inquiries: track orders and draft replies in plain English
Handle returns by booking return services and emailing printable labels without staff involvement
Compare multiple carriers (e.g., with apc-mcp) to pick the cheapest or fastest option per destination
Bulk fulfil large order lists from CSVs during sale events or subscription-box drops

FAQ from Royalmail Mcp

Do I need an OBA account to use all features?

No. Booking, tracking, and cancelling work on all Click & Drop account types. The get_label tool requires a Royal Mail Online Business Account (OBA); standard pay-as-you-go accounts will get a 403 error.

What API key do I need?

You need a Click & Drop API key, obtained from Click & Drop → Settings → API credentials. That key grants full access to your account.

Does this work with ChatGPT or Smithery?

No, not yet. ChatGPT, Smithery, and other remote-only MCP clients require HTTP transport, which is not included. Only stdio-based MCP clients (Claude Desktop, Cursor, Windsurf, Claude Code, Zed) are supported.

Can I use friendly service names instead of codes?

Yes. You can pass either the friendly key (e.g., first-class) or the raw Service Register code (e.g., OLP1) when using book_order. Both work.

Is this project affiliated with Royal Mail?

No. This project is not affiliated with, endorsed by, or sponsored by Royal Mail Group Ltd. “Royal Mail”, “Parcelforce”, and “Click & Drop” are trademarks of their respective owners.

「開発者ツール」の他のコンテンツ

Golf

golf-mcp

Production-Ready MCP Server Framework • Build, deploy & scale secure AI agent infrastructure • Includes Auth, Observability, Debugger, Telemetry & Runtime • Run real-world MCPs powering AI Agents

834