PieterPost MCP Server

@pieterpost-com

代码仓库主页文档

基本信息

传输方式

stdio

认证方式

无需认证

分类

沟通协作

作者

pieterpost-com

提交者

Eric de Zeeuw

关于 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.

#postal#mail#letters#postcards#shipping #communication #automation #oauth #streamable-http #agents

连接信息

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

接入方式

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

PieterPost MCP Server 工具

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.

概览

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.

常见问题

PieterPost MCP 远程 MCP 服务器是什么?

PieterPost MCP 的远程 MCP 服务器是一个托管的 Model Context Protocol 端点,地址是 https://pieterpost.com/mcp/public/,AI 助手无需在本地安装或运行任何东西即可连接。

怎么连接 PieterPost MCP 的 MCP 服务器?

把端点 https://pieterpost.com/mcp/public/ 添加到任意支持 MCP 的客户端,比如 Claude Code、Cursor 或 VS Code。本页的接入代码块可以一步配置好每个客户端。

PieterPost MCP 的 MCP 服务器需要认证吗?

不需要。PieterPost MCP 的 MCP 服务器不需要认证——直接用端点地址连接即可。

PieterPost MCP 的 MCP 服务器用的是哪种传输方式?

PieterPost MCP 暴露的是 stdio 端点,这是远程 MCP 服务器普遍使用、主流客户端都支持的传输方式。