{"name":"PhotoPrintAgent","version":"2.2.0","terms":{"url":"https://photoprintagent.com/terms","version":"2026-10-25","acceptanceField":"termsAccepted"},"url":"https://photoprintagent.com/mcp","aliases":["https://photoprintagent.com/api/mcp"],"transport":"streamable-http","documentation":"https://photoprintagent.com/docs/mcp","requiredHeaders":{"Content-Type":"application/json","Accept":"application/json, text/event-stream"},"authentication":{"guestTool":"start_guest_checkout","accountKeyPrefix":"ppa_","guestKeyPrefix":"ppg_","authorization":"Bearer","accountRequired":false},"tools":[{"name":"get_checkout_options","description":"Public account and guest authentication instructions, current order terms URL/version, and required acceptance field.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"terms":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"version":{"type":"string"},"acceptanceField":{"type":"string","const":"termsAccepted"}},"required":["url","version","acceptanceField"],"additionalProperties":false},"account":{"type":"object","properties":{"signInUrl":{"type":"string","format":"uri"},"firebaseConfigUrl":{"type":"string","format":"uri"},"instructions":{"type":"string"}},"required":["signInUrl","firebaseConfigUrl","instructions"],"additionalProperties":false},"guest":{"type":"object","properties":{"endpoint":{"type":"string"},"method":{"type":"string","const":"POST"},"mcpTool":{"type":"string","const":"start_guest_checkout"},"accountRequired":{"type":"boolean","const":false},"paymentMethods":{"type":"array","items":{"type":"string","enum":["card","x402"]}}},"required":["endpoint","method","mcpTool","accountRequired","paymentMethods"],"additionalProperties":false},"guideUrl":{"type":"string","format":"uri"}},"required":["terms","account","guest","guideUrl"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"start_guest_checkout","description":"Public: mint a private guest credential once. No account, payment or print is created. Save it in a secret store.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"token":{"type":"string"},"guestApiKey":{"type":"string"},"checkoutUntil":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"expiresAt":{"$ref":"#/properties/checkoutUntil"},"tokenType":{"type":"string","const":"Bearer"},"instructions":{"type":"string"}},"required":["token","guestApiKey","checkoutUntil","expiresAt","tokenType","instructions"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_agent_key","description":"Mint a 90-day account key using a verified Firebase ID token in Authorization. Guests and existing agent keys cannot mint keys.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"key":{"type":"string"},"id":{"type":"string"},"expiresAt":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"}},"required":["key","id","expiresAt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_products","description":"Public active product catalog, print specifications, and availability. Each product supplies artwork dimensions, minimum/maximum image counts, ordered slot labels, bleed and rotation rules. These apply to all active supported products, including multi-image designs. Artwork minimumDpi values are print quality guidance, not an upload rejection threshold: accept smaller valid images, resize them, and treat reduced quality as a nonblocking warning. Admin Only products are never listed. Pass a returned products[].id as productId when uploading and quoting; omission selects the original photo-4x6 product. Price depends on the items and destination; call quote_prints for an authoritative total.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string","const":"photo-4x6"},"title":{"type":"string"},"countries":{"type":"array","items":{"type":"string","const":"US"}},"maxPhotos":{"type":"integer"},"maxPrints":{"type":"integer"},"specs":{"type":"object","properties":{"widthInches":{"type":"number"},"heightInches":{"type":"number"},"landscapePixels":{"type":"array","items":{"type":"number"}},"portraitPixels":{"type":"array","items":{"type":"number"}},"recommendedDpi":{"type":"number"},"minimumDpi":{"type":"number"},"colorSpace":{"type":"string","const":"sRGB"},"outputFormat":{"type":"string","const":"image/jpeg"},"maxFileBytes":{"type":"number"},"maxInputPixels":{"type":"number"},"acceptedMimeTypes":{"type":"array","items":{"type":"string"}},"acceptedExtensions":{"type":"array","items":{"type":"string"}},"imageHandling":{"type":"object","properties":{"resolutionPolicy":{"type":"string"},"animationPolicy":{"type":"string"},"multipagePolicy":{"type":"string"},"transparencyPolicy":{"type":"string"},"colorPolicy":{"type":"string"},"svgPolicy":{"type":"string"},"unsupportedPolicy":{"type":"string"},"helpUrl":{"type":"string"}},"required":["resolutionPolicy","animationPolicy","multipagePolicy","transparencyPolicy","colorPolicy","svgPolicy","unsupportedPolicy","helpUrl"],"additionalProperties":false},"aspectRatio":{"type":"string"},"cropRules":{"type":"string"},"priceMode":{"type":"string","const":"quote_required"}},"required":["widthInches","heightInches","landscapePixels","portraitPixels","recommendedDpi","minimumDpi","colorSpace","outputFormat","maxFileBytes","maxInputPixels","acceptedMimeTypes","acceptedExtensions","imageHandling","aspectRatio","cropRules","priceMode"],"additionalProperties":false}},"required":["id","title","countries","maxPhotos","maxPrints","specs"],"additionalProperties":false},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"widthInches":{"type":"number"},"heightInches":{"type":"number"},"artwork":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"},"minImages":{"type":"integer"},"maxImages":{"type":"integer"},"minimumDpi":{"type":"number"},"allowRotate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"string"}},"bleed":{"type":"object","additionalProperties":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}},"calendar":{"type":"object","properties":{"layout":{"type":"string","const":"alternating-photo-grid"},"months":{"type":"number","enum":[12,18]}},"required":["layout","months"],"additionalProperties":false},"composition":{"type":"object","properties":{"id":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"background":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["x","y","width","height"],"additionalProperties":false}}},"required":["id","width","height","background","slots"],"additionalProperties":false}},"required":["widthPixels","heightPixels","minImages","maxImages","minimumDpi","allowRotate","labels","bleed","issues"],"additionalProperties":false},"shipping":{"type":"object","properties":{"mode":{"type":"string","enum":["provider","flat","per_item"]},"amountCents":{"type":"integer","minimum":0,"maximum":100000,"default":0},"multipleItemAmountCents":{"anyOf":[{"$ref":"#/properties/products/items/properties/shipping/properties/amountCents"},{"type":"null"}],"default":null}},"required":["mode"],"additionalProperties":false},"adminOnly":{"type":"boolean"},"available":{"type":"boolean"},"unavailableReason":{"type":"string"},"preview":{"type":"object","additionalProperties":{}}},"required":["id","title","description","widthInches","heightInches"],"additionalProperties":true}},"catalogProducts":{"type":"array","items":{"$ref":"#/properties/products/items"}},"orderingAvailable":{"type":"boolean"},"googleEnabled":{"type":"boolean"},"xEnabled":{"type":"boolean"},"x402Available":{"type":"boolean"},"paymentNetwork":{"type":"string"},"solanaAvailable":{"type":"boolean"},"x402PayTo":{"type":["string","null"]},"support":{"type":"string"}},"required":["product","orderingAvailable","googleEnabled","xEnabled","x402Available","paymentNetwork","solanaAvailable","x402PayTo","support"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_upload","description":"Get the authenticated binary upload endpoint and product/crop headers. Pass productId from list_products for every image. Upload each required image separately; retain the returned IDs in slot order. Crops and resolution checks use that product’s artwork specifications, not a universal 4x6 size. POST the image bytes separately; never put base64 or remote image URLs in MCP. No storage is allocated until upload. JPEG, PNG/APNG, WebP, GIF, HEIC/HEIF, TIFF, AVIF, BMP and self-contained SVG are supported. Read acceptedMimeTypes, acceptedExtensions and imageHandling for frame/page selection, transparency, and limits. Use application/octet-stream when MIME type is unavailable. Unsupported encodings must be converted before upload.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"crop":{"type":"object","properties":{"fit":{"type":"string","enum":["cover","contain"],"default":"cover"},"orientation":{"type":"string","enum":["landscape","portrait"],"default":"landscape"},"x":{"type":"number","minimum":0,"maximum":100,"default":50},"y":{"type":"number","minimum":0,"maximum":100,"default":50}},"additionalProperties":false},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"uploadUrl":{"type":"string","format":"uri"},"method":{"type":"string","const":"POST"},"authorization":{"type":"string","const":"Bearer: use your existing account or guest credential"},"headers":{"type":"object","properties":{"X-Photo-Options":{"type":"string"},"X-Product-Id":{"type":"string"}},"required":["X-Photo-Options"],"additionalProperties":false},"acceptedMimeTypes":{"type":"array","items":{"type":"string"}},"acceptedExtensions":{"type":"array","items":{"type":"string"}},"imageHandling":{"type":"object","properties":{"resolutionPolicy":{"type":"string"},"animationPolicy":{"type":"string"},"multipagePolicy":{"type":"string"},"transparencyPolicy":{"type":"string"},"colorPolicy":{"type":"string"},"svgPolicy":{"type":"string"},"unsupportedPolicy":{"type":"string"},"helpUrl":{"type":"string"}},"required":["resolutionPolicy","animationPolicy","multipagePolicy","transparencyPolicy","colorPolicy","svgPolicy","unsupportedPolicy","helpUrl"],"additionalProperties":false},"maxFileBytes":{"type":"integer"},"maxInputPixels":{"type":"integer"},"helpUrl":{"type":"string","format":"uri"},"responseSchemaUrl":{"type":"string","format":"uri"},"artwork":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"},"minImages":{"type":"integer"},"maxImages":{"type":"integer"},"minimumDpi":{"type":"number"},"allowRotate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"string"}},"bleed":{"type":"object","additionalProperties":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}},"calendar":{"type":"object","properties":{"layout":{"type":"string","const":"alternating-photo-grid"},"months":{"type":"number","enum":[12,18]}},"required":["layout","months"],"additionalProperties":false},"composition":{"type":"object","properties":{"id":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"background":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["x","y","width","height"],"additionalProperties":false}}},"required":["id","width","height","background","slots"],"additionalProperties":false}},"required":["widthPixels","heightPixels","minImages","maxImages","minimumDpi","allowRotate","labels","bleed","issues"],"additionalProperties":false}},"required":["uploadUrl","method","authorization","headers","acceptedMimeTypes","acceptedExtensions","imageHandling","maxFileBytes","maxInputPixels","helpUrl","responseSchemaUrl"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"quote_prints","description":"Quote private uploaded photo IDs and a US destination for an optional productId from list_products (defaults to photo-4x6). Items may specify productId to mix products using the same print service; omitted item productId uses the order productId. For a single image use items:[{photoId,productId,quantity}]. For a multi-image design use items:[{photoIds:[frontId,backId,...],quantity}]; array order is print order and quantity counts complete products, not individual images. Follow artwork.minImages/maxImages and labels. For artwork.calendar, upload a cover plus one photo per month and include calendar:{startYear,startMonth} on the item; the server generates and interleaves the date grids. Do not upload date grids. For artwork.composition, upload each source photo at the per-image dimensions; the server assembles the ordered photos into the single print file shown by the layout. Never precompose those photos or send each side as a separate item. Up to 200 uploaded images and 500 product units per order. Shipping follows the product’s configured pricing; flat rates can differ for 1 versus 2+ prints. Use the returned shipping and total; never multiply flat shipping by quantity. Requires consent for PhotoPrintAgent to process these photos and address for printing and delivery. Unique photos, at most 500 total prints. Optional couponCode is validated here; price.total is the discounted buyer amount and price.discount is the savings in USD cents.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"items":{"type":"array","items":{"type":"object","properties":{"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false},"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"photoId":{"type":"string","format":"uuid"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["quantity"],"additionalProperties":false},"minItems":1,"maxItems":50},"shipping":{"type":"object","properties":{"firstName":{"type":"string","minLength":1,"maxLength":150},"lastName":{"$ref":"#/properties/shipping/properties/firstName"},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string"},"line1":{"$ref":"#/properties/shipping/properties/firstName"},"line2":{"type":"string","maxLength":150,"default":""},"city":{"$ref":"#/properties/shipping/properties/firstName"},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"zip":{"type":"string","pattern":"^\\d{5}(-\\d{4})?$"},"country":{"type":"string","const":"US"}},"required":["firstName","lastName","email","phone","line1","city","state","zip","country"],"additionalProperties":false},"consent":{"type":"boolean","const":true},"couponCode":{"type":"string","maxLength":64},"campaignId":{"type":"string","pattern":"^[a-f0-9]{16}$"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["items","shipping","consent"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"validUntil":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"expiresAt":{"$ref":"#/properties/validUntil"},"lineItems":{"type":"array","items":{"type":"object","properties":{"photoId":{"type":"string","format":"uuid"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid"}},"productId":{"type":"string"},"quantity":{"type":"integer"},"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false}},"required":["productId","quantity"],"additionalProperties":false}}},"required":["id","price","validUntil","expiresAt","lineItems"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"create_print_order","description":"Create one order from the approved quote, which already contains buyer contact and address. Requires termsAccepted:true confirming acceptance of https://photoprintagent.com/terms with the buyer’s authorization, separately from buyerApproved:true. Never infer acceptance from an upload, quote, or previous order. Reuse the same idempotency key for retries. Returns a buyer card checkout URL or x402 payment URL; call pay_print_order for the challenge. A zero-total coupon order is submitted with buyerApproved:true and needs no card or wallet. Optional couponCode must match the approved quote.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"quoteId":{"type":"string","format":"uuid"},"couponCode":{"type":"string","maxLength":64},"idempotencyKey":{"type":"string","pattern":"^[-\\w]{16,100}$"},"buyerApproved":{"type":"boolean","const":true},"termsAccepted":{"type":"boolean","const":true,"description":"Required explicit acceptance of https://photoprintagent.com/terms for this order, with buyer authorization. Missing or false acceptance is rejected."},"method":{"type":"string","enum":["card","x402"],"default":"x402"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["quoteId","idempotencyKey","buyerApproved","termsAccepted"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/order/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/order/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/order/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/order/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/order/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/order/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/order/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/order/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false},"paymentUrl":{"type":"string"},"checkoutUrl":{"type":"string","format":"uri"}},"required":["order","checkoutUrl"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_payment_assets","description":"Public: search Base ERC-20 and ready Solana SPL / compatible Token-2022 payment candidates by name, ticker or exact contract/mint. No market-cap limit. Results are paginated; pass nextOffset as offset. Call quote_crypto_payment to verify the token and obtain a fresh price. Solana needs the merchant receiving account initialized.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"search":{"type":"string","maxLength":100,"default":""},"network":{"type":"string","enum":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"offset":{"type":"integer","minimum":0,"maximum":20000,"default":0},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"network":{"type":"string"},"priceStatus":{"type":"string","enum":["available","unavailable"]},"rankingSource":{"type":"string"},"catalogUpdatedAt":{"type":"string"},"catalogSource":{"type":"string","enum":["bundled","refreshed"]},"catalogStale":{"type":"boolean"},"assets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network"],"additionalProperties":false}},"networks":{"type":"array","items":{"type":"string"}},"total":{"type":"integer"},"offset":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"solanaPayTo":{"type":["string","null"]}},"required":["network","priceStatus","rankingSource","assets","networks","total","offset","nextOffset","solanaPayTo"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"quote_crypto_payment","description":"Lock an unpaid order in a listed token for up to 60 seconds. Obtain approval of this exact amount and include cryptoQuoteId in the payment retry.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"tokenId":{"type":"string","minLength":1,"maxLength":100},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId","tokenId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"usdPrice":{"type":"string"},"priceAsOf":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/priceAsOf"},"validUntil":{"$ref":"#/properties/priceAsOf"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"pay_print_order","description":"Request an x402 v2 challenge without a signature, or settle an approved signature and submit the paid print. Uses the same guarded payment flow as REST. An unsigned call returns payment_required in structuredContent (MCP HTTP 200). Never repay an ambiguous order.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"cryptoQuoteId":{"type":"string","format":"uuid"},"paymentSignature":{"type":"string","minLength":1,"maxLength":64000,"description":"Base64-encoded x402 v2 payload, same value as PAYMENT-SIGNATURE; never provide both."},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"status":{"type":"string","enum":["payment_required","order_status"]},"httpStatus":{"type":"number","enum":[200,402]},"payment_required":{"type":"object","properties":{"x402Version":{"type":"number","const":2},"resource":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"}},"required":["url"],"additionalProperties":false},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","additionalProperties":{}}},"required":["scheme","network","asset","amount","payTo","maxTimeoutSeconds"],"additionalProperties":false}},"error":{"type":"string"},"extensions":{"type":"object","additionalProperties":{}}},"required":["x402Version","resource","accepts"],"additionalProperties":false},"paymentRequiredHeader":{"type":"string"},"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/order/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/order/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/order/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/order/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/order/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/order/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/order/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/order/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/order/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false},"paymentResponse":{"type":"object","properties":{"success":{"type":"boolean"},"transaction":{"type":"string"},"network":{"type":"string"},"payer":{"type":"string"},"errorReason":{"type":"string"}},"required":["success","transaction","network"],"additionalProperties":true},"paymentResponseHeader":{"type":"string"}},"required":["status","httpStatus"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_admin_products","description":"List ready products including Admin Only products. Requires a verified allowlisted admin Firebase session; guest and agent keys cannot access private catalog products.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"widthInches":{"type":"number"},"heightInches":{"type":"number"},"artwork":{"type":"object","properties":{"widthPixels":{"type":"integer"},"heightPixels":{"type":"integer"},"minImages":{"type":"integer"},"maxImages":{"type":"integer"},"minimumDpi":{"type":"number"},"allowRotate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"string"}},"bleed":{"type":"object","additionalProperties":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}},"calendar":{"type":"object","properties":{"layout":{"type":"string","const":"alternating-photo-grid"},"months":{"type":"number","enum":[12,18]}},"required":["layout","months"],"additionalProperties":false},"composition":{"type":"object","properties":{"id":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"background":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["x","y","width","height"],"additionalProperties":false}}},"required":["id","width","height","background","slots"],"additionalProperties":false}},"required":["widthPixels","heightPixels","minImages","maxImages","minimumDpi","allowRotate","labels","bleed","issues"],"additionalProperties":false},"shipping":{"type":"object","properties":{"mode":{"type":"string","enum":["provider","flat","per_item"]},"amountCents":{"type":"integer","minimum":0,"maximum":100000,"default":0},"multipleItemAmountCents":{"anyOf":[{"$ref":"#/properties/products/items/properties/shipping/properties/amountCents"},{"type":"null"}],"default":null}},"required":["mode"],"additionalProperties":false},"adminOnly":{"type":"boolean"},"available":{"type":"boolean"},"unavailableReason":{"type":"string"},"preview":{"type":"object","additionalProperties":{}}},"required":["id","title","description","widthInches","heightInches"],"additionalProperties":true}}},"required":["products"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_photos","description":"List your unexpired, unlocked uploaded photos. Use their IDs in slot order. Photos reserved by an order cannot be deleted.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"productId":{"type":"string"},"artworkKey":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"quality":{"anyOf":[{"type":"string","enum":["high","reduced"]},{"type":"null"}]},"orientation":{"type":"string","enum":["portrait","landscape"]}},"required":["id","productId","artworkKey","width","height","quality","orientation"],"additionalProperties":false}}},"required":["photos"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_photo","description":"Get the private JPEG download endpoint for your uploaded photo. Send the same Bearer credential; this is not a public image URL.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"photoId":{"type":"string","format":"uuid"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["photoId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string","const":"GET"},"mimeType":{"type":"string","const":"image/jpeg"},"authorization":{"type":"string"}},"required":["url","method","mimeType","authorization"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"delete_photo","description":"Permanently delete one of your uploaded photos. Photos locked or reserved by an order cannot be deleted.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"photoId":{"type":"string","format":"uuid"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["photoId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"preview_print_item","description":"Preview one complete design using owned uploaded photoIds in product slot order. Reviewed compositions (including photobooth strips) render the same assembly used for fulfillment. For artwork.calendar, include calendar:{startYear,startMonth}; previews include the generated date grids in print page order. Other products return ordered flat artwork pages, not a physical mockup. JPEG thumbnails appear as MCP image content after the JSON metadata. Page with offset/limit; no order or external photo link is created.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200},"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false},"offset":{"type":"integer","minimum":0,"default":0},"limit":{"type":"integer","minimum":1,"maximum":4,"default":4},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["photoIds"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"productId":{"type":"string"},"kind":{"type":"string","enum":["composition","artwork_pages","calendar"]},"layoutId":{"type":["string","null"]},"totalPages":{"type":"integer"},"nextOffset":{"anyOf":[{"type":"integer"},{"type":"null"}]},"pages":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"label":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}},"required":["index","label","width","height"],"additionalProperties":false}}},"required":["productId","kind","layoutId","totalPages","nextOffset","pages"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"preview_print_price","description":"Estimate product and destination pricing before using the customer’s photos for an order. Uses placeholder artwork and does not create an order or a payable quote. Call quote_prints with buyer consent before checkout.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"items":{"type":"array","items":{"type":"object","properties":{"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false},"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"photoId":{"type":"string","format":"uuid"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["quantity"],"additionalProperties":false},"minItems":1,"maxItems":50},"shipping":{"type":"object","properties":{"firstName":{"type":"string","minLength":1,"maxLength":150},"lastName":{"$ref":"#/properties/shipping/properties/firstName"},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string"},"line1":{"$ref":"#/properties/shipping/properties/firstName"},"line2":{"type":"string","maxLength":150,"default":""},"city":{"$ref":"#/properties/shipping/properties/firstName"},"state":{"type":"string","pattern":"^[A-Z]{2}$"},"zip":{"type":"string","pattern":"^\\d{5}(-\\d{4})?$"},"country":{"type":"string","const":"US"}},"required":["firstName","lastName","email","phone","line1","city","state","zip","country"],"additionalProperties":false},"couponCode":{"type":"string","maxLength":64},"campaignId":{"type":"string","pattern":"^[a-f0-9]{16}$"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["items","shipping"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"preview":{"type":"boolean","const":true},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"validUntil":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"expiresAt":{"$ref":"#/properties/validUntil"},"lineItems":{"type":"array","items":{"type":"object","properties":{"photoId":{"type":"string","format":"uuid"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid"}},"productId":{"type":"string"},"quantity":{"type":"integer"},"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false}},"required":["productId","quantity"],"additionalProperties":false}}},"required":["preview","price","validUntil","expiresAt","lineItems"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_orders","description":"List your most recent orders, newest first, up to 50. Does not reconcile payments; use get_order for a specific order. Unpaid Admin Only orders require a verified admin session.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":50,"default":50},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/orders/items/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/orders/items/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/orders/items/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/orders/items/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/orders/items/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/orders/items/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_checkout_link","description":"Mint a private on-site checkout link for your existing order. Preserve its access fragment, share only with the buyer, and never create another order to recover a checkout. Card payment uses the embedded payment modal; MCP never accepts card details.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"checkoutUrl":{"type":"string","format":"uri"}},"required":["checkoutUrl"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"update_order_coupon","description":"Apply or remove a coupon on your eligible unpaid x402 order; empty couponCode removes it. Check canEditCoupon first. Returns the revised price and pricingVersion, invalidates old crypto quotes, and never requests payment. Obtain approval of the new total before paying. Card or ambiguous payments cannot be changed.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"couponCode":{"type":"string","maxLength":64},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId","couponCode"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"confirm_complimentary_order","description":"Explicitly approve fulfillment of your existing zero-total order after a coupon change. Requires buyerApproved:true and the current pricingVersion. Original order terms consent remains required. Idempotent for an already confirmed complimentary order; never use this for a positive total.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"buyerApproved":{"type":"boolean","const":true},"pricingVersion":{"type":"integer","minimum":0},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId","buyerApproved","pricingVersion"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_agent_keys","description":"List your account key IDs and expiry/revocation status, never their secrets. Requires a verified Firebase account session; guest and agent keys cannot manage keys.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"expiresAt":{"$ref":"#/properties/keys/items/properties/createdAt"},"revoked":{"type":"boolean"}},"required":["id","createdAt","expiresAt","revoked"],"additionalProperties":false}}},"required":["keys"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"revoke_agent_key","description":"Revoke one of your account keys by ID. Requires a verified Firebase account session; guest and agent keys cannot manage keys.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"inputSchema":{"type":"object","properties":{"keyId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"}},"required":["keyId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"get_order","description":"Read your private order. Payment and fulfillment states are separate; processing means PhotoPrintAgent accepted the order for processing, not shipped. Use only PhotoPrintAgent branding and the returned customer status in updates. Does not initiate charges. Polling also verifies a completed card checkout with the processor.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"guestToken":{"type":"string","pattern":"^ppg_[a-f0-9]{64}$","description":"Private guest credential; omit when Authorization Bearer is present."}},"required":["orderId"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"outputSchema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"description":"Integer USD cents"},"shipping":{"$ref":"#/properties/price/properties/subtotal"},"tax":{"$ref":"#/properties/price/properties/subtotal"},"total":{"$ref":"#/properties/price/properties/subtotal"},"originalTotal":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"discount":{"$ref":"#/properties/price/properties/subtotal","description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"$ref":"#/properties/price/properties/subtotal"},"shippingDiscount":{"$ref":"#/properties/price/properties/subtotal"},"taxCredit":{"$ref":"#/properties/price/properties/subtotal"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0},"paymentDeadline":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"},"canEditCoupon":{"type":"boolean"},"canRenewCheckout":{"type":"boolean"},"cardPaymentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cardProcessor":{"anyOf":[{"type":"string","enum":["square","stripe"]},{"type":"null"}]},"quantity":{"type":"integer"},"productName":{"type":"string"},"imageCount":{"type":"integer"},"createdAt":{"$ref":"#/properties/paymentDeadline"},"paidAt":{"anyOf":[{"$ref":"#/properties/paymentDeadline"},{"type":"null"}],"description":"Unix time in milliseconds"},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"cryptoPayment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer"},"transferMethod":{"type":"string","enum":["eip3009","permit2","spl"]},"network":{"type":"string"},"tokenProgram":{"type":"string"},"rank":{"type":["number","null"]},"wrapped":{"type":"boolean"},"stable":{"type":"boolean"},"availability":{"type":"string","enum":["quote_required","receiving_ready"]},"priceChecked":{"type":"boolean"},"tokenId":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+$"},"displayAmount":{"type":"string"},"usdTotal":{"$ref":"#/properties/price/properties/subtotal"},"usdPrice":{"type":"string"},"priceAsOf":{"$ref":"#/properties/paymentDeadline"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"$ref":"#/properties/paymentDeadline"},"validUntil":{"$ref":"#/properties/paymentDeadline"}},"required":["id","rankId","name","symbol","asset","decimals","transferMethod","network","tokenId","amount","displayAmount","usdTotal","usdPrice","priceAsOf","source","payTo","quotedAt","validUntil"],"additionalProperties":false},{"type":"null"}]},"transaction":{"type":["string","null"]},"network":{"type":["string","null"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","method","price","pricingVersion","paymentDeadline","canEditCoupon","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","cryptoPayment","transaction","network","trackingUrls","message"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"uploadResponseSchema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"productId":{"type":"string"},"artworkKey":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"},"quality":{"type":"string","enum":["high","reduced"]},"sourceFormat":{"type":"string"},"sourceImages":{"type":"integer","exclusiveMinimum":0},"expiresAt":{"type":"integer","minimum":0,"description":"Unix time in milliseconds"}},"required":["id","width","height","quality","expiresAt"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}