Skip to content
Official MCP RegistryListed

PhotoPrintAgent Narrow

Part ofPhotoPrintAgent NarrowMCP server

Browse photo prints, estimate delivery prices, prepare uploads and track orders with scoped OAuth.

First seen 1 Nov 2026. Evidence as of 18 Nov 2026.

15
Tools
From an anonymous probe
1
Source listings
Each with its own history
30
Recorded changes
Since first seen

Tools

ToolDescriptionBehaviour
create_print_orderCreate one buyer-approved order from a saved quote. Requires explicit termsAccepted and buyerApproved. Save orderReference and idempotencyKey first; retry identical input with the same key, or recover with lookup_order. Returns private on-site checkout. Zero-total orders submit without payment. Coupon must match the approved quote.Destructive
create_uploadPrepare a private binary upload. Supply productId from list_products; POST image bytes separately to uploadUrl with the returned headers and credential. No storage is allocated until POST. Reuse an Idempotency-Key for identical bytes/options; GET /api/uploads/{key} recovers a lost response. No base64 or remote image URLs in MCP. Read returned image limits. SDK: /sdk/photo-upload.mjs.Destructive
estimate_print_priceEstimate configured product and shipping charges using only product, quantity, ZIP and state. No photos or contact details required. Unknown tax or charges remain null; this is not a payable quote.Read-only
get_checkout_linkMint 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.Destructive
get_orderRead your saved order status without payment reconciliation or print submission. Status may lag processing. No payment or printing side effects.Read-only
get_order_eventsRead your customer-safe order events in sequence. Save the last sequence as after for incremental recovery; duplicate events must be deduplicated by orderId and sequence.Read-only
get_upload_statusRecover a private image upload by its original idempotencyKey. Returns its photo ID when complete, without downloading or uploading again. Processing means wait; retryable means repeat the original upload.Read-only
import_photoImport an attached or generated ChatGPT image directly into your private print photos. Use the file supplied by ChatGPT, a catalog productId, crop options and a stable idempotencyKey. Returns the photo ID for preview and quoting. Retrying identical image bytes/options with the same key is safe. No website upload is needed.Destructive
list_ordersRead up to 50 recent owned orders, newest first. Saved state only; no payment reconciliation.Read-only
list_photosList your unexpired, unlocked uploaded photos. Use their IDs in slot order. Photos reserved by an order cannot be deleted.Read-only
list_productsBrowse available products, 4x6 first. Use returned products[].id for uploads and quotes. Filter by size, finish, category, price or query. Follow nextOffset; includeDetails:true adds artwork, shipping and fit specifications. availableOnly:false also includes unavailable public listings. Prices exclude shipping/tax; quote_prints returns a payable total.Read-only
lookup_orderRecover by exactly one of orderReference or original idempotencyKey, within the current account/session. Reads saved status only. found:false may race an in-flight commit; paid:null is unknown. Neither authorizes a replacement order or payment.Read-only
preview_print_itemPreview owned photoIds in product slot order. Calendars require startYear/startMonth and include generated grids. Compositions use their configured assembly. Other products return flat artwork pages. JPEG thumbnails accompany metadata; offset/limit paginate. No order or public image link is created.Read-only
quote_printsSave a quote for owned photos and a US address with buyer consent. Use productId from list_products. Single-image items use photoId; multi-image items use ordered photoIds. For calendars include startYear/startMonth and upload cover/month photos only; the service generates grids. For compositions upload separate slot images. Quantity counts complete products. Returned totals include shipping, tax and any validated coupon.Destructive
request_order_helpCreate an order-bound support, address-change, cancellation or refund REQUEST. Requires buyer authorization. No cancellation, refund or change is executed or guaranteed. Reuse idempotencyKey when retrying the same request; read progress capability flags first.Destructive

Change history

  1. request_order_help: annotations changed
  2. quote_prints: description changed (+"Save a quote for owned photos" +"address with buyer consent. Use" +"list_products. Single-image items")
  3. quote_prints: annotations changed
  4. preview_print_item: description changed (+"Calendars require startYear/startMonth and" +"grids. Compositions use their configured assembly." +"pages.")
  5. lookup_order: description changed (+"Recover" +"within the" +"account/session. Reads saved status only.")
  6. list_products: input schema changed (+includeDetails)
  7. list_products: description changed (+"Browse" +"products, 4x6 first. Use returned products[].id" +"Filter by size, finish, category, price or query. Follow nextOffset; includeDetails:true adds artwork, shipping")
  8. list_orders: description changed (+"Read up to 50" +"owned" +"first. Saved state only; no payment reconciliation.")
  9. import_photo: tool added
  10. get_upload_status: tool added
  11. get_order: description changed (+"processing. No payment or printing side effects." -"processing; report unknown explicitly. Complete checkout on the website.")
  12. get_checkout_link: tool added
  13. create_upload: tool added
  14. create_print_order: tool added
  15. server instructions changed (+"focused print ordering. Import attached/generated chat images with import_photo," +"artwork, quote delivery and" +"buyer-approved card orders with create_print_order. OAuth mcp:write allows uploads/quotes; mcp:orders requires separate connection consent. Never collect card credentials in chat. New-card payment currently uses the returned secure checkout; native ChatGPT")
  16. lookup_order: tool added
  17. list_orders: input schema changed
  18. get_order_events: input schema changed
  19. get_order: input schema changed
  20. list_products: input schema changed
  21. request_order_help: input schema changed
  22. quote_prints: input schema changed
  23. preview_print_item: input schema changed
  24. list_products: input schema changed
  25. list_photos: input schema changed
  26. list_orders: input schema changed
  27. get_order_events: input schema changed
  28. get_order: input schema changed
  29. preview_print_price: tool removed
  30. Listed (registry)
Source listings
SourceListingFirst seenLast seenVersions
Official MCP Registrycom.photoprintagent/mcp-narrow1 Nov 202618 Nov 20261