MCP.so
Sign In

PieterPost MCP Server

@pieterpost-com

Basic information

Transport

stdio

Authentication

None

Category

Communication

Author

pieterpost-com

Submitted by

Eric de Zeeuw

About PieterPost MCP Server

Send real letters and postcards from AI assistants. Quote postage, prepare drafts, upload files, review and pay in hosted checkout, and check postal status. No account or API key required.

Connection details

https://pieterpost.com/mcp/public/

Setup

claude mcp add pieterpost --transport http https://pieterpost.com/mcp/public/

PieterPost MCP Server tools

9

Search public PieterPost postal workflow guidance. Does not search accounts, contacts, orders, or credentials.

Read a public guide returned by search. Only mail-workflow, postal-addresses, and checkout-and-status IDs are supported.

Create hosted checkout for an unpaid prepared guest order. Supply preparedOrderRef, a new random UUID idempotencyKey, and the same mode. No login required. The user reviews and pays; this tool does not pay or send mail.

Get payment, fulfillment, and postal delivery status for a guest orderRef from this conversation or supplied by the user. delivery includes per-recipient status, tracking number/link when available, delivery date, and status-page link. fulfilled means submission for printing and posting, not delivery. Use deliveryOffset and deliveryLimit (1-25) for bulk orders. Returns no content, postal address, email, or payment URL.

Create an encrypted, expiring URL to review and edit a letter on PieterPost without login. Provide a recipient, optional message, and random UUID idempotencyKey. Does not create, pay, or send a mail order.

Prepare and price an unpaid physical letter without login. Set deliveryService=registered for registered mail or US Certified Mail with return receipt; standard is the default. Provide letters and a random UUID idempotencyKey. Defaults to live; use mode=test for demonstrations. Returns preparedOrderRef for create_payment_link. Never pays or sends mail.

Prepare and price an unpaid postcard without login. Provide postcard and a random UUID idempotencyKey. Defaults to live; use mode=test for demonstrations. Returns preparedOrderRef for create_payment_link. Never pays or sends mail.

Validate and price exactly one of letters or postcard without creating an order, paying, or sending mail. For letters, deliveryService=registered quotes registered mail or US Certified Mail. Unsupported destinations and page counts return errors. No account or wallet data is accessed. US address verification can contact the postal provider.

Upload a supplied PDF, PNG, or JPEG for a letter attachment, stamp, or square postcard front. No login required. Returns the assetId to use when preparing mail.

Overview

Send physical mail from your AI assistant

PieterPost prints and posts real letters and postcards. Draft a letter, check postage, upload a PDF or photo, and create an editable preview or secure checkout link. Review the content, recipient, and price on PieterPost, then pay to start printing and posting. Check payment, fulfillment, and available postal delivery updates using your order reference.

Connect

Use Streamable HTTP at https://pieterpost.com/mcp/public/ with no authentication. No PieterPost account or API key is required.

For saved contacts and account tools, use the separate OAuth endpoint at https://pieterpost.com/mcp/setup/.

Documentation: https://pieterpost.com/api/docs/mcp/

Tools

The public server provides nine tools: search, fetch, quote_order, create_compose_link, upload_asset, prepare_letter, prepare_postcard, create_payment_link, and get_order_status.

Examples

  • Draft and review a formal letter.
  • Prepare a postcard with your own photo.
  • Quote standard or registered letters, including US Certified Mail where supported.
  • Check payment, fulfillment, and available delivery updates.

Frequently asked questions

1

What is the PieterPost MCP remote MCP server?

The PieterPost MCP remote MCP server is a hosted Model Context Protocol endpoint at https://pieterpost.com/mcp/public/, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the PieterPost MCP MCP server?

Add the endpoint https://pieterpost.com/mcp/public/ to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the PieterPost MCP MCP server require authentication?

No. PieterPost MCP's MCP server does not require authentication — you can connect directly with the endpoint URL.

4

Which transport does the PieterPost MCP MCP server use?

PieterPost MCP exposes a stdio endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments