photoprintagent

FOR AGENTS & DEVELOPERS

Build photo printing into your app.

PhotoPrintAgent offers an MCP API for photo printing and U.S. home delivery. Discover public products, upload images, preview designs, get a quote and track orders. Start as a guest, or connect your account with OAuth or an agent key.

THREE WAYS TO CONNECT

Choose your MCP connection

Start with the narrow connector for a straightforward chat-to-print experience. Choose a broader connection when your integration needs it.

For chat-based print orders

Narrow MCP

A focused connector for finding prints, uploading photos, previewing, quoting, preparing approved orders and tracking delivery.

Access. Guest sessions need no PhotoPrintAgent sign-in or account. Optional OAuth connects an existing account.

Returns a private link for on-site card checkout. It cannot execute payments.

For complete commerce integrations

Full commerce MCP

The broader customer toolkit, including order management, agent keys, event subscriptions and supported payment integrations.

Access. Public browsing and guest checkout, with OAuth or agent keys for account access.

Use only the scopes and payment capabilities your integration needs. Buyer approval is required.

For business integrations

Commercial MCP

Business onboarding, production access applications, approved credentials and commercial ordering tools.

Access. OAuth manages applications. Production ordering requires administrator approval and commercial credentials.

Complete a sandbox test, submit the application and check its returned ID and status before requesting production credentials.

COMMERCIAL API ACCESS

Test your integration. Then apply to go live.

Choose the outcome you want. A successful sandbox test does not submit a production application.

01 · EXPLORE

Try the complete test flow

Use sample artwork to verify a simulated order and webhook. No payment, production fulfillment or business application.

Test in sandboxFinish with: simulation verified; no production application submitted.
02 · ONBOARD

Bring your application to production

Ask your agent to prepare your business application after the sandbox test. Review the private email, confirm your details and fund the $100 opening credit on this site.

Apply for production accessNo account is needed to start. Verified payment submits the application; your agent can read its receipt. Pending means awaiting review.

Blocked along the way? Your agent should name the missing input, sign-in or authorization step and tell you whether an application was received. Opening this guide does not submit an application.

Start a sandbox

Test a glossy 4×6 order from upload to signed webhook. No account or inbox is needed. Sandbox orders cannot charge a payment method or enter fulfillment.

Complete setup guide · Machine-readable contract · Download the runnable Node.js example

Sandbox MCP endpoint: https://photoprintagent.com/mcp/sandbox

Use only sample artwork and the synthetic address from the guide. The example can provision and revoke its own sandbox without using this form. For a sandbox-only run, verify the simulated order and report: “Simulation verified. No production application was submitted.”

Ready to onboard? Continue to the production application steps. Retain the completed sandbox order ID and private credential; a successful test alone does not create an application.

From connection to checkout

  1. Add the endpoint above to a client that supports remote MCP over Streamable HTTP.
  2. For narrow guest checkout, call start_guest_checkout once and keep its token private. Give the buyer the returned terms setup link. No PhotoPrintAgent account is needed. For an existing account, use OAuth and review permissions and applicable terms together.
  3. Use list_products, upload the photo, preview the print and request a quote. Ask the buyer to approve the photos, delivery address and final total. Current setup acceptance covers the order terms; otherwise obtain explicit acceptance before creating the order.
  4. Create the approved, unpaid order and use get_checkout_link for on-site card checkout. The buyer completes payment, then the agent can track the order.

The full and commercial guides explain their additional access and payment options. Keep guest tokens, credentials, private setup links and checkout links out of public logs.

DEVELOPER DOCUMENTATION

Payments for agent integrations

Integrations can create an approved print order for card checkout or use x402 for an authorized crypto payment. The customer’s quoted total is in USD. Check the live API for supported assets, networks and availability before offering a payment method.

x402 and supported networks

Read list_products for payment readiness and list_payment_assets for eligible assets. Base and Solana availability depends on the current configuration. Use quote_crypto_payment to obtain the exact token amount and expiry, then follow the x402 v2 signing flow in the integration guide. A token quote is valid for up to 60 seconds.

Buyer approval and payment recovery

Obtain approval of the photos, delivery address, full price and exact payment amount, plus acceptance of the order terms. Reuse the same order and idempotency key for retries. If payment status is uncertain, check that order before attempting payment again.

Never request card numbers, wallet recovery phrases, private keys or passwords in chat or tool arguments. Public blockchain payments expose transaction amounts and wallet addresses; photos and delivery details are not intentionally included in those transactions. See the privacy policy.