MCP.so
登录

Paperjoy MCP Server已验证已精选

基本信息

传输方式

Streamable HTTP

认证方式

OAuth

分类

媒体与设计

提交者

Norbert Jurga

关于 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.

连接信息

https://paperjoy.co/mcp

接入方式

claude mcp add paperjoy --transport http https://paperjoy.co/mcp

Paperjoy MCP Server 工具

9

Get 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.

概览

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.

URLhttps://paperjoy.co/mcp
TransportStreamable HTTP
AuthOAuth 2.1 (authorization code + PKCE)
Version1.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

ToolWhat it does
get-account-statusAccount info and credit balance
create-postcard-toolFree draft by default; draft: false sends immediately (1 credit, needs mcp:submit)
update-draft-toolEdit a draft (partial updates; null clears a field)
preview-postcard-toolFree PNG of the handwritten card + envelope readiness summary
submit-postcard-toolSend a draft (1 credit; needs mcp:submit)
delete-draft-toolDelete a draft
list-postcards-toolList postcards / drafts (filters: status, name, company)
get-postcard-toolFetch one postcard by ID
list-signatures-toolList 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

常见问题

1

Paperjoy 远程 MCP 服务器是什么?

Paperjoy 的远程 MCP 服务器是一个托管的 Model Context Protocol 端点,地址是 https://paperjoy.co/mcp,AI 助手无需在本地安装或运行任何东西即可连接。

2

怎么连接 Paperjoy 的 MCP 服务器?

把端点 https://paperjoy.co/mcp 添加到任意支持 MCP 的客户端,比如 Claude Code、Cursor 或 VS Code。本页的接入代码块可以一步配置好每个客户端。

3

Paperjoy 的 MCP 服务器需要认证吗?

需要。Paperjoy 使用 OAuth——第一次连接时,你的 MCP 客户端会打开浏览器窗口登录并授权,之后会复用这个凭证。

4

Paperjoy 的 MCP 服务器用的是哪种传输方式?

Paperjoy 暴露的是 Streamable HTTP 端点,这是远程 MCP 服务器普遍使用、主流客户端都支持的传输方式。

评论