What is the Paperjoy remote MCP server?
The Paperjoy remote MCP server is a hosted Model Context Protocol endpoint at https://paperjoy.co/mcp, so AI assistants can connect to it without installing or running anything locally.
Paperjoy MCP ServerVerifiedFeatured
Basic information
About Paperjoy MCP Server
Send real handwritten postcards in Poland from Claude, Cursor, or any MCP client. A robot writes with a real pen, addresses the envelope, and mails via Poczta Polska.
Connection details
https://paperjoy.co/mcpSetup
claude mcp add paperjoy --transport http https://paperjoy.co/mcpPaperjoy MCP Server tools
9Get the authenticated Paperjoy account status, including the available credit balance.
Create a postcard for the authenticated user. By default it is saved as a free draft that is not sent: preview it with preview-postcard-tool, change it with update-draft-tool, then let the user review and send it at review_url, or send it with submit-postcard-tool. Every field is optional for a draft. Set draft to false to send the postcard immediately: all fields except signature, signature_id, and mistake are then required, it costs one credit, and it needs the mcp:submit permission.
Change a draft postcard. Only the fields you send are changed; send null to clear a field. Free. Submitted postcards cannot be changed.
Render a postcard as the customer will receive it: a PNG of the handwritten card, a PNG of the addressed envelope once the address, recipient, and font are set, and a summary that says whether a draft is ready to send and what still needs fixing (missing fields, text that does not fit on the card, an address that does not fit on the envelope). Free; works for drafts and sent postcards.
Send a draft postcard to production. It costs one credit and cannot be undone. The draft must be complete (address, recipient, content, font_id) and fit on the card and envelope; otherwise it stays a draft and the errors explain what to fix. Requires the mcp:submit permission; without it, ask the user to review and send the draft at its review_url.
Permanently delete a draft postcard. Submitted postcards cannot be deleted.
List existing postcards for the authenticated user, newest first, including drafts (status draft). Filter by status to find drafts that still need to be sent.
Retrieve one postcard by ID for the authenticated user.
List active custom signatures available to the authenticated user, newest first. Use an ID from this list as signature_id when creating a postcard.
Overview
Remote MCP server so AI assistants can draft, preview, send, and track real handwritten postcards for Polish businesses.
Connect once with browser OAuth (no API key). By default the assistant saves free drafts; sending costs one credit and needs the mcp:submit scope. Live mode only — every submitted card is written with a real pen and mailed by Poczta Polska.
| URL | https://paperjoy.co/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 (authorization code + PKCE) |
| Version | 1.2.0 |
Install
claude mcp add --transport http --scope user paperjoy https://paperjoy.co/mcp
Then run /mcp, pick paperjoy, and sign in in the browser.
Cursor — add to ~/.cursor/mcp.json or .cursor/mcp.json:
{
"mcpServers": {
"paperjoy": {
"url": "https://paperjoy.co/mcp"
}
}
}
Then connect Paperjoy in MCP settings and complete OAuth.
Tools
| Tool | What it does |
|---|---|
get-account-status | Account info and credit balance |
create-postcard-tool | Free draft by default; draft: false sends immediately (1 credit, needs mcp:submit) |
update-draft-tool | Edit a draft (partial updates; null clears a field) |
preview-postcard-tool | Free PNG of the handwritten card + envelope readiness summary |
submit-postcard-tool | Send a draft (1 credit; needs mcp:submit) |
delete-draft-tool | Delete a draft |
list-postcards-tool | List postcards / drafts (filters: status, name, company) |
get-postcard-tool | Fetch one postcard by ID |
list-signatures-tool | List custom handwritten signatures |
Limits & notes
- Delivery: Polish postal addresses only; sender needs a Polish NIP business account.
- Rate limits: 120 MCP requests/min; postcard submits share the 100/day cap with the API and dashboard.
- Docs: MCP integration · Site: paperjoy.co
Frequently asked questions
How do I connect to the Paperjoy MCP server?
Add the endpoint https://paperjoy.co/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.
Does the Paperjoy MCP server require authentication?
Yes. Paperjoy uses OAuth: the first time you connect, your MCP client opens a browser window to sign in and authorize access, then reuses the credentials for future sessions.
Which transport does the Paperjoy MCP server use?
Paperjoy exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.
More remote MCP servers
%20-%20Sarah%20Xu.svg){kind=icon}
Adobe Marketing Agent
Marketing campaign and audience insights from Adobe
A
AI-Ready Webpage Extractor (Apify)
Convert web pages to clean Markdown and retrieval-ready chunks with browser rendering support.
API Direct
Search and read public data from X/Twitter, Reddit, YouTube, Instagram, TikTok, Facebook, Threads, Bluesky, Trustpilot, Amazon, Google Maps, news, forums and the web. 90+ read-only tools plus ready-made research playbook
AQL PropertyCheck — Physical check of one exact address
Check one exact Gold Coast or Brisbane City property address. Free address/coverage check and short summary; paid structured Agent JSON adds available building, street and surrounding context, with Brisbane routed journe
2pr.io
Write, schedule and publish LinkedIn posts in your own voice, reply to comments and read your analytics, all from your AI assistant. Remote MCP server with OAuth sign-in.
Comments