Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@paper-plane-post Make a postcard draft using https://example.com/beach.jpg, note 'Wish you were here!' to Sam"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Add this remote MCP server with Streamable HTTP:
https://api.paperplanepost.com/v1/mcpNo 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.
Related MCP server: postcardbot-mcp-server
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 for com.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.tsArchives 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
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.
This server cannot be deployed
Send real handwritten postcards, letters, notecards and gift cards from your AI assistant, preview every piece and its price first, and track QR scan results.
Let AI agents prepare, review, pay for, and send real letters and postcards.
Give AI assistants hands: send real USPS letters via MCP.
Prepare USPS Certified Mail letters from any AI assistant; a person reviews, pays and authorizes.
