Paper Plane Post — Claude Code MCP server: setup and tools
Paper Plane Post generates draft postcards with artwork and notes directly from your coding assistant.
MIT updated 2026-10-28
claude mcp add --transport http office https://api.paperplanepost.com/v1/mcpWhat Paper Plane Post does
This remote MCP server operates over Streamable HTTP without requiring personal API keys or account tokens. The start_postcard tool registers an unpaid draft using an image from a URL, local file attachment, or raw photo_base64 bytes. You can submit the message text and recipient fields immediately or supply them during final review.
A secondary tool, show_postcard, displays the review URL for a draft that was already initiated. Each generated draft link remains valid for seven days. Looking up past deliveries or tracking orders through the protocol is not supported.
Tool executions never charge a credit card or dispatch mail automatically. Final verification of the layout, payment processing, and mailing logistics happen exclusively on the web portal.
What it helps with
- generate physical postcard drafts straight from the assistant prompt
- pass image data via
photo_base64into the print preparation pipeline - retrieve a handoff link to finalize recipient details on the web
- revisit an existing postcard draft link using
show_postcard
Example prompts for the agent
- Prepare a postcard draft using
illustration.pngand add a holiday greeting - Show the handoff link for my existing postcard draft
- Create an open postcard draft without an address so I can enter it online
How to install Paper Plane Post
Platform CLI: remote server
claude mcp add --transport http office https://api.paperplanepost.com/v1/mcpPlatform CLI: remote server
codex mcp add paper-plane-post --url https://api.paperplanepost.com/v1/mcpConfig file
{
"mcpServers": {
"paper-plane-post": {
"url": "https://api.paperplanepost.com/v1/mcp"
}
}
}Config file
{
"servers": {
"paper-plane-post": {
"type": "http",
"url": "https://api.paperplanepost.com/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http paper-plane-post https://api.paperplanepost.com/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Paper Plane Post
How to install Paper Plane Post in Claude Code?
Run claude mcp add --transport http paper-plane-post https://api.paperplanepost.com/v1/mcp in your CLI.
What does Paper Plane Post do?
It turns images and messages into seven-day draft postcards and provides an external link to complete the order.
Can tool calls charge money or send mail automatically?
No, tool calls only build unpaid drafts, while checkout and mailing are completed on the provider website.