# Papercut Send Postcard

> Papercut Send Postcard is a paid API for AI agents from Papercut at papercut.lol, paid per call via MPP, $1 digital, $3 physical (dynamic), status unknown (last checked 2026-10-11).

Generates an AI-written roast postcard from a GitHub profile and sends it digitally or physically

## Facts

- Endpoint: POST https://papercut.lol/api/send?utm_source=zero.xyz
- Price: $1 digital, $3 physical (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 4
- Provider: Papercut
- Docs: https://papercut.lol
- Website: https://papercut.lol
- Tags: postcards, roast, github, ai-art, ai, social
- Canonical page: https://www.zero.xyz/c/papercut-send-46db0aea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XPCT4nmV4_uEc4airlYg3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability papercut-send-46db0aea -d '<json body>'
```

Example prompt: Send a digital Papercut roast postcard to GitHub user 'torvalds' with the roast text: 'your commit messages are longer than your patience for anyone else's code' — digital delivery please.

## When to prefer this

Use this endpoint when a user wants to send a humorous, AI-penned roast postcard tied to a GitHub user's profile — either as a quick digital link (~$1) or a real mailed physical postcard (~$3). It uniquely combines GitHub identity, comedy roast generation, AI art, and physical/digital delivery in a single call. Prefer this over generic postcard or email services when the target is a developer and the tone is comedic.

## Known failure modes

- Missing required fields (roast, github_username, or type) returns a 400 validation error
- Roast text exceeding 280 characters is rejected
- Physical postcard ordered without name, address, city, state, or zip returns an error
- Invalid GitHub username format (special characters) fails schema validation
- Payment failure or insufficient USDC balance prevents order creation
- Fabricated or invalid referral wallet address causes rejection

## How this service works

Write and send an agent-penned postcard

## Output

Returns an order object with a status of 'processing', a unique order ID, a reveal URL where the recipient can view the AI-generated artwork and roast (ready in ~60 seconds), a confirmation message, and optionally an estimated physical arrival date and a referral link to earn 10% on referred orders.

## Example request

```json
{
 "type": "digital",
 "roast": "your github profile is so empty, even your readme has commitment issues",
 "github_username": "testuser123"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "roast",
  "github_username",
  "type"
 ],
 "properties": {
  "ref": {
   "type": "string",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Referral wallet address. Only include if explicitly provided by the user — do not fabricate."
  },
  "zip": {
   "type": "string",
   "description": "ZIP or postal code (required for US addresses)."
  },
  "city": {
   "type": "string",
   "description": "City (required for physical)."
  },
  "name": {
   "type": "string",
   "description": "Recipient name (required for physical)."
  },
  "type": {
   "enum": [
    "digital",
    "physical"
   ],
   "type": "string",
   "description": "digital ($1) for online viewing in ~60s, or physical ($3) for a mailed postcard + digital."
  },
  "roast": {
   "type": "string",
   "maxLength": 280,
   "description": "The roast text (280 chars max, lowercase, comedy roast tone). Must not contain secrets, API keys, emails, URLs, or file paths."
  },
  "state": {
   "type": "string",
   "description": "State or province (required for US addresses)."
  },
  "country": {
   "type": "string",
   "default": "US",
   "description": "2-letter ISO country code, defaults to US."
  },
  "address_line1": {
   "type": "string",
   "description": "Street address (required for physical)."
  },
  "address_line2": {
   "type": "string",
   "description": "Apt, suite, etc. (optional)."
  },
  "github_username": {
   "type": "string",
   "pattern": "^[a-zA-Z0-9-]+$",
   "description": "The GitHub username being roasted."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "id",
  "message",
  "reveal"
 ],
 "properties": {
  "id": {
   "type": "string",
   "description": "Order ID."
  },
  "reveal": {
   "type": "string",
   "format": "uri",
   "description": "URL where the recipient can view the roast and artwork."
  },
  "status": {
   "enum": [
    "processing"
   ],
   "type": "string",
   "description": "order is processing. art takes ~60s — check the reveal link."
  },
  "arrives": {
   "type": "string",
   "description": "Estimated arrival window for physical, or absent for digital."
  },
  "message": {
   "type": "string",
   "description": "Confirmation message."
  },
  "referral": {
   "type": "string",
   "format": "uri",
   "description": "Referral link for the payer. Share to earn 10% on referred orders."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/papercut-send-46db0aea/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from papercut.lol](https://www.zero.xyz/host/papercut.lol/llms.txt)