attach_customer_details
ChatGPTUse 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).
attach_customer_details
ChatGPTUse 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).
cancel_order
ChatGPTUse 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).
cancel_order
ChatGPTUse 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).
create_star_map_order
ChatGPTUse 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).
create_star_map_order
ChatGPTUse 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).
email_design
ChatGPTUse 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).
email_design
ChatGPTUse 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).
get_order_preview_url
ChatGPTUse 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.
get_order_preview_url
ChatGPTUse 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.
get_order_status
ChatGPTUse 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.
get_order_status
ChatGPTUse 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.
list_gift_addons
ChatGPTUse 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).
list_gift_addons
ChatGPTUse 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).
list_star_map_variants
ChatGPTUse this when the user wants to see Skylit's available print sizes, finishes, or prices before placing an 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 gift wrap options (use list_gift_addons), and do not use to inspect an existing draft (use get_order_status).
list_star_map_variants
ChatGPTUse this when the user wants to see Skylit's available print sizes, finishes, or prices before placing an 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 gift wrap options (use list_gift_addons), and do not use to inspect an existing draft (use get_order_status).
update_gift_addons
ChatGPTUse this when the user wants to change the gift wrap on an existing draft — pick or swap wrap type, change ribbon colour, edit the gift note, or switch card design/font. Switching the wrap TYPE reissues the Stripe Checkout link with the new total (the short_url stays stable). Changing ribbon colour, note, or card design is in-place and does not touch Stripe. Do not use to change the print design (use update_order_style). Do not use to start a new order (use create_star_map_order).
update_gift_addons
ChatGPTUse this when the user wants to change the gift wrap on an existing draft — pick or swap wrap type, change ribbon colour, edit the gift note, or switch card design/font. Switching the wrap TYPE reissues the Stripe Checkout link with the new total (the short_url stays stable). Changing ribbon colour, note, or card design is in-place and does not touch Stripe. Do not use to change the print design (use update_order_style). Do not use to start a new order (use create_star_map_order).
update_order_style
ChatGPTUse this when the user wants to tweak an existing draft: the night sky itself (location, date, time), the visual design (shape, theme colour palette, the backdrop behind the disc, the star-map element toggles for constellations / equatorial grid / constellation labels / planets / Milky Way / border), the inscription text, or the fonts. Changing the location, date or time re-renders the star chart but does NOT change the price, so it patches in place — never cancel and recreate the order to change where or when the sky is from. Mutates the draft in place — safe to call repeatedly. Do not use to change wrap or gift options (use update_gift_addons). Do not use to create a new order (use create_star_map_order).
update_order_style
ChatGPTUse this when the user wants to tweak an existing draft: the night sky itself (location, date, time), the visual design (shape, theme colour palette, the backdrop behind the disc, the star-map element toggles for constellations / equatorial grid / constellation labels / planets / Milky Way / border), the inscription text, or the fonts. Changing the location, date or time re-renders the star chart but does NOT change the price, so it patches in place — never cancel and recreate the order to change where or when the sky is from. Mutates the draft in place — safe to call repeatedly. Do not use to change wrap or gift options (use update_gift_addons). Do not use to create a new order (use create_star_map_order).
