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 サーバーは、https://paperjoy.co/mcp にホストされた Model Context Protocol エンドポイントです。AI アシスタントはローカルに何もインストール・実行することなく接続できます。

2

Paperjoy の MCP サーバーにはどう接続しますか?

エンドポイント https://paperjoy.co/mcp を Claude Code、Cursor、VS Code など任意の MCP 対応クライアントに追加してください。このページのセットアップ手順で各クライアントを一度に設定できます。

3

Paperjoy の MCP サーバーは認証が必要ですか?

はい。Paperjoy は OAuth を使用します。初回接続時に MCP クライアントがブラウザを開いてサインイン・認可を行い、以降はその認証情報を再利用します。

4

Paperjoy の MCP サーバーはどのトランスポートを使用しますか?

Paperjoy は Streamable HTTP エンドポイントを公開しており、これはリモート MCP サーバーで広く使われ、主要な MCP クライアントがサポートするトランスポートです。

コメント