{"name":"PhotoPrintAgent Narrow","version":"2.7.4","url":"https://photoprintagent.com/mcp-narrow","aliases":["https://photoprintagent.com/api/mcp-narrow","https://photoprintagent.com/api/mcp-claude"],"transport":"streamable-http","authentication":{"type":"mixed","accountRequired":false,"guestTool":"start_guest_checkout","guestKeyPrefix":"ppg_","resource":"https://photoprintagent.com/mcp-narrow","resourceMetadata":"https://photoprintagent.com/.well-known/oauth-protected-resource/mcp-narrow","scopes":["mcp:read","mcp:write","mcp:orders"]},"instructions":"PhotoPrintAgent guest print ordering. No PhotoPrintAgent sign-in or account is required. Without an existing account connection, call start_guest_checkout once and keep its token privately in tool state. Pass guestToken on later photo, quote and order tools; never display it or put it in a URL. Before collecting or sharing delivery details call get_checkout_preferences. If expressOrder.enabled is true, the buyer preapproved sharing their home address, email and phone already available in ChatGPT with PhotoPrintAgent to prepare the requested order. This does not unlock memory or other apps or override client privacy controls. Ask for missing or ambiguous details; if disabled, obtain permission before sharing saved contact details. Never enable Express Order or accept its checkbox for the buyer. Inspect attached/generated images before import_photo. Automatically correct clearly sideways or upside-down content using crop.rotation (0, 90, 180 or 270 clockwise, after EXIF), preserving intentional orientation. Set crop.orientation to portrait or landscape to match the corrected image; do not turn upright content sideways to fill the paper. Ask if orientation is ambiguous. Show the corrected preview before order approval. To change a prepared image, reimport the original with a new idempotency key; exact retries keep the original key. Then quote delivery and show the address, contact details and total for final approval. At guest setup show the buyer the private termsSetupUrl for one-click terms acceptance. Account customers can accept during connection setup. Never open a consent link or accept terms for the buyer. If quote_prints returns setupTermsAccepted:true, ask only for approval of the photos, delivery address and final total, then omit termsAccepted. If false, a guest can click the private setup link or an existing account can reconnect to save the current terms. If the buyer completes setup after the quote, omit termsAccepted and let the server verify acceptance. Alternatively ask for agreement to the linked terms and approval of the displayed order in a single confirmation. A click or an affirmative answer to that explicit question suffices; never require a typed phrase. Always obtain explicit order approval before create_print_order. Save the idempotency key and orderReference first; retry the same input or use lookup_order after an uncertain response. Open only the returned private order-specific checkout link for payment in the website modal; no website upload or account creation is needed. Never collect card credentials in chat. An existing OAuth connection still requires its granted read/write/order scopes; never mix OAuth and guest credentials. Guest checkout preparation expires after 24 hours; saved-order access lasts 30 days. Do not replace or pay an ambiguous order. No payment-execution tool is available. Zero-total orders require the same explicit order approval and current terms acceptance. Native ChatGPT new-card payment is not enabled. Status is saved state; unknown is not shipped. Use only PhotoPrintAgent branding and do not disclose supplier details. Guide: https://photoprintagent.com/docs/mcp-narrow.","tools":[{"name":"get_checkout_preferences","title":"Get Checkout Preferences","description":"Read this connection or guest session’s saved Express Order sharing choice before collecting delivery details. Returns consent only, never contact details. If enabled, use only home address, email and phone already available in ChatGPT for the requested order; ask for missing or ambiguous details. Client privacy controls and final order/payment approval still apply. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"expressOrder":{"type":"object","properties":{"enabled":{"type":"boolean"},"fields":{"type":"array","items":{"type":"string","enum":["homeAddress","email","phone"]}},"source":{"type":"string","const":"chatgpt_available_context"},"purpose":{"type":"string","const":"prepare_print_orders"},"requiresOrderApproval":{"type":"boolean","const":true},"permissionNotice":{"type":"string"}},"required":["enabled","fields","source","purpose","requiresOrderApproval","permissionNotice"],"additionalProperties":false},"setupTermsAccepted":{"type":"boolean"}},"required":["expressOrder","setupTermsAccepted"],"additionalProperties":false}},{"name":"start_guest_checkout","title":"Start Guest Checkout","description":"Start private guest print preparation without sign-in or account creation. Call once, retain the returned token privately and pass guestToken to later tools. Show the buyer termsSetupUrl so they can accept once for this session. Preparation lasts 24 hours; saved-order access lasts 30 days.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}]},"requiredScope":null,"inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"token":{"type":"string"},"guestApiKey":{"type":"string"},"checkoutUntil":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"tokenType":{"type":"string","const":"Bearer"},"instructions":{"type":"string"},"termsSetupUrl":{"type":"string","format":"uri"},"terms":{"type":"object","properties":{"url":{"type":"string","const":"https://photoprintagent.com/terms"},"version":{"type":"string","const":"2026-11-11"},"acceptanceField":{"type":"string","const":"termsAccepted"}},"required":["url","version","acceptanceField"],"additionalProperties":false}},"required":["token","guestApiKey","checkoutUntil","expiresAt","tokenType","instructions","termsSetupUrl","terms"],"additionalProperties":false}},{"name":"list_products","title":"List Products","description":"Browse 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.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}]},"requiredScope":null,"inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"query":{"type":"string","maxLength":100},"category":{"type":"string","maxLength":80},"finish":{"type":"string","maxLength":80},"widthInches":{"type":"number","exclusiveMinimum":0,"maximum":1000},"heightInches":{"type":"number","exclusiveMinimum":0,"maximum":1000},"minPriceCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxPriceCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"includeDetails":{"default":false,"type":"boolean"},"availableOnly":{"default":true,"type":"boolean"},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"default":12,"type":"integer","minimum":1,"maximum":200}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"product":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"productCode":{"type":"string"},"title":{"type":"string"},"specs":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","title"],"additionalProperties":false},{"type":"null"}]},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"productCode":{"type":"string","pattern":"^PPA[A-F0-9]{12}$"},"sku":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"unitPriceCents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},{"type":"null"}]},"category":{"type":"string"},"finish":{"type":"string"},"size":{"type":"string"},"widthInches":{"type":"number"},"heightInches":{"type":"number"},"artwork":{"type":"object","properties":{"qualityGuidance":{"type":"object","properties":{"recommendedDpi":{"type":"number"},"minimumDpiIsRejectionThreshold":{"type":"boolean"},"fitModes":{"type":"array","items":{"type":"string"}},"fitDescription":{"type":"string"}},"required":["recommendedDpi","minimumDpiIsRejectionThreshold","fitModes","fitDescription"],"additionalProperties":false},"widthPixels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"heightPixels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"minImages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxImages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"minimumDpi":{"type":"number"},"allowRotate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"string"}},"bleed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}},"calendar":{"type":"object","properties":{"layout":{"type":"string","const":"alternating-photo-grid"},"months":{"anyOf":[{"type":"number","const":12},{"type":"number","const":18}]}},"required":["layout","months"],"additionalProperties":false},"composition":{"type":"object","properties":{"id":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"background":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"y":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"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},"multipleItemAmountCents":{"anyOf":[{"type":"integer","minimum":0,"maximum":100000},{"type":"null"}]}},"required":["mode","amountCents","multipleItemAmountCents"],"additionalProperties":false},"adminOnly":{"type":"boolean"},"available":{"type":"boolean"},"unavailableReason":{"type":"string"},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"workflow":{"type":"string"}},"required":["id","title","widthInches","heightInches"],"additionalProperties":{}}},"orderingAvailable":{"type":"boolean"},"total":{"type":"number"},"nextOffset":{"type":["number","null"]},"deliveryEstimate":{"type":"string"},"capabilities":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"supported":{"type":"boolean"},"availableToOrder":{"type":"boolean"},"productCount":{"type":"number"}},"required":["supported","availableToOrder","productCount"],"additionalProperties":false}},"priceFilterBasis":{"type":"string"}},"required":["product","products","orderingAvailable","total","nextOffset","capabilities","priceFilterBasis"],"additionalProperties":false}},{"name":"import_photo","title":"Import Photo","description":"Import 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"openai/fileParams":["file"],"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:write"]}]},"requiredScope":"mcp:write","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"file":{"type":"object","properties":{"download_url":{"type":"string","maxLength":8192,"format":"uri"},"file_id":{"type":"string","minLength":1,"maxLength":300},"mime_type":{"type":"string","maxLength":150},"file_name":{"type":"string","maxLength":500}},"required":["download_url","file_id"],"additionalProperties":false},"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"crop":{"type":"object","properties":{"fit":{"default":"cover","type":"string","enum":["cover","contain"]},"orientation":{"default":"landscape","type":"string","enum":["landscape","portrait"]},"rotation":{"description":"Clockwise image rotation after EXIF orientation, before cropping. Inspect the image and correct clearly sideways or upside-down content automatically; preserve intentional orientation. Choose portrait/landscape separately to match the corrected image.","anyOf":[{"type":"number","const":0},{"type":"number","const":90},{"type":"number","const":180},{"type":"number","const":270}]},"x":{"default":50,"type":"number","minimum":0,"maximum":100},"y":{"default":50,"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"idempotencyKey":{"type":"string","pattern":"^[\\w-]{16,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["file","idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string"},"artworkKey":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"quality":{"type":"string","enum":["high","reduced"]},"sourceFormat":{"type":"string"},"sourceImages":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"}},"required":["id","width","height","quality","expiresAt"],"additionalProperties":false}},{"name":"get_upload_status","title":"Get Upload Status","description":"Recover 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"idempotencyKey":{"type":"string","pattern":"^[\\w-]{16,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"status":{"type":"string","enum":["complete","processing","retryable"]},"photo":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string"},"artworkKey":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"quality":{"type":"string","enum":["high","reduced"]},"sourceFormat":{"type":"string"},"sourceImages":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"}},"required":["id","width","height","quality","expiresAt"],"additionalProperties":false},{"type":"null"}]}},"required":["status","photo"],"additionalProperties":false}},{"name":"create_upload","title":"Create Upload","description":"Prepare 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:write"]}]},"requiredScope":"mcp:write","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"crop":{"type":"object","properties":{"fit":{"default":"cover","type":"string","enum":["cover","contain"]},"orientation":{"default":"landscape","type":"string","enum":["landscape","portrait"]},"rotation":{"description":"Clockwise image rotation after EXIF orientation, before cropping. Inspect the image and correct clearly sideways or upside-down content automatically; preserve intentional orientation. Choose portrait/landscape separately to match the corrected image.","anyOf":[{"type":"number","const":0},{"type":"number","const":90},{"type":"number","const":180},{"type":"number","const":270}]},"x":{"default":50,"type":"number","minimum":0,"maximum":100},"y":{"default":50,"type":"number","minimum":0,"maximum":100}},"additionalProperties":false},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","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","minimum":-9007199254740991,"maximum":9007199254740991},"maxInputPixels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"helpUrl":{"type":"string","format":"uri"},"responseSchemaUrl":{"type":"string","format":"uri"},"artwork":{"type":"object","properties":{"qualityGuidance":{"type":"object","properties":{"recommendedDpi":{"type":"number"},"minimumDpiIsRejectionThreshold":{"type":"boolean"},"fitModes":{"type":"array","items":{"type":"string"}},"fitDescription":{"type":"string"}},"required":["recommendedDpi","minimumDpiIsRejectionThreshold","fitModes","fitDescription"],"additionalProperties":false},"widthPixels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"heightPixels":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"minImages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxImages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"minimumDpi":{"type":"number"},"allowRotate":{"type":"boolean"},"labels":{"type":"array","items":{"type":"string"}},"bleed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"issues":{"type":"array","items":{"type":"string"}},"calendar":{"type":"object","properties":{"layout":{"type":"string","const":"alternating-photo-grid"},"months":{"anyOf":[{"type":"number","const":12},{"type":"number","const":18}]}},"required":["layout","months"],"additionalProperties":false},"composition":{"type":"object","properties":{"id":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"background":{"type":"string"},"slots":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"y":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"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}},{"name":"list_photos","title":"List Photos","description":"List your unexpired, unlocked uploaded photos. Use their IDs in slot order. Photos reserved by an order cannot be deleted. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"productId":{"type":"string"},"artworkKey":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"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}},{"name":"preview_print_item","title":"Preview Print Item","description":"Preview 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"ui":{"resourceUri":"ui://photoprintagent/print-preview-v1.html"},"openai/outputTemplate":"ui://photoprintagent/print-preview-v1.html","securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"photoIds":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"calendar":{"type":"object","properties":{"startYear":{"type":"integer","minimum":2000,"maximum":2100},"startMonth":{"type":"integer","minimum":1,"maximum":12}},"required":["startYear","startMonth"],"additionalProperties":false},"offset":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"limit":{"default":4,"type":"integer","minimum":1,"maximum":4},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["photoIds"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"productId":{"type":"string"},"kind":{"type":"string","enum":["composition","artwork_pages","calendar"]},"layoutId":{"type":["string","null"]},"totalPages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nextOffset":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"pages":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"label":{"type":"string"},"width":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"height":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["index","label","width","height"],"additionalProperties":false}}},"required":["productId","kind","layoutId","totalPages","nextOffset","pages"],"additionalProperties":false}},{"name":"estimate_print_price","title":"Estimate Print Price","description":"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.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"}]},"requiredScope":null,"inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":64},"quantity":{"type":"integer","minimum":1,"maximum":500},"zip":{"type":"string","pattern":"^\\d{5}$"},"state":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["productId","quantity","zip","state"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"estimate":{"type":"boolean","const":true},"currency":{"type":"string","const":"USD"},"productId":{"type":"string"},"quantity":{"type":"number"},"subtotal":{"type":["number","null"]},"shipping":{"type":["number","null"]},"tax":{"type":["number","null"]},"total":{"type":["number","null"]},"knownAmount":{"type":"number"},"unknownComponents":{"type":"array","items":{"type":"string"}},"requiresFinalQuote":{"type":"boolean","const":true},"message":{"type":"string"}},"required":["estimate","currency","productId","quantity","subtotal","shipping","tax","total","knownAmount","unknownComponents","requiresFinalQuote","message"],"additionalProperties":false}},{"name":"quote_prints","title":"Quote Prints","description":"Save 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:write"]}]},"requiredScope":"mcp:write","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"productId":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,63}$"},"items":{"minItems":1,"maxItems":50,"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","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"photoIds":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["quantity"],"additionalProperties":false}},"shipping":{"type":"object","properties":{"firstName":{"type":"string","minLength":1,"maxLength":150},"lastName":{"type":"string","minLength":1,"maxLength":150},"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"},"line1":{"type":"string","minLength":1,"maxLength":150},"line2":{"default":"","type":"string","maxLength":150},"city":{"type":"string","minLength":1,"maxLength":150},"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":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["items","shipping","consent"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shipping":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"originalTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"discount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shippingDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"taxCredit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"validUntil":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"expiresAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"lineItems":{"type":"array","items":{"type":"object","properties":{"photoId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"photoIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"productId":{"type":"string"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"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}},"setupTermsAccepted":{"type":"boolean","description":"The authenticated buyer already accepted the current terms at setup. Always confirm the quoted order and total."}},"required":["id","price","validUntil","expiresAt","lineItems","setupTermsAccepted"],"additionalProperties":false}},{"name":"create_print_order","title":"Create Print Order","description":"Create one order after the buyer approves the photos, address and final quoted total. Use saved setup terms when available. Otherwise obtain explicit agreement to the linked terms with that same approval. No prescribed wording. Reuse the same idempotency key for retries. Returns private on-site checkout. Zero-total orders can start printing immediately. Pass guestToken only for guest checkout.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:orders"]}]},"requiredScope":"mcp:orders","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"quoteId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"couponCode":{"type":"string","maxLength":64},"idempotencyKey":{"type":"string","pattern":"^[-\\w]{16,100}$"},"orderReference":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},"buyerApproved":{"type":"boolean","const":true},"termsAccepted":{"description":"Omit when the buyer has accepted the current terms at setup. Otherwise send true only after the buyer explicitly agrees to https://photoprintagent.com/terms for this order.","type":"boolean","const":true},"method":{"default":"card","type":"string","const":"card"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["quoteId","idempotencyKey","buyerApproved"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"orderReference":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},{"type":"null"}]},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"method":{"type":"string","enum":["card","x402","prepaid"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shipping":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"originalTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"discount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shippingDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"taxCredit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"paymentDeadline":{"type":"integer","minimum":0,"maximum":9007199254740991,"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","minimum":-9007199254740991,"maximum":9007199254740991},"progress":{"type":"object","properties":{"productionStatus":{"type":"string","enum":["not_submitted","queued","submitting","accepted","printing","shipped","delivered","cancelled","on_hold","needs_review","unknown"]},"shipmentStatus":{"type":"string","enum":["unknown","shipped","delivered"]},"lastUpdatedAt":{"type":["number","null"]},"trackingUrls":{"type":"array","items":{"type":"string"}},"supportStatus":{"type":"string","enum":["none","open","waiting_customer","under_review","resolved"]},"canRequestCancellation":{"type":"boolean"},"canRequestChange":{"type":"boolean"},"canRequestRefund":{"type":"boolean"},"cancellationGuaranteed":{"type":"boolean","const":false}},"required":["productionStatus","shipmentStatus","lastUpdatedAt","trackingUrls","supportStatus","canRequestCancellation","canRequestChange","canRequestRefund","cancellationGuaranteed"],"additionalProperties":false},"productName":{"type":"string"},"imageCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"paidAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},{"type":"null"}]},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","refunded","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","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rankId":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"asset":{"type":"string"},"decimals":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"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,"maximum":9007199254740991,"description":"Integer USD cents"},"usdPrice":{"type":"string"},"priceAsOf":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"source":{"type":"string"},"payTo":{"type":"string"},"quotedAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"validUntil":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"}},"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}},{"name":"get_checkout_link","title":"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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:orders"]}]},"requiredScope":"mcp:orders","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["orderId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"checkoutUrl":{"type":"string","format":"uri"}},"required":["checkoutUrl"],"additionalProperties":false}},{"name":"list_orders","title":"List Orders","description":"Read up to 50 recent owned orders, newest first. Saved state only; no payment reconciliation. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"limit":{"default":50,"type":"integer","minimum":1,"maximum":50},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"orderReference":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},{"type":"null"}]},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shipping":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"originalTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"discount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shippingDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"taxCredit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"paymentDeadline":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"progress":{"type":"object","properties":{"productionStatus":{"type":"string","enum":["not_submitted","queued","submitting","accepted","printing","shipped","delivered","cancelled","on_hold","needs_review","unknown"]},"shipmentStatus":{"type":"string","enum":["unknown","shipped","delivered"]},"lastUpdatedAt":{"type":["number","null"]},"trackingUrls":{"type":"array","items":{"type":"string"}},"supportStatus":{"type":"string","enum":["none","open","waiting_customer","under_review","resolved"]},"canRequestCancellation":{"type":"boolean"},"canRequestChange":{"type":"boolean"},"canRequestRefund":{"type":"boolean"},"cancellationGuaranteed":{"type":"boolean","const":false}},"required":["productionStatus","shipmentStatus","lastUpdatedAt","trackingUrls","supportStatus","canRequestCancellation","canRequestChange","canRequestRefund","cancellationGuaranteed"],"additionalProperties":false},"productName":{"type":"string"},"imageCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"paidAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},{"type":"null"}]},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","refunded","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","price","pricingVersion","paymentDeadline","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","trackingUrls","message"],"additionalProperties":false}}},"required":["orders"],"additionalProperties":false}},{"name":"lookup_order","title":"Lookup Order","description":"Recover 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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orderReference":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},"idempotencyKey":{"type":"string","pattern":"^[-\\w]{16,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"found":{"type":"boolean"},"order":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"orderReference":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},{"type":"null"}]},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shipping":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"originalTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"discount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shippingDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"taxCredit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"paymentDeadline":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"progress":{"type":"object","properties":{"productionStatus":{"type":"string","enum":["not_submitted","queued","submitting","accepted","printing","shipped","delivered","cancelled","on_hold","needs_review","unknown"]},"shipmentStatus":{"type":"string","enum":["unknown","shipped","delivered"]},"lastUpdatedAt":{"type":["number","null"]},"trackingUrls":{"type":"array","items":{"type":"string"}},"supportStatus":{"type":"string","enum":["none","open","waiting_customer","under_review","resolved"]},"canRequestCancellation":{"type":"boolean"},"canRequestChange":{"type":"boolean"},"canRequestRefund":{"type":"boolean"},"cancellationGuaranteed":{"type":"boolean","const":false}},"required":["productionStatus","shipmentStatus","lastUpdatedAt","trackingUrls","supportStatus","canRequestCancellation","canRequestChange","canRequestRefund","cancellationGuaranteed"],"additionalProperties":false},"productName":{"type":"string"},"imageCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"paidAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},{"type":"null"}]},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","refunded","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","price","pricingVersion","paymentDeadline","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","trackingUrls","message"],"additionalProperties":false},{"type":"null"}]},"paid":{"type":["boolean","null"]},"paymentStatus":{"anyOf":[{"type":"string","enum":["unpaid","pending","paid","refunded","not_required","needs_review","expired"]},{"type":"null"}]},"source":{"type":"string","const":"saved_order"},"observedAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"message":{"type":"string"}},"required":["found","order","paid","paymentStatus","source","observedAt","message"],"additionalProperties":false}},{"name":"get_order","title":"Get Order","description":"Read saved order status without payment reconciliation or print submission. Status may lag processing. Pass your private guestToken or use an existing OAuth connection. No payment or printing side effects.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["orderId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"orderReference":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$"},{"type":"null"}]},"status":{"type":"string","enum":["creating_checkout","awaiting_payment","verifying_payment","settling_payment","paid","submitting","processing","needs_review","expired"]},"price":{"type":"object","properties":{"currency":{"type":"string","const":"USD"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shipping":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"originalTotal":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"discount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"coupon":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"printDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"shippingDiscount":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"},"taxCredit":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Integer USD cents"}},"required":["code","name","printDiscount","shippingDiscount","taxCredit"],"additionalProperties":false}},"required":["currency","subtotal","shipping","tax","total"],"additionalProperties":false},"pricingVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"paymentDeadline":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"quantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"progress":{"type":"object","properties":{"productionStatus":{"type":"string","enum":["not_submitted","queued","submitting","accepted","printing","shipped","delivered","cancelled","on_hold","needs_review","unknown"]},"shipmentStatus":{"type":"string","enum":["unknown","shipped","delivered"]},"lastUpdatedAt":{"type":["number","null"]},"trackingUrls":{"type":"array","items":{"type":"string"}},"supportStatus":{"type":"string","enum":["none","open","waiting_customer","under_review","resolved"]},"canRequestCancellation":{"type":"boolean"},"canRequestChange":{"type":"boolean"},"canRequestRefund":{"type":"boolean"},"cancellationGuaranteed":{"type":"boolean","const":false}},"required":["productionStatus","shipmentStatus","lastUpdatedAt","trackingUrls","supportStatus","canRequestCancellation","canRequestChange","canRequestRefund","cancellationGuaranteed"],"additionalProperties":false},"productName":{"type":"string"},"imageCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"paidAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},{"type":"null"}]},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","refunded","not_required","needs_review","expired"]},"fulfillmentStatus":{"type":"string","enum":["not_submitted","submitting","accepted","needs_review"]},"trackingUrls":{"type":"array","items":{"type":"string","format":"uri"}},"message":{"type":["string","null"]}},"required":["id","status","price","pricingVersion","paymentDeadline","quantity","createdAt","paidAt","paymentStatus","fulfillmentStatus","trackingUrls","message"],"additionalProperties":false}},{"name":"get_order_events","title":"Get Order Events","description":"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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:read"]}]},"requiredScope":"mcp:read","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"after":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["orderId"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"sequence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"type":{"type":"string","const":"order.updated"},"occurredAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"data":{"type":"object","properties":{"productionStatus":{"type":"string","enum":["not_submitted","queued","submitting","accepted","printing","shipped","delivered","cancelled","on_hold","needs_review","unknown"]},"shipmentStatus":{"type":"string","enum":["unknown","shipped","delivered"]},"lastUpdatedAt":{"type":["number","null"]},"trackingUrls":{"type":"array","items":{"type":"string"}},"supportStatus":{"type":"string","enum":["none","open","waiting_customer","under_review","resolved"]},"canRequestCancellation":{"type":"boolean"},"canRequestChange":{"type":"boolean"},"canRequestRefund":{"type":"boolean"},"cancellationGuaranteed":{"type":"boolean","const":false},"paymentStatus":{"type":"string","enum":["unpaid","pending","paid","refunded","not_required","needs_review","expired"]}},"required":["productionStatus","shipmentStatus","lastUpdatedAt","trackingUrls","supportStatus","canRequestCancellation","canRequestChange","canRequestRefund","cancellationGuaranteed","paymentStatus"],"additionalProperties":false}},"required":["id","orderId","sequence","type","occurredAt","data"],"additionalProperties":false}},"nextCursor":{"type":["number","null"]}},"required":["events","nextCursor"],"additionalProperties":false}},{"name":"request_order_help","title":"Request Order Help","description":"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. Guest checkout needs no sign-in: pass the private guestToken from start_guest_checkout, or use your existing OAuth connection, never both.","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"noauth"},{"type":"oauth2","scopes":["mcp:write"]}]},"requiredScope":"mcp:write","inputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"orderId":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,100}$"},"type":{"type":"string","enum":["general","address","cancellation","refund","damaged_prints","late_delivery"]},"message":{"type":"string","minLength":10,"maxLength":2000},"idempotencyKey":{"type":"string","pattern":"^[\\w-]{16,100}$"},"guestToken":{"description":"Private guest credential; omit when Authorization Bearer is present.","type":"string","pattern":"^ppg_[a-f0-9]{64}$"}},"required":["orderId","type","message","idempotencyKey"],"additionalProperties":false},"outputSchema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"reference":{"type":"string"},"status":{"type":"string","const":"requested"},"type":{"type":"string"},"createdAt":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Unix time in milliseconds"},"message":{"type":"string"}},"required":["reference","status","type","createdAt","message"],"additionalProperties":false}}]}