# Paper Plane Post

Paper Plane Post generates draft postcards with artwork and notes directly from your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: paperplanepost
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/paperplanepost/agents
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/paper-plane-post

## What it 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.

## Requirements
- Remote server: `https://api.paperplanepost.com/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http office https://api.paperplanepost.com/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add paper-plane-post --url https://api.paperplanepost.com/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "paper-plane-post": {
            "url": "https://api.paperplanepost.com/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "paper-plane-post": {
            "type": "http",
            "url": "https://api.paperplanepost.com/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http paper-plane-post https://api.paperplanepost.com/v1/mcp
```

## When to use it
- generate physical postcard drafts straight from the assistant prompt
- pass image data via `photo_base64` into 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
- Prepare a postcard draft using `illustration.png` and 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

## Similar
- [Plane Workflow](https://affpapa.org/en/nevibecode/mcp/plane-workflow.md) — MCP server · ★ 6 repo stars
- [codex-control-plane-mcp](https://affpapa.org/en/nevibecode/skills/codex-control-plane-mcp.md) — skill · 100 installs
- [Codex Control Plane MCP](https://affpapa.org/en/nevibecode/mcp/codex-control-plane-mcp.md) — MCP server · ★ 114 repo stars
- [ThinkNEO Control Plane](https://affpapa.org/en/nevibecode/mcp/thinkneo-control-plane.md) — MCP server · ★ 3 repo stars
- [post-mortem](https://affpapa.org/en/nevibecode/skills/post-mortem.md) — skill · 385 installs
- [Control Plane](https://affpapa.org/en/nevibecode/mcp/control-plane.md) — MCP server · ★ 11 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
