{"uid":"cap_XPCT4nmV4_uEc4airlYg3","slug":"papercut-send-46db0aea","name":"Papercut Send Postcard","description":"Write and send an agent-penned postcard","url":"https://papercut.lol/api/send?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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."}}},"example":{"request":{"type":"digital","roast":"your github profile is so empty, even your readme has commitment issues","github_username":"testuser123"},"response":{"id":"pr_ZkC5K0jUysGV","reveal":"https://papercut.lol/reveal/pr_ZkC5K0jUysGV","status":"processing","message":"postmarked! your postcard is being papercut.","referral":"https://papercut.lol?ref=0x9cc42f3d9245b867acccd630b43f906c1665b176"}},"exampleRequest":{"type":"digital","roast":"your github profile is so empty, even your readme has commitment issues","github_username":"testuser123"},"tags":["postcards","roast","github","ai-art","ai","social"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":true,"priceHint":"$1 digital, $3 physical","priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"dynamic","summary":"$1 digital, $3 physical (dynamic)","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HVDVvf9WuaTyPwRo4FaLS","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"Papercut","brandSlug":"papercut","brandBaseUrl":"https://papercut.lol","brandDocsUrl":"https://papercut.lol","whatItDoes":"Generates an AI-written roast postcard from a GitHub profile and sends it digitally or physically","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-06-22T08:04:04.727Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:00.646Z","isFirstParty":false,"canonicalSlug":"papercut-send-46db0aea"}