Royalmail Mcp
@catrinmdonnelly
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.
Overview
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, andlist_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.
