com.photoprintagent/mcp · v2.4.0 · ecommerce
PhotoPrintAgent is healthy: it completed an MCP handshake in 1960 ms and exposes 30 tools.
Browse, design and order photo prints for US delivery, with previews, quotes and order tracking.
Endpoint: https://photoprintagent.com/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 30 |
| Latency | 1960 ms |
| Last checked (UTC) | 2026-11-02T01:50:28.589Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-02T01:50:28.589Z | Healthy | 1960 |
get_checkout_options | Public account and guest authentication instructions, current order terms URL/version, and required acceptance field. |
start_guest_checkout | Public: mint a private guest credential once. No account, payment or print is created. Save it in a secret store. |
create_agent_key | Mint a 90-day account key using a verified Firebase ID token in Authorization. Guests and existing agent keys cannot mint keys. |
list_products | Public paginated product catalog, print specifications, and availability. Follow nextOffset until null. availableOnly defaults to true; false includes unavailable public products with explicit available flags. Filters cover query, category, finish, dimensions and known unit price range. capabilities |
create_upload | 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. POS |
quote_prints | 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,quan |
create_print_order | 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 prev |
list_payment_assets | 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 |
quote_crypto_payment | 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. |
pay_print_order | 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. |
list_admin_products | List ready products including Admin Only products. Requires a verified allowlisted admin Firebase session; guest and agent keys cannot access private catalog products. |
list_photos | List your unexpired, unlocked uploaded photos. Use their IDs in slot order. Photos reserved by an order cannot be deleted. |
get_photo | Get the private JPEG download endpoint for your uploaded photo. Send the same Bearer credential; this is not a public image URL. |
delete_photo | Permanently delete one of your uploaded photos. Photos locked or reserved by an order cannot be deleted. |
preview_print_item | 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 o |
preview_print_price | 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. |
list_orders | 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. |
get_checkout_link | 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. |
update_order_coupon | 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 can |
confirm_complimentary_order | 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. |
list_agent_keys | 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. |
revoke_agent_key | Revoke one of your account keys by ID. Requires a verified Firebase account session; guest and agent keys cannot manage keys. |
get_order | 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 verifies a completed card checkout |
estimate_print_price | Estimate 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. |
get_order_events | Read 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. |
request_order_help | Create 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. |
subscribe_order_events | Subscribe an owned order to an HTTPS webhook you control. Requires permission to send this order status to that endpoint. Returns a signing secret once. At-least-once delivery; verify timestamp/signature and deduplicate orderId + sequence. Repeated failures pause delivery; use event history for reco |
list_order_subscriptions | List your webhook destinations and delivery status for an owned order. Signing secrets are never returned. |
replay_order_events | Resume a failed subscription or replay events after a saved sequence. Requires authorization to resend order status to the registered destination; no payments or orders are repeated. |
unsubscribe_order_events | Disable one of your webhook subscriptions and erase its signing secret. |