About Paper Plane Post
Paper Plane Post is an MCP service for creating illustrated postcard drafts from an assistant. It hands drafts to its website for review, completion, payment, printing and mailing; tool calls themselves do not place paid orders.
Key features
- 01Create postcard drafts from a photo
- 02Accept photo URLs or supplied file bytes
- 03Add notes and recipient details
- 04Open an existing draft for handoff
- 05Draft links remain valid for seven days
Use cases
- 01Prepare an illustrated postcard from a trip photo
- 02Start a postcard draft before confirming its address
- 03Review a draft and complete payment on the website
- 04Hand an existing draft link to the recipient flow
MCP support
Exposes postcard draft creation and display tools through a remote Streamable HTTP MCP server. Calls do not charge or mail postcards; the website handles review, payment and mailing.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.paperplanepost.com/v1/mcpclaude mcp add --transport http com-paperplanepost-office https://api.paperplanepost.com/v1/mcp{"mcpServers":{"com-paperplanepost-office":{"type":"http","url":"https://api.paperplanepost.com/v1/mcp"}}}Open in Cursor{"servers":{"com-paperplanepost-office":{"type":"http","url":"https://api.paperplanepost.com/v1/mcp"}}}Open in VS Code{"mcpServers":{"com-paperplanepost-office":{"type":"http","url":"https://api.paperplanepost.com/v1/mcp"}}}{"mcpServers":{"com-paperplanepost-office":{"serverUrl":"https://api.paperplanepost.com/v1/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEPaper Plane Post for agents
Create and send an AI-illustrated postcard anywhere in the world.
Start an unpaid draft from your assistant, then open the returned link to review the photo, finish the note and address, and pay for printing and mailing on Paper Plane Post.
Connect
Add this remote MCP server with Streamable HTTP:
https://api.paperplanepost.com/v1/mcp
No account, API key, or authentication header is required. The root plugin.json and mcp.json form a portable Agent Plugin that Cursor Directory can discover from this repository URL. The MCP configuration is:
{
"mcpServers": {
"paper-plane-post": {
"type": "streamable-http",
"url": "https://api.paperplanepost.com/v1/mcp"
}
}
}
start_postcard accepts one photo source: a public HTTPS photo_url, actual file bytes encoded as photo_base64, or the host's supported file input. Include a note and any known recipient fields, or leave them for the website. show_postcard displays the handoff for an existing draft URL without creating another draft. Tool calls never charge money or mail a postcard. Draft links expire after seven days.
Use actual file bytes, never base64 invented from an image. Missing note or address fields don't block a draft. The website handles review, payment, and mailing; order lookup is unavailable through this server.
Packages
- ChatGPT and Codex: plugin manifest, MCP configuration, icon, and packaging helper.
- Claude: plugin manifest, MCP configuration, postcard skill, file-upload helper, and packaging helper.
server.json: official MCP Registry metadata forcom.paperplanepost/office.
These are distribution sources. A package archive or registry listing does not imply approval in an AI app's directory. Build with Bun and the system zip command. From this repository's root:
bun chatgpt/docs/package.ts
bun claude/docs/package.ts
Archives are written under dist/ in the working directory. The builders use explicit file allowlists; environment files and review evidence aren't packaged.
Connection guide · Support · Privacy · Terms
License
The files in this repository are MIT licensed. This license covers the published plugin and connection materials; the hosted service and its private implementation are separate. Using the service is subject to its terms, and printing and mailing require payment on the website.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.