apply_change
ChatGPTApply one pending proposal to the live store ONLY after the merchant explicitly confirmed its review summary in this conversation. This changes real store data and can change what customers see on the public storefront (prices, products, discounts, pages, menus, theme), update orders, or ask a payment provider to refund. Re-checks the person's permissions and that nothing changed since the review; applying the same proposal again returns the earlier result. Recorded in Store activity as the merchant via this AI app.
build_theme
ChatGPTQueues a background theme build on Shopis (a complete new design, or converting React, HTML or Figma exports into a theme). Creates a separate unpublished draft theme and never publishes. Requires at least 100 AI credits to start and is charged by actual model cost; ask the merchant before starting. Follow progress with list_theme_builds.
check_store
ChatGPTRead the store snapshot: readiness, store name and contact, currency, shipping settings, menus, pages, collections, themes, markets, low stock and the suggested next step. Call it first in every conversation. Read only, free (0 AI credits).
design_page
ChatGPTMain design tool. Designs a new or restyled homepage, collection page or landing page in about a minute from the Shopis section library (style, real store images, copy in the store language) and saves it as a separate unpublished draft theme; it never publishes. Runs AI on Shopis and is charged to the store's AI credits by actual model cost (a few credits); fails with a clear message when credits run out. Publish later with propose_publish_theme after the merchant approves the draft.
discard_change
ChatGPTPermanently dismiss a pending proposal the merchant declined, so it no longer waits for confirmation in Shopis. A discarded proposal cannot be restored; prepare it again if needed. The store data itself is not changed.
find_customers
ChatGPTFind customers by name, email or tag with exact IDs, tags, order count and total spent. Read before propose_customer_tags or personal discounts. Never authenticates a buyer or grants marketing consent. Read only, free (0 AI credits).
find_orders
ChatGPTFind up to 20 orders by order number or customer email with exact IDs, totals and currency, payment status, fulfillment status, line items, note, traffic source and delivery address. Never charges or refunds anything. Read only, free (0 AI credits).
find_products
ChatGPTFind up to 20 products with exact IDs, status, vendor, product type, tags, prices (integer hundredths of the store currency), images and up to 5 preview variants each. Use get_product_variants for the complete variant list. Read only, free (0 AI credits).
get_article_context
ChatGPTRead one article with its body, publication state, version and parent blog. Read before propose_save_article or propose_delete_article. Read only, free (0 AI credits).
get_articles
ChatGPTList blog articles (drafts and published) with IDs, versions, blog IDs and status. Read only, free (0 AI credits).
get_collection_content
ChatGPTRead one collection: title, description, handle, manual products or automatic rules, SEO, template and translations. Read it before propose_collection_membership or propose_update_seo. Collection IDs come from check_store or list_template_resources. Read only, free (0 AI credits).
get_customer_segments
ChatGPTRead the saved dynamic customer segments, their rules, the store currency and the definitions version needed by propose_save_customer_segment. Read only, free (0 AI credits).
get_delivery_settings
ChatGPTRead shipping and delivery methods: standard rate, named rates by zone with price or weight conditions, local pickup, local delivery, carrier-calculated services, shipping profiles and the settings version used by the propose_* delivery tools. Money is in hundredths of the store currency. Read only, free (0 AI credits).
get_discount_capabilities
ChatGPTRead which discount types, conditions and combinations Shopis supports. Read before propose_save_discount; a requested condition that is not supported must be reported to the merchant, never dropped. Read only, free (0 AI credits).
get_gift_cards
ChatGPTRead gift cards (masked codes only, balances in hundredths of the store currency, expiry, status) or one card with its ledger. Full codes are never returned. Read only, free (0 AI credits).
get_international_settings
ChatGPTRead the base currency, country markets, languages, per-country shipping rates and the markets fingerprint used by propose_save_market, plus supported countries and currencies. Read only, free (0 AI credits).
get_inventory_locations
ChatGPTRead inventory locations with IDs and versions and, for one variant, its available stock per location and active checkout holds. Read only, free (0 AI credits).
get_order_activity
ChatGPTRead the latest 50 recorded events of one order (status changes, fulfillments, payments, edits) with who made them. Use nextBeforeId to read older events. Read only, free (0 AI credits).
get_order_refunds
ChatGPTRead one order's refunds, transactions and refundable amounts per line, shipping and duty. Pass lines (and optional shippingCents/dutyCents) to get the exact suggested refund and tender split to use in propose_refund_order. Calculating moves no money. Read only, free (0 AI credits).
get_payment_providers
ChatGPTRead the store's payment providers (name, label, active, test mode, checkout order) and the available providers. Configuration values, credentials and tokens are never returned. Read only, free (0 AI credits).
get_product_gallery
ChatGPTRead one product's ordered photos, videos and 3D models, their alt text and which photo each variant shows. Read only, free (0 AI credits).
get_product_variants
ChatGPTRead a page of up to 100 variants of one product with exact variant IDs, options, prices, compare-at prices, unit cost, SKU, barcode, weight and stock. Read it before propose_update_variant. Unit cost is merchant-only; never show it to buyers. Read only, free (0 AI credits).
get_report_capabilities
ChatGPTRead every supported report metric with its unit and allowed groupings, plus metrics Shopis does not record (with reasons). Read before run_report_query when unsure. Read only, free (0 AI credits).
get_store_policies
ChatGPTRead the store's privacy, refund, shipping and terms policies, their translations and the version used by propose_update_store_policies. Never invent legal terms. Read only, free (0 AI credits).
get_tax_fx_settings
ChatGPTRead tax and currency automation per country (automatic or manual tax, regional rates, exchange rates, price rounding) and product or collection tax overrides, with the version used by the propose_* tax tools. Rates are parts per million (17% = 170000). Read only, free (0 AI credits).
list_discounts
ChatGPTRead existing discount codes and automatic discounts with IDs, rules, status, dates and usage. Read before proposing a new code to avoid duplicates. Read only, free (0 AI credits).
list_pending_changes
ChatGPTList proposals prepared through this connection that still wait for the merchant's confirmation, with proposalId, version, kinds and review summary. Read only, free (0 AI credits).
list_template_resources
ChatGPTList up to 50 products, collections or pages with exact IDs, handles and their theme template, plus the available template names. Use it to find collection and page IDs for SEO, navigation and membership changes. Read only, free (0 AI credits).
list_theme_builds
ChatGPTRead the progress and results of this person's design and theme builds in the store (running, ready as an unpublished draft, failed). Read only, free (0 AI credits).
list_url_redirects
ChatGPTRead URL redirects with IDs and versions, searchable by path or target. Redirects only apply to pages that do not exist. Read only, free (0 AI credits).
prepare_design
ChatGPTRuns the Shopis design model to prepare a focused theme edit (colors, fonts, text, one section or setting) as a previewable pending proposal. Charged to the store's AI credits. Nothing changes until apply_change after the merchant confirms. For a new page or a full redesign use design_page.
preview_discount
ChatGPTSimulate a discount definition on sample cart lines with real catalog prices and current rules, and return the resulting discount per line. Creates no discount, order or usage. Read only, free (0 AI credits).
propose_adjust_gift_card_balance
ChatGPTPrepare adding to or subtracting from an existing gift card balance. Read get_gift_cards first for the card ID and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_cancel_fulfillment
ChatGPTPrepare cancelling an existing shipment so its items return to unfulfilled. Read get_order_activity first for the fulfillment ID. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_cancel_order
ChatGPTPrepare cancelling an order. Cancelling restores stock and does not refund payment (use propose_refund_order for that). Read find_orders first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_collection_membership
ChatGPTPrepare a replacement of an existing collection's products (manual) or rules (automatic). This replaces the full membership, so start from get_collection_content. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_create_collection
ChatGPTPrepare a new manual collection (chosen products) or automatic collection (rules such as tag, vendor, price or product type). Show every rule in the summary. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_create_customer
ChatGPTPrepare a customer record from a name and email the merchant supplied. Search find_customers for the email first. It sends no email and grants no marketing consent. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_create_product
ChatGPTPrepare new products (title, description, options, variants with prices in integer hundredths of the store currency, stock). New products are created as drafts. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_customer_tags
ChatGPTPrepare a replacement of a customer's tags (the complete list). Read find_customers first and keep existing tags unless asked to remove them. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_deactivate_payment_provider
ChatGPTPrepare removing a payment provider from checkout. Read get_payment_providers first for the provider and version. Activating a provider or entering credentials is only possible in the Shopis admin; never ask for API keys or card details. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_article
ChatGPTPrepare deleting a blog article and its comments. Read get_articles first for the ID and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_customer_segment
ChatGPTPrepare deleting a customer segment. Customers themselves are not changed. Read get_customer_segments first for the ID and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_discount
ChatGPTPrepare the permanent deletion of discounts. Deactivating is the reversible alternative. Read list_discounts first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_local_delivery
ChatGPTPrepare turning off local delivery from a location. Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_pickup_location
ChatGPTPrepare turning off local pickup at a location. Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_product
ChatGPTPrepare the permanent deletion of products. Archiving with propose_update_product (status archived) is the reversible alternative; offer it first. Read find_products first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_shipping_rate
ChatGPTPrepare deleting a named shipping rate. Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_delete_url_redirect
ChatGPTPrepare deleting URL redirects. Read list_url_redirects first for IDs and versions. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_disable_gift_card
ChatGPTPrepare disabling an existing gift card so it can no longer be redeemed. Read get_gift_cards first for the card ID and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_fulfill_order
ChatGPTPrepare marking all remaining items of an order as fulfilled. Use propose_fulfill_order_items for partial shipments or tracking numbers. Read find_orders first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_fulfill_order_items
ChatGPTPrepare a partial or full shipment of chosen order lines with optional carrier and tracking number. Needs a new operationId UUID. Read find_orders and get_order_activity first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_issue_gift_card
ChatGPTPrepare issuing a new gift card with an initial balance (and optional expiry, customer and note). The code is generated and revealed once to the merchant in the Shopis admin, never in chat. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_mark_order_paid
ChatGPTPrepare recording that an order was paid outside Shopis (for example cash on delivery). Only when the merchant says the payment was received; it never charges a card. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_order_note
ChatGPTPrepare a replacement of an order's internal note. The note is never sent to the customer. Read find_orders first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_publish_theme
ChatGPTPrepare publishing an unpublished theme draft (for example one created by design_page) so customers see it. Read check_store for theme IDs. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_record_return
ChatGPTPrepare recording returned items as received (and whether to restock them). Needs a new operationId UUID. Refunds are separate (propose_refund_order). Read get_order_activity first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_refund_order
ChatGPTPrepare a refund for an order: lines, shipping, duty and how much goes back to each payment. Calculate first with get_order_refunds and use its suggested amounts and tenders. Applying a refund to an online payment asks the payment provider to return the money. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_refund_replacement_return
ChatGPTPrepare refunding a received return of replacement items. Read get_order_refunds first for the request, receipt and amount. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_relocate_fulfillment
ChatGPTPrepare moving the unfulfilled items of an order to another inventory location. Read get_order_activity and get_inventory_locations first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_remove_country_tax
ChatGPTPrepare removing a country tax and currency configuration so the store defaults apply. Read get_tax_fx_settings first and send the version. Never compute prices or tax amounts yourself. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_remove_tax_override
ChatGPTPrepare removing a product or collection tax override. Read get_tax_fx_settings first and send the version. Never compute prices or tax amounts yourself. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_reorder_payment_providers
ChatGPTPrepare the order in which active payment providers appear at checkout. Read get_payment_providers first for the providers and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_article
ChatGPTPrepare creating, editing, scheduling or publishing a blog article (version 0 and no id to create). Read get_articles and get_article_context first. Say exactly when it becomes public. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_customer_segment
ChatGPTPrepare creating or editing a dynamic customer segment (tags, order count, total spend). Read get_customer_segments for the version and currency, and preview with query_customer_segment. No email is sent. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_discount
ChatGPTPrepare a new discount code or automatic discount, or an edit of an existing one (pass id): percentage, fixed amount, free shipping, buy X get Y, tiers, minimum subtotal, eligible products or customers, dates and usage limits. Discounts are validated rules, never final prices. Keep every condition the merchant asked for; if one is not supported (see get_discount_capabilities) say so instead of dropping it. Preview with preview_discount. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_local_delivery
ChatGPTPrepare enabling or editing local delivery from a location (postal codes or radius, price, minimum order). Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_market
ChatGPTPrepare creating or editing one country market (countries, languages, default locale, active, primary). Read get_international_settings first and send its markets fingerprint. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_page
ChatGPTPrepare a new content page or an edit of an existing one (pass id): title, URL handle and plain text body. Read read_page first when editing. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_pickup_location
ChatGPTPrepare enabling or editing local pickup at an inventory location (instructions, ready time). Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_shipping_rate
ChatGPTPrepare creating or editing a named shipping rate for a zone, with price or weight conditions. Read get_delivery_settings first and send its version; never invent rates, postal codes or addresses. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_save_url_redirect
ChatGPTPrepare a new URL redirect or an edit of an existing one. Redirects only apply to paths that no longer exist. Read list_url_redirects first when editing. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_set_country_tax
ChatGPTPrepare one country configuration: tax mode, regional rates, exchange rate mode and price rounding (send the full configuration). Read get_tax_fx_settings first and send the version. Never compute prices or tax amounts yourself. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_set_gift_card_expiry
ChatGPTPrepare setting or removing the expiry date of an existing gift card. Read get_gift_cards first for the card ID and version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_set_tax_override
ChatGPTPrepare a tax rate override for a product or collection in a country or region. Read get_tax_fx_settings first and send the version. Never compute prices or tax amounts yourself. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_settle_exchange
ChatGPTPrepare recording that the price difference of an approved exchange was collected from the customer. Read get_order_refunds first for the request and the expected difference. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_default_shipping_method
ChatGPTPrepare a change to the store's default shipping method: turn it on or off and edit the name and description buyers see at checkout. Its price is not changed here (use propose_save_shipping_rate for priced rates). Read get_delivery_settings first and send its version. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_discount_status
ChatGPTPrepare activating or deactivating existing discounts. Read list_discounts first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_navigation
ChatGPTPrepare a replacement of the main menu or footer menu links (nested up to three levels, linking to products, collections, pages, blogs or URLs). Keep existing links unless the merchant asked to change them. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_payment_provider
ChatGPTPrepare renaming a payment provider's checkout label or switching its test mode. Credentials are never changed here; they are entered only in the Shopis admin. Read get_payment_providers first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_product
ChatGPTPrepare edits to existing products: title, description, status (draft, active, archived), vendor, product type, tags, category or swatches. Omitted fields keep their current values. Read find_products first. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_seo
ChatGPTPrepare SEO title and meta description changes for products, collections or pages. Read the current values first (find_products, get_collection_content, read_page). It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_store_policies
ChatGPTPrepare new text for the store policies (privacy, refund, shipping, terms, contact) using only text the merchant supplied. Read get_store_policies first. Never invent legal terms. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_store_settings
ChatGPTPrepare store settings changes: store name, contact email, time zone, flat shipping rate, free shipping threshold, per-country rates and shipping profiles. Read check_store first; omitted fields keep their current values. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_tracking
ChatGPTPrepare changing the carrier or tracking number of an existing shipment. Read get_order_activity first for the fulfillment ID. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
propose_update_variant
ChatGPTPrepare edits to existing variants: price, compare-at price, unit cost, SKU, barcode, stock, inventory tracking or weight. Omitted fields keep their current values. Read get_product_variants first for exact variant IDs and current values. It creates a pending proposal in Shopis (visible to the merchant in the admin) and returns proposalId, version and the server review summary. Nothing in the store changes until apply_change is called after the merchant explicitly confirms that summary in this chat.
query_customer_segment
ChatGPTPreview which customers match segment rules (tags, order count, total spend) without saving anything. Spend is gross recorded totals in the store currency. Read only, free (0 AI credits).
read_page
ChatGPTRead one content page (title, handle, body, SEO). Page IDs come from check_store. Read before propose_save_page. Read only, free (0 AI credits).
run_report_query
ChatGPTRun one report on actual store data with the same engine as saved reports: a metric (for example net_sales, orders, sessions, conversion) grouped by day, week, month, product, collection, traffic source, discount code or shipping country. Money values are integer hundredths of the base currency. Unsupported metrics fail with a reason. Read only, free (0 AI credits).
sales_report
ChatGPTRead actual sales, orders, average order value, traffic and conversion for the last 1, 7, 30 or 90 days, compared with the previous equal period. Unpaid cash-on-delivery orders are included in order totals. Read only, free (0 AI credits).
search_operations
ChatGPTSearch current products, orders and customers with the same query service as the admin search (up to 20 results per resource, with hasMore). Returns exact IDs to use with the other tools. Read only, free (0 AI credits).