AI agent writes a comedy roast and sends it as a digital or physical postcard via GitHub profile data.
What it does
Papercut is a paid API that lets AI agents generate comedy-roast postcards based on a target's GitHub profile. The workflow has two endpoints: a free GET endpoint at /api/github/{username} that fetches profile data (repos, contributions, orgs, pinned items, README), and a paid POST endpoint at /api/send that accepts the roast text (280 chars max, lowercase), the GitHub username, postcard type (digital or physical), and optional mailing address. Payment is handled automatically via MPP or x402 protocols, settling in USDC on Base (eip155:8453) or pathUSD on Tempo L2. Digital postcards cost $1 and physical ones cost $3 when paid through an agent; the website's manual form shows slightly higher prices ($2/$5). Art generation takes approximately 60 seconds, and the response includes a reveal URL where the recipient can view the finished postcard.
The API returns an order confirmation with a reveal link and a referral link (10% commission on referred orders). Physical postcards ship internationally to dozens of countries. The OpenAPI spec is well-documented with full request/response schemas, field validations, and a detailed agent guidance section covering the complete ordering flow. The service has processed at least 22 orders to date, with on-chain transaction receipts visible on Tempo and Base explorers.
Capabilities
Use cases
- —An AI agent roasts a friend's GitHub profile and sends them a physical postcard as a joke
- —Automated onboarding gift: send new team members a humorous welcome postcard based on their GitHub activity
- —Social sharing: generate a digital roast postcard link to share in group chats or on social media
- —Referral program: earn 10% on orders placed through your referral link
Fit
Best for
- —AI agents that need a fun, tangible output from a conversation
- —Developers wanting to send novelty postcards programmatically
- —Social/entertainment integrations that leverage GitHub profile data
Not for
- —Sending serious or professional correspondence
- —Bulk marketing mailers or spam
- —Users without a GitHub profile to roast
Quick start
# 1. Fetch GitHub profile data
curl https://papercut.lol/api/github/octocat
# 2. Send a digital postcard (requires MPP or x402 payment)
curl -X POST https://papercut.lol/api/send \
-H 'Content-Type: application/json' \
-d '{"roast": "you mass-starred 400 repos and committed to none. commitment issues much?", "github_username": "octocat", "type": "digital"}'Example
Request
{
"zip": "94107",
"city": "San Francisco",
"name": "Mona Lisa Octocat",
"type": "physical",
"roast": "you mass-starred 400 repos and committed to none. commitment issues much?",
"state": "CA",
"country": "US",
"address_line1": "88 Colin P Kelly Jr St",
"github_username": "octocat"
}Response
{
"id": "pr_abc123xyz",
"reveal": "https://papercut.lol/reveal/pr_abc123xyz",
"status": "processing",
"arrives": "5-10 business days",
"message": "postcard is being created. art takes ~60s.",
"referral": "https://papercut.lol/?ref=0x1234567890abcdef1234567890abcdef12345678"
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response definitions and agent guidance. Pricing is clearly documented ($1 digital, $3 physical via agent). The MPP probe returned 404 because the endpoint only accepts POST, not HEAD/GET — the endpoint is likely live given 22 on-chain transactions visible on the landing page. Docs pages (e.g. /docs, /pricing) return 404, so documentation lives entirely in the OpenAPI spec and homepage.
Warnings
- —MPP probe returned 404 on HEAD and GET; endpoint is POST-only so this does not confirm it is down, but a live 402 challenge was not directly captured
- —Website manual-mode prices ($2 digital / $5 physical) differ from API/agent prices ($1 / $3) — pricing may vary by channel
- —No dedicated documentation pages exist beyond the OpenAPI spec and homepage
Citations
- —Digital postcards cost $1 and physical cost $3 when ordered via agenthttps://papercut.lol
- —Payment settles via MPP (Tempo L2 pathUSD) or x402 (USDC on Base eip155:8453)https://papercut.lol
- —Art generation takes ~60 seconds and the reveal page updates automaticallyhttps://papercut.lol
- —22 postcards have been sent to date with on-chain transaction receiptshttps://papercut.lol
- —Referral links earn 10% on referred ordershttps://papercut.lol
- —Roast text is limited to 280 characters, lowercase, comedy tonehttps://papercut.lol
- —Physical postcards ship to dozens of countries internationallyhttps://papercut.lol