PieterPost MCP
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
PieterPost MCP
PieterPost MCP is a hosted Model Context Protocol (MCP) server for preparing, pricing, reviewing, paying for, and sending real physical letters, postcards, designed letters, and printed greeting cards from ChatGPT, Claude, and other compatible AI assistants.
This public repository contains the integration documentation and registry metadata for the hosted PieterPost MCP server.
Server
MCP server URL: pieterpost.com/mcp/setup/
Human docs: PieterPost MCP documentation
Markdown docs: PieterPost MCP documentation in Markdown
OAuth issuer:
https://pieterpost.com/mcp/oauth
Related MCP server: mailbox-mcp
What It Does
PieterPost gives MCP clients a safe postal outbox. Agents can design letters and printed greeting cards with PNG previews, draft letters and postcards, quote prices, create review links, create hosted payment links, upload assets, use Address Book contacts, and check order status.
For normal use, agents should create a PieterPost review or payment link. PieterPost sends the mail only after the user reviews and pays.
For greeting cards, use list_card_options, create_card_design, get_card_design, get_card_preview, and update_card_design. Upload a supplied photo with upload_asset, then use its asset ID in the design. After each create or update, call get_card_preview for page 0, then page 1, to inspect the actual card images. The private editor link lets the user refine and order the card. Card drafts do not create a paid order. Explain fallback-font and print warnings before ordering.
For designed letters (fonts, colours, photos, illustrations, extra pages, personal fields like {{first_name}}), use list_letter_options, create_letter_design, get_letter_design, and update_letter_design. Pick the postal layout for the recipient's country. Results list print issues per page, including clashes with other countries' address windows; these block ordering. The private editor link lets the user add recipients and order the letter.
The guest server at https://pieterpost.com/mcp/public/ needs no account or authentication. It includes the five card tools, the four letter design tools, and nine public mail tools. Account tools and saved contacts use the OAuth server above.
Client Configuration
Use this server URL in MCP clients that support remote Streamable HTTP servers:
https://pieterpost.com/mcp/setup/Example MCP client snippet:
{
"type": "mcp",
"name": "PieterPost",
"server_url": "https://pieterpost.com/mcp/setup/"
}Cursor and Grok Bot plugin
This repository also contains a Cursor plugin manifest at .cursor-plugin/plugin.json.
The plugin connects to the public Streamable HTTP server at https://pieterpost.com/mcp/public/.
It provides 18 tools and needs no account, API key, or sign-in. Users review and pay on PieterPost before printing and posting.
For review, connect to the public server and test the tools with synthetic data. Use mode=test for mail operations and a fresh UUID idempotency key for each new operation. Check the result before retrying an operation. Do not pay or submit a live order during testing.
Documentation
Contact
For questions, contact pieter@pieterpost.com.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Write, preview and mail real letters and postcards to US addresses from your AI app.
The first MCP server for physical mail: send postcards and letters, manage lists and campaigns.
Send real paper letters from AI chat: print, envelope, postage, delivery. Pay per letter.
Mail one-off USPS letters from ChatGPT or Claude after you approve the preview and price. US only.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to send physical letters and postcards to over 200 countries using Solana cryptocurrency for payment. It provides tools for generating mail quotes, managing wallet balances, and automating physical correspondence directly through the Model Context Protocol.489 npm1MIT
- AlicenseBqualityBmaintenanceOfficial mailbox.bot MCP server for AI agents. Send letters, certified mail and postcards, and give an agent its own street address + postal mailbox number. Agent receiving virtual mailboxes with a real street address are live now at $15/mo in Manhattan Beach, CA. Sandbox keys, approval controls, tracking and webhooks.55119 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that lets AI agents create reviewable physical mail drafts, validate quotes, and pay for postage via MPP or x402 protocols.2MIT
- AlicenseNot gradedqualityBmaintenanceAn open-source MCP server for sending physical mail (letters, postcards, certified mail) directly from AI agents, with per-piece payment and no account signup needed.MIT