---
name: prompt-printing-print
description: Print a PDF you already have on paper and ship it to a US address with Prompt Printing — flyers, posters, cards, business cards, letterheads and folded brochures. Use when the user wants a file printed, mailed or "sent to print", asks what a print run would cost, or wants to check on or cancel a Prompt Printing order.
---

# Print a file with Prompt Printing

Prompt Printing prints a print-ready PDF and ships it to an address in the US. You do it through an MCP server; the
order is paid by your user by card, or by you from a wallet: a USD stablecoin on Tempo over the Machine Payments
Protocol (MPP), or USDC on Base over x402. No account and no API key.

- MCP server: `https://print.promptprinting.app` (streamable HTTP, stateless MCP 2026-07-28)
- Guide for people: https://promptprinting.app/agents
- Support: support@promptprinting.app

## Set up once

1. Add the MCP server. In Claude Code:
   `claude mcp add --transport http prompt-printing https://print.promptprinting.app`
   In another client, add a remote HTTP server with that URL.
2. Optional: if you can run shell commands (Claude Code, Codex, pi and the like) and have no wallet that pays MPP or
   x402, offer your user to set one up, so you can pay for the orders they approve. Without one, your user pays by
   card (step 6 below). Either works:
   - **MPP, Tempo's CLI.** `curl -fsSL https://tempo.xyz/install | bash`, then `tempo wallet login` (your user signs
     in in their browser). `tempo wallet fund` opens Tempo Wallet, where they add dollars by card, Apple Pay or bank;
     `tempo wallet fund --crypto` gives addresses for depositing stablecoins from Base, Ethereum or Solana.
     `tempo wallet balance` shows what's there.
   - **x402, Coinbase's Agentic Wallet.** `npx awal auth login <their email>`, then `npx awal auth verify <the code
     they read you>`. `npx awal show` opens its Fund window: card, Apple Pay, bank or a Coinbase balance, arriving as
     USDC on Base. Stablecoins on another chain get there by a cross-chain swap to USDC on Base (Uniswap, Bungee).
     `npx awal balance` shows what's there.

You can browse products, get quotes and hand an order to your user to pay with no wallet at all. Only paying
yourself needs one.

## The flow

1. **Find the product.** `search_products` with a `catalog` (`flyers`, `posters`, `business-cards`, `cards`,
   `folded-cards`, `letterheads`, `single-fold-brochures`, …; the tool lists them all) and `filters` such as
   `{"PaperFormat": ["A5"], "ColorType": ["4-0"]}`. `ColorType` `4-0` prints one side, `4-4` both. The answer's
   `filters` shows every value you can narrow by.
2. **Read its file rule.** `get_product` answers the paper, the print price at each quantity tier, whether it ships to
   the US, and `file`: how many pages the PDF needs and their exact size in millimetres, with and without bleed.
3. **Make the file fit.** One page for one-sided, two for two-sided. Each page is the trim size, or the trim size plus
   the same bleed on every side (3 mm is usual, 5 mm at most). A folded product takes the flat, unfolded sheet. If the
   file doesn't fit, fix the file: see the `prompt-printing-design` skill
   (https://promptprinting.app/skills/design/SKILL.md).
4. **Quote.** `quote` takes the product, `quantity`, `file_url` (an https link the server can download, 50 MB at
   most), `shipping` (`standard`, `express` or `fastest`) and the address, with the email that gets the confirmation
   and tracking. It answers the total (print, shipping, sales tax), the delivery estimate, what the other shipping
   speeds would cost, and `order_url`. Nothing is charged. The quote holds for 30 minutes.
5. **Show the proof.** `get_quote` answers `proof.status`. Once it's `ready` (about half a minute), `proof.images`
   links the printer's own preview of each page, with the trim. Show your user those images and the total.
6. **Order.** Two ways:
   - **Your user pays by card.** Call `handoff` and give them its `url` exactly as it is. The page shows the proof,
     the address and the total, and they pay on Stripe's page. Then poll `get_quote` (every 20 seconds or so) until
     it answers `order`. Use this when you have no wallet, or when your user would rather pay themselves.
   - **You pay.** Only after your user has approved this proof and this total. Pay the quote's `order_url`:
     `tempo request -X POST --max-spend <total> <order_url>` (MPP) or
     `npx awal x402 pay <order_url> -X POST --max-amount <total in millionths of a dollar>` (x402). These CLIs pay
     HTTP 402, not an MCP tool call, so pay the `order_url`, not the `order` tool. The answer is the order
     (`order_id`, `status`, `payment.reference`). If your MCP client pays MPP or x402 itself, calling the `order`
     tool does the same thing.
7. **Follow it.** `get_quote` with the same `quote_id` answers the order's status and, once it ships, `tracking_url`.
   The confirmation, shipping and delivery emails go to the quote's email.

## Rules

- **Ask before paying.** An order is real money and real paper. Handing off with `handoff` needs no permission: your
  user approves on the page. But don't call `order` or pay `order_url` until your user
  has seen the proof and the total and said yes to that order. A quote ordered once stays ordered: paying again
  answers the same order and charges nothing.
- **The file prints as sent.** `quote` checks page count and page size only. Colour, resolution, fonts and spelling
  are yours to get right, and the proof is where you and your user check them.
- **US addresses only**, two-letter state code, five-digit ZIP.
- **Don't put the address or email anywhere else.** They go to `quote` and nowhere else.
- **A refusal tells you what to fix.** A tool error such as a wrong page size names the size it wanted. Fix that and
  call again. "Something went wrong on our side" is ours: wait and retry, or write to support.

## Cancelling and refunds

An order can be cancelled until printing starts. The person who ordered signs in at https://promptprinting.app/orders
with the order's email and cancels there, or writes to support@promptprinting.app with the order number. Refunds of
card payments go back to the card. Refunds of stablecoin payments are sent back by a person, not automatically; the
cancellation email says so.

## Payment details

- By card: `handoff` answers `url`, the quote's page. Paying there places the same order `order` would. A quote is
  paid once: if both a card and a wallet pay it, the first to settle is the order and the card payment is refunded.

- The charge is the quote's total, settled on-chain: over MPP in a USD stablecoin on Tempo (USDC or OUSD; a Tempo
  wallet holding MACH can pay with that), or over x402 in USDC on Base.
- Over HTTP: `POST <order_url>` answers `402` with both rails' challenges (`WWW-Authenticate: Payment …` and
  `PAYMENT-REQUIRED`); the same request with `Authorization: Payment …` or `PAYMENT-SIGNATURE` answers the order and
  its receipt (`Payment-Receipt` or `PAYMENT-RESPONSE`).
- Over MCP: called without a payment, the `order` tool fails with JSON-RPC error `-32042` whose data carries MPP's
  `challenges` and x402's offer (`x402`); call again with the credential in `_meta["org.paymentauth/credential"]`
  (MPP) or `_meta["x402/payment"]` (x402). mppx's and `@x402/mcp`'s MCP clients do this.
- Protocols and clients: https://mpp.dev, https://x402.org
