{"server":"com.giftstoprint/poster-connector","count":5,"tools":[{"name":"create_poster_checkout","title":"Create the personalised checkout","description":"Validate every detail and create a Shopify checkout for one personalised poster with all the details attached. Returns checkout_url. Nothing is charged: open checkout_url for the user to review the order and pay on GiftsToPrint's own checkout. Before calling, read the details back to the user, including the photo_url so they can check it is the right photo, and confirm they understand they will receive a digital file to print (set confirm_digital_file to true). If a field is wrong, the error lists every problem at once so you can fix them in one go.","input_schema":{"type":"object","required":["handle","turnaround","personalisation","photo_url","buyer","confirm_digital_file"],"properties":{"buyer":{"type":"object","required":["email","first_name"],"properties":{"email":{"type":"string","format":"email","description":"The buyer's email. The download link is sent here."},"first_name":{"type":"string","description":"The buyer's first name."}},"additionalProperties":false},"handle":{"type":"string","description":"The poster's handle, from find_posters."},"photo_url":{"type":"string","format":"uri","description":"The photo_url returned by upload_photo."},"turnaround":{"enum":["standard","rush_weekday","rush_weekend"],"type":"string","description":"standard: ready the next working day, order Mon-Fri. rush_weekday: ready within 12 hours, order Mon-Fri. rush_weekend: ready within 24 hours, order Sat or Sun."},"instructions":{"type":"string","maxLength":500,"description":"Optional note to the designers, e.g. how to crop the photo."},"buyer_country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional ISO country code, so checkout opens in the buyer's currency."},"personalisation":{"type":"object","description":"The fields from get_poster_form, keyed by their id (e.g. recipient_first_name, birth_day, birth_month).","additionalProperties":{"type":["string","integer"]}},"confirm_digital_file":{"type":"boolean","description":"Must be true: the buyer understands the poster is a digital file to print, not a physical print."}},"additionalProperties":false},"output_schema":null,"annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T16:10:45.298Z"},{"name":"find_posters","title":"Find a poster","description":"Search GiftsToPrint's personalised newspaper-style posters. Each poster shows real headlines and events from one year, personalised with a name, photo and message, and is delivered as a print-ready digital file (nothing is posted). Birthday posters and wedding-anniversary posters exist per milestone and edition (e.g. 60th Birthday, Australian edition, 1966); retirement and dating-anniversary posters cover any year, chosen in the form. Pick the edition by where the recipient lives or grew up (US, UK, Canada or Australia). Returns each matching poster's handle, prices and product page. Next step: get_poster_form.","input_schema":{"type":"object","properties":{"year":{"type":"integer","maximum":2100,"minimum":1900,"description":"The year the poster should cover (birth year, or wedding year)."},"edition":{"enum":["US","UK","Canada","Australia"],"type":"string","description":"Country edition: which country's news the poster shows."},"occasion":{"enum":["birthday","wedding_anniversary","dating_anniversary","retirement"],"type":"string","description":"What the poster celebrates."},"milestone":{"type":"integer","maximum":120,"minimum":1,"description":"The birthday or anniversary number, e.g. 60 for a 60th."},"buyer_country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional ISO country code of the buyer (e.g. \"US\", \"AU\") to show prices in their currency."}},"additionalProperties":false},"output_schema":null,"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T16:10:45.298Z"},{"name":"get_photo_upload_link","title":"Get a link to upload the photo","description":"Create a private web page where the user can upload the poster photo from their phone or computer. Use this whenever you can't pass the user's photo to upload_photo yourself: they have no link to it, they want to pick it from their device, or a photo they attached in the chat can't be sent on. Give the user upload_page and ask them to tell you once it's uploaded, then call upload_photo with upload_id to get the photo_url. The link works for 7 days.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":null,"annotations":{"readOnlyHint":false,"openWorldHint":false,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T16:10:45.298Z"},{"name":"get_poster_form","title":"Get the details a poster needs","description":"List exactly what to collect from the user for one poster: names, dates, optional message, and the photo, plus the turnaround options and prices. Ask the user for anything you don't already know. Don't invent names or dates. Next step: upload_photo, then create_poster_checkout.","input_schema":{"type":"object","required":["handle"],"properties":{"handle":{"type":"string","description":"The poster's handle, from find_posters."},"buyer_country":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"Optional ISO country code of the buyer, for local prices."}},"additionalProperties":false},"output_schema":null,"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T16:10:45.298Z"},{"name":"upload_photo","title":"Upload the photo for the poster","description":"Store the photo that will be printed on the poster, and return the photo_url to pass to create_poster_checkout. Only use a photo the user has given in THIS conversation. Never reuse a photo or link from memory or an earlier conversation, and never use a product or poster image. If the user hasn't given a photo yet, ask them for one instead of calling this. Give exactly one of: photo (a file the user attached in this chat), image_url (a public https link to the image), image_base64, or upload_id (from get_photo_upload_link, once the user says they've uploaded). If you can't send the user's photo any of these ways, call get_photo_upload_link instead of asking the user for a link. JPEG, PNG or WebP, up to 20MB. Photos are kept for 12 months so the poster can be made and revised, then deleted automatically.","input_schema":{"type":"object","$defs":{"OpenAIFile":{"type":"object","required":["download_url","file_id"],"properties":{"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"},"download_url":{"type":"string"}},"additionalProperties":false}},"properties":{"photo":{"$ref":"#/$defs/OpenAIFile","description":"A photo the user attached in this chat (ChatGPT file reference)."},"image_url":{"type":"string","format":"uri","description":"Public https:// address of the image."},"upload_id":{"type":"string","pattern":"^[0-9a-f]{32}$","description":"The upload_id from get_photo_upload_link, after the user has uploaded on that page."},"image_base64":{"type":"string","description":"The image file encoded as base64 (a data: URL prefix is fine)."}},"additionalProperties":false},"output_schema":null,"annotations":{"readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T16:10:45.298Z"}],"next_cursor":null,"next_actions":[{"action":"get_connection","description":"Connection block to call these tools","href":"/v1/servers/com.giftstoprint%2Fposter-connector/connection?target=mcpServers","arguments":{"name":"com.giftstoprint/poster-connector","target":"mcpServers"}},{"action":"get_server","description":"Full descriptor with trust and connectability","href":"/v1/servers/com.giftstoprint%2Fposter-connector","arguments":{"name":"com.giftstoprint/poster-connector"}}]}