Skylit Studio Custom Gifts

Use this AFTER the customer has seen the preview and is happy with the design and ready to head to checkout. It is the optional 'want me to prefill your details so checkout is quicker?' step. Attaches the customer's email, name and (optionally) shipping address to an existing draft so the Stripe checkout page is pre-filled and they have less to type. Purely a convenience: the customer can still edit everything on the Stripe checkout page, and they can also check out without ever calling this. Do not call this before the customer has seen the preview, and do not call it to change the design (use update_order_style) or the wrap (use update_gift_addons).

Use this only when the user explicitly asks to cancel or scrap an unpaid draft order. Destructive — cannot be undone. Do not use to abandon a draft silently — an unpaid draft can simply be left, the customer can return to it later, and Skylit sends a couple of gentle reminder emails if they don't check out. Do not use after payment has cleared (Shopify-side refund flow handles paid cancellations).

Use this when the user wants to PLACE a new Skylit location-map order: a stylised map print of a meaningful place (home, wedding venue, first-met city, a trip). Creates an ANONYMOUS DRAFT checkout session with a Stripe payment URL. No personal details are accepted as arguments and no money is charged; the customer must visit the returned checkout_url to pay. Email, name and shipping address are NOT inputs to this tool: Stripe Hosted Checkout collects them at payment time. IMPORTANT: intent.location is the PLACE being mapped (e.g. 'Riga, Latvia'), not the shipping address. Unlike the star-map and moon-map prints, a location map's caption ('title') defaults to the place name itself, and there is no separate large-inscription text slot — the map IS the centerpiece. Refine the caption via update_order_style once the customer has seen the preview. Optional style fields (layout, text_style, theme, orientation, font, details_font, and the map-label toggles) let you set the initial look in one call instead of a follow-up update_order_style; omit any you don't have an opinion on and sensible defaults apply (theme 'nautical', layout 'full', text_style 'classic', orientation 'portrait'). Do not add gift wrapping UNPROMPTED: 'a gift for X' describes who it's for, not a request for packaging. Only set the gift block when the customer explicitly asks for wrapping, a ribbon, or a note. Do not use to modify an existing draft — use update_order_style for design changes or update_gift_addons for wrap changes. Do not use to check status — use get_order_status. Call only once per gift; route subsequent edits through the update_* tools against the returned draft id (the session_id field in the response).

Use this when the user wants to PLACE a new Skylit moon-phase print order: the moon exactly as it looked from a specific place on a specific date and time (anniversary, wedding night, birth night, engagement). Creates an ANONYMOUS DRAFT checkout session with a Stripe payment URL. No personal details are accepted as arguments and no money is charged; the customer must visit the returned checkout_url to pay. Email, name and shipping address are NOT inputs to this tool: Stripe Hosted Checkout collects them at payment time. IMPORTANT: intent.location is the place the moon was viewed FROM (e.g. 'Riga, Latvia'). It is NOT the shipping address. Text slots on the print: 'message' is the LARGE script-style main inscription; 'title' is the small CAPTION just above the date/location at the foot of the print. Do not swap them, and never fill 'title' with the date, location or coordinates (those print as their own lines already). Leave 'title' EMPTY when the user has not given a genuine, distinct caption. Optional style fields (composition, moon_texture, background_color, bg_image_url, message_font, details_font, hide_time) let you set the initial look in one call instead of a follow-up update_order_style; omit any you don't have an opinion on and sensible occasion-based defaults apply. Do not add gift wrapping UNPROMPTED: 'a gift for X' describes who it's for, not a request for packaging. Only set the gift block when the customer explicitly asks for wrapping, a ribbon, or a note. Do not use to modify an existing draft — use update_order_style for design changes or update_gift_addons for wrap changes. Do not use to check status — use get_order_status. Call only once per gift; route subsequent edits through the update_* tools against the returned draft id (the session_id field in the response).

Use this when the user wants to PLACE a new Skylit star-map order: a personalised print of the night sky for a specific moment (anniversary, wedding day, birth night, engagement). Creates an ANONYMOUS DRAFT checkout session with a Stripe payment URL. No personal details are accepted as arguments and no money is charged; the customer must visit the returned checkout_url to pay. Email, name and shipping address are NOT inputs to this tool: Stripe Hosted Checkout collects them at payment time. Do not ask the customer for them, do not pull them from the ChatGPT profile, and do not pass them via any field on this tool. IMPORTANT: intent.location is the CITY OF THE NIGHT SKY to render (e.g. 'Riga, Latvia' = render Riga's sky). It is NOT the shipping address. A customer can buy a Riga-sky print and ship it to London. Text slots on the print: 'message' is the LARGE script-style main inscription; 'title' is the small CAPTION just above the date/location at the foot of the print. These are the only two text slots — names go in whichever slot fits the requested prominence; do not swap them. Never fill 'title' with the date, the location, or the coordinates. Those already print as their own separate lines, so echoing any of them into the caption is pure duplication. When the user has not given a genuine, distinct caption or milestone marker, leave 'title' EMPTY; an empty caption is the correct, clean default and the print is complete with just message, date, location and coordinates. When the customer names a specific milestone (a numbered anniversary like 'third anniversary', a milestone birthday), put that dated marker in 'title' (e.g. 'THIRD ANNIVERSARY') and keep 'message' timeless and poetic so the print stays meaningful for years, not just one. Acknowledge the milestone warmly in chat. Some customers do want the year front-and-centre; honour that if they ask. Do not use to modify an existing draft — use update_order_style for design changes or update_gift_addons for wrap changes. Do not use to check status — use get_order_status. Call only once per gift; if the user wants tweaks, route subsequent edits through the update_* tools against the returned draft id (the session_id field in the response).

Use this when the customer wants their star-map design emailed to them so they do not lose it, e.g. 'can you email me this?' or 'send it to me so I can finish later'. ChatGPT cannot send email on its own; this tool IS the action that sends it. It emails the customer the preview image, a one-line design summary and a checkout button, and saves their email onto the draft so Skylit Studio can follow up if they do not check out straight away. Call this only when the customer explicitly asks for the design to be emailed. Do not use it to place an order (use create_star_map_order) or to pre-fill checkout details (use attach_customer_details).

Use this only on non-widget MCP clients (e.g. claude.ai chat) where the inline preview-viewer cannot render and you need to surface a plain URL the user can open in their browser. ChatGPT Apps SDK clients already render the preview inline — calling this there produces a redundant link. Read-only.

Use this when the user wants to check or recap the current state of an existing draft order — to verify what's saved, see the latest preview link, or confirm the total. Read-only. Do not use to change anything (update_order_style / update_gift_addons). Do not use without a draft_id.

Use this when the user wants to see Skylit's gift wrapping options — ribbon colours, gift wrap, the bundle, gift card designs and fonts — either before deciding on wrap or while fine-tuning an existing draft. Returns the full catalogue: Ribbon (£2.49), Gift Wrap (£3.69), Bundle (£4.99, normally £6.18 separately), 8 ribbon colours, 2 gift card designs, 2 fonts, plus an eligibility_rule (flat unframed prints accept only Ribbon; framed/canvas accept all four). Read-only — does NOT create or modify orders. Do not use to commit a choice (use update_gift_addons for that). Do not use to start a new order (use create_star_map_order).

Use this when the user wants to see Skylit's available location-map print sizes, finishes, or prices before placing a location map order. Returns all sizes (A4, 30x40, 40x50, 50x70, 60x80 cm) and finishes (print, canvas, framed) with current GBP prices (£21-£120). Do not use to look up star-map or moon-map variants (use list_star_map_variants / list_moon_map_variants), gift wrap options (use list_gift_addons), or to inspect an existing draft (use get_order_status).