# UK Postbox MCP > UK Postbox MCP Server manages your virtual UK mailbox, letting you handle physical mail from anywhere. You can list all incoming letters and parcels, scan documents instantly, forward packages to any saved address, or send out physical correspondence using your AI agent. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** virtual-mailbox, mail-forwarding, digitization, parcel-tracking, remote-office, scanning ## Description You're gonna connect your AI client to the UK Postbox MCP Server so you can manage physical mail—letters and parcels—right from wherever you are. It lets your agent handle everything that comes through your virtual UK mailbox, whether it’s scanning a document or sending out new correspondence. First off, you gotta confirm the connection is good before you do anything else. You use `check_ukpostbox_status` to verify that the service link to UK Postbox is active and working for your agent's tools. When mail arrives, you first need a full picture of what’s waiting. Calling `list_mail_items` generates an exhaustive list of every single envelope or letter sitting in your virtual postbox. If you need the deep details on just one piece, use `get_mail_item`. For parcels—the big boxes—you call `list_parcels` to see a rundown of everything waiting for pickup or forwarding. To get specific measurements and weight for any single box, you run `get_parcel`. If the physical mail needs turning into digital files, here’s how it works. You start by telling the system what you want scanned using `request_scan`, which initiates the scan job on a selected item. Once that process is complete, you retrieve the digital file itself with `get_mail_scan`. This lets your agent read and work with letters that were physical when they arrived. Got mail that needs to move? You use `list_addresses` to pull up every forwarding address you've saved in your account. Then, if you want to route existing letters or envelopes to a new location, you call `forward_mail`, which moves the item and gives you tracking info for the whole transfer. If you need to send out your own correspondence, it’s simple. You use `send_letter` by giving it the full address details and the content of the letter; the tool then queues up a physical letter shipment through Royal Mail. It's that straightforward. Your agent can check the service status using `check_ukpostbox_status`; you can see every item waiting with `list_mail_items` or get deep data on one piece via `get_mail_item`. You can turn a physical letter into a digital file by first running `request_scan`, then pulling it back with `get_mail_scan`. To move mail, retrieve your saved destinations using `list_addresses` before you execute the transfer with `forward_mail`. If you're dealing with packages, get the rundown with `list_parcels`, and check dimensions or weight on one box using `get_parcel`. Finally, sending out a new physical note only takes calling `send_letter` with the necessary details. You don't need to know any jargon; your agent handles it all. ## Tools ### check_ukpostbox_status Verifies that the UK Postbox service connection is active. ### forward_mail Moves incoming mail to a specified address and provides tracking information. ### get_mail_item Retrieves full details for one specific piece of mail in your postbox. ### get_mail_scan Gets the digital scan data for a letter that has already been scanned. ### get_parcel Retrieves physical details, like weight and dimensions, for one specific parcel. ### list_addresses Shows all the forwarding addresses you have saved in your account. ### list_mail_items Generates a complete list of every letter or envelope currently stored in your virtual postbox. ### list_parcels Lists all the parcels that are waiting for pickup or forwarding. ### request_scan Initiates a scan request for an item, making it available for digital retrieval later. ### send_letter Sends a physical letter after you provide the full address and content details. ## Prompt Examples **Prompt:** ``` Show all unread mail in my virtual postbox. ``` **Response:** ``` You have 6 unread items: 3 letters, 2 parcels, 1 large envelope. The most recent letter is from HMRC, received today. Would you like to scan it? ``` **Prompt:** ``` Scan the letter from HMRC and forward it to my home address. ``` **Response:** ``` Scan requested for the HMRC letter — it will be ready within 2 hours. I've also queued it for forwarding to your home address (London, SW1A 1AA). You'll receive tracking once posted. ``` **Prompt:** ``` Send a letter to John Smith at 10 Downing Street. ``` **Response:** ``` Letter queued for printing and posting. Recipient: John Smith, 10 Downing Street, London, SW1A 2AA. Estimated delivery: 1-2 business days via Royal Mail. Would you like a tracking reference? ``` ## Capabilities ### Check Postbox Status Verifies the API connection to UK Postbox so you know if your mailing tools are working. ### List All Mail Items Retrieves a list of every item (letters, envelopes) currently in your virtual postbox. ### Scan Specific Letters Requests and retrieves a digital scan for a selected physical letter or envelope. ### Forward Physical Mail Routes existing mail to a specified address and provides tracking information for the move. ### Send New Letters Composes and queues a physical letter using Royal Mail, requiring recipient details and content. ### List Parcels & Get Details Retrieves a list of all stored parcels and gets specific details (weight, dimensions) for any one parcel. ## Use Cases ### Tax Season Prep An expat needs to process tax documents arriving at their UK address. They ask their agent: 'List all mail items and scan the HMRC letter.' The agent runs `list_mail_items`, then uses `get_mail_scan` on the target item, immediately digitizing the sensitive document for filing. ### Business Relocation A business owner is moving offices and needs all mail redirected. They first use `list_addresses` to confirm their backup location. Then they run `forward_mail`, specifying the new address and getting a tracking reference for continuity. ### Sending Legal Notices A lawyer must send an official notice. Instead of physically going out, they prompt: 'Send a letter to John Smith at 10 Downing Street.' The agent runs `send_letter`, queues the print job, and confirms the estimated delivery time. ### Inventory Management A company receives shipments of goods. They ask their agent to track them: 'List all parcels and tell me about the largest one.' The agent runs `list_parcels` and then uses `get_parcel` to give dimensions, allowing the user to check storage capacity. ## Benefits - Stop wasting time physically visiting a post office. Use `list_mail_items` and `get_mail_scan` to digitize every letter the moment it arrives at your virtual box. - Never guess where a package is going again. Use `list_addresses` before running `forward_mail` so you always route mail correctly, even if you're working from overseas. - Sending physical mail used to mean manual postage and addresses. Now, just call `send_letter`, give the recipient details, and your agent handles the Royal Mail queueing and tracking number generation. - Parcels can be a headache with weight rules and dimensions. Use `list_parcels` followed by `get_parcel` to quickly verify storage capacity and size before planning any shipment. - The whole process is verifiable. After an action, you can always run `check_ukpostbox_status` to confirm the connection is live, giving you confidence in your automated workflows. ## How It Works The bottom line is: You tell your agent what to do with the physical mail, and it runs the specific tool calls needed to get the job done. 1. First, run `check_ukpostbox_status` to verify the server connection. If that passes, use `list_mail_items` or `list_parcels` to see what's waiting. 2. Next, tell your agent exactly what you need: 'Scan the letter from HMRC and send it to my home address.' The agent then calls `request_scan` and queues the action using `forward_mail`. 3. Finally, you review the confirmation. Your AI client uses the returned tracking number or status update, telling you when the physical mail moves. ## Frequently Asked Questions **How do I check if my connection is working with `check_ukpostbox_status`?** Running `check_ukpostbox_status` confirms your API key and connection are active. A successful response means you're ready to run other tools like `list_mail_items`. **What is the difference between `get_mail_item` and `get_mail_scan`?** `get_mail_item` gives you metadata (who sent it, when). You must first run `request_scan` on that item before you can use `get_mail_scan` to retrieve the actual digital document. **Can I send a letter without knowing all the addresses? (using `send_letter`)** No. The `send_letter` tool requires three specific pieces of data: the recipient's full name, their complete physical address, and the content you want to include in the letter. **`list_parcels` vs `list_mail_items`: which one do I use first?** Use `list_mail_items` if you're looking for letters, envelopes, or paperwork. Use `list_parcels` if the item is a box or package that needs tracking and dimensions. **If I use `forward_mail`, what happens if the destination address is invalid or incomplete?** The API rejects the request immediately, providing a specific error code detailing the required fix. You must correct the forwarding address data before re-running the `forward_mail` call. **When I run `list_mail_items`, are there limits on how many records I can retrieve in one single request?** Yes, the API enforces pagination. You need to check for a `next_page_token` or offset parameter and loop through calls until all items are listed. **When I call `get_parcel`, what physical details does the tool return besides just the tracking ID?** It returns dimensions, weight, and current storage status. This lets you verify if a parcel is ready to move or needs special handling before attempting to forward it. **Before I successfully execute `send_letter`, do I need credentials or data beyond the recipient's name and address?** You must ensure your UK Postbox account has active Royal Mail sending credits. The API will fail if funds are depleted, so check billing status before calling this function. **Can I scan my mail remotely via AI?** Yes. Use `request_scan` with the mail item ID to open and digitize a letter. Then use `get_mail_scan` to view the scanned document. **How do I forward mail to another address?** Use `forward_mail` with the mail item ID and a forwarding address ID from your saved addresses. Check `list_addresses` for available destinations. **Can I send physical letters from my agent?** Absolutely. Use `send_letter` with the recipient name, postal address, and letter content. The letter is printed and posted via Royal Mail.