Skip to main content
Glama

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

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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      4
      89 npm
      1
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Official 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.
      55
      119 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that lets AI agents create reviewable physical mail drafts, validate quotes, and pay for postage via MPP or x402 protocols.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      An 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