account_websites_list
ChatGPTList the Squarespace websites the logged-in member has access to (id, title, internalUrl, publicUrl, roles), so the model can ask the user which one an action concerns before calling a websiteId-scoped tool. Takes no websiteId -- this is the tool to call first, before any other Squarespace tool that requires one. Use a website's id as the websiteId argument of other Squarespace tools, but never show the id to the user: it is an internal identifier. Refer to websites by title and URL when asking which one they mean. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool.
squarespace_create_contact
ChatGPTCreate a new Squarespace contact. firstName, lastName, locale and email are required; acceptsMarketing and a default shipping address are optional. The email must be unique — a duplicate is rejected. If an address is supplied and its save fails, the contact is still created and the result carries addressError. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_create_gift_card_product
ChatGPTCreate a NEW gift card (GIFT_CARD) product in the Squarespace store, with one or more variants. Reach for it when the seller wants to sell gift cards — "create a $25 and $50 gift card", "add a holiday gift card product". Each variant is just a SKU and pricing.basePrice ({currency, value} strings): gift cards do NOT take stock, variant attributes, or a sale price, and this tool rejects those. String length limits (enforced, from Squarespace): name ≤ 200 characters, description ≤ 102400 characters, urlSlug ≤ 200 characters, and each variant's sku ≤ 60 characters — exceeding any is a 400. New products default to hidden (isVisible false) unless you set it true. This tool creates ONLY gift-card products, not physical, service, or digital ones (download products cannot be created via the API at all). It creates products, it does not update them: use squarespace_get_product to read one back and squarespace_query_products to list them. If the urlSlug you pass is already taken the call fails with a conflict — change it or omit it to let Squarespace derive a unique one. Returns the created product in the same shape squarespace_get_product returns, including the new product and variant ids. Not idempotent: retrying a call that may already have succeeded creates a duplicate product, unless a urlSlug was set (the retry then fails with a conflict). Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_create_physical_product
ChatGPTCreate a NEW physical (PHYSICAL) product in the Squarespace store, with one or more variants. Reach for it when the seller wants to sell a shippable physical item — "create a t-shirt in S/M/L", "add a mug for $15". Each variant takes a SKU and pricing ({basePrice, optional salePrice and onSale}, money as {currency, value} strings), and optionally stock ({quantity, unlimited}; if omitted the variant is created with 0 stock, i.e. sold out, so pass {unlimited: true} or a quantity to make it purchasable), option values (attributes), shippingMeasurements, gtin and mpn. Variant option values (attributes) must match the product's variantAttributes names and be unique across variants. String length limits (enforced): name ≤ 200, description ≤ 102400, urlSlug ≤ 200, each sku ≤ 60, mpn ≤ 70; at most 100 variants; gtin is 8/12/13/14 digits. New products default to hidden (isVisible false) unless set true. This tool creates ONLY physical products — use squarespace_create_gift_card_product for gift cards, and squarespace_get_product to read one back. A urlSlug already in use fails with a conflict; a variant price currency that doesn't match the store is also a conflict. Returns the created product in the same shape squarespace_get_product returns, including the new product and variant ids. Not idempotent: retrying a call that may already have succeeded creates a duplicate product, unless a urlSlug was set (the retry then fails with a conflict). Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_create_service_product
ChatGPTCreate a NEW service (SERVICE) product in the Squarespace store, with one or more variants. Reach for it when the seller wants to sell a non-shipped service or offering — "create a one-hour consultation for $120", "add a Gold/Silver membership tier". Each variant takes a SKU and pricing ({basePrice, optional salePrice and onSale}, money as {currency, value} strings), and optionally stock ({quantity, unlimited}; if omitted the variant is created with 0 stock, i.e. sold out, so pass {unlimited: true} or a quantity to make it purchasable), and option values (attributes). Variant option values (attributes) must match the product's variantAttributes names and be unique across variants. Service products have no shipping, gtin or mpn (Squarespace rejects those). String length limits (enforced): name ≤ 200, description ≤ 102400, urlSlug ≤ 200, each sku ≤ 60; at most 100 variants. New products default to hidden (isVisible false) unless set true. This tool creates ONLY service products — use squarespace_create_physical_product for shippable goods, squarespace_create_gift_card_product for gift cards, and squarespace_get_product to read one back. A urlSlug already in use fails with a conflict; a variant price currency that doesn't match the store is also a conflict. Returns the created product in the same shape squarespace_get_product returns, including the new product and variant ids. Not idempotent: retrying a call that may already have succeeded creates a duplicate product, unless a urlSlug was set (the retry then fails with a conflict). Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_generate_domain_names
ChatGPTGenerate business name ideas from a free-text description. Returns brandable names grouped by tone (neutral, playful, professional, friendly, informative, quirky). Name ideas only: this tool does not check availability or prices. Use this tool first when the user describes a business or idea but has no name or keyword yet, even if they ask for a domain. For example: - "I need a domain for my bakery" - "Find me a .com for the vintage clothing shop I'm opening" - "Help me name my consulting firm" If the user already has a name or keyword ("acmecoffee", "Flour & Fern"), use squarespace_search_domains instead. After generating, pick the 3–4 most promising names across different tones and search each one with squarespace_search_domains. Do this before asking the user which they prefer; they can refine afterwards. Present the results grouped by tone: for each name, a short label and a small table of its available domains (Domain | Price | Renewal | Purchase) using the checkoutLink from each search result. End with a top pick and offer to refine by style, location, or a name they have in mind. The description parameter is a phrase or sentence about the business or idea.
squarespace_get_contact
ChatGPTRetrieve one Squarespace contact with a joined view of their commerce activity. Look the contact up by its contactId or by an exact email address (provide exactly one). Returns the contact profile (id, firstName, lastName, email, locale, acceptsMarketing, createdOn), their recent orders, a lifetime transaction summary, and their address book. If an enrichment lookup fails the rest is still returned with _partialData set. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_get_order
ChatGPTRead ONE Squarespace order in full by its INTERNAL order id: who placed it, every line item, the money breakdown (subtotal, tax, shipping, discounts, refunds, grand total), fulfillment and payment status, shipping and billing addresses, and the payment/refund transactions behind it. Call it only when you already have that internal id — e.g. "show me order 585d498fdee9f31a60284a37", "what did this customer buy on order 585d498fdee9f31a60284a37?", "has order 585d498fdee9f31a60284a37 been paid and shipped?", "how much was refunded on order 585d498fdee9f31a60284a37?". The ONLY accepted input is the internal id (a 24-character hex string). A human order number such as 1042 is NOT accepted: passing one returns not-found, which reads as "no such order" even when the order exists. If the seller names an order by its order number, resolve it to an internal id FIRST — call squarespace_query_orders (optionally filtered by the buyer's contactId from squarespace_query_contacts), find the entry whose orderNumber matches in the returned orders[], and call this tool with that entry's id. The returned order.customerId is the buyer's contact id — pass it to squarespace_query_orders as contactId to list their other orders. Sets _partialData when the transactions lookup fails; the order data is still complete. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_get_product
ChatGPTRetrieve a single Squarespace product in full by its id. Every product returns its name, description, URL, type, visibility, tags, SEO options, images and storePageId; the rest depends on the product's type: PHYSICAL and SERVICE products return variantAttributes and variants with SKU, pricing (base/sale price and on-sale flag), current stock and attributes, and PHYSICAL variants also carry shippingMeasurements, gtin and mpn; GIFT_CARD products return variants with SKU and base price only (no stock); DIGITAL products have no variants and return product-level pricing. Use it to look up a known product — e.g. "show me product 5f3a…", "what's the price and stock of this product", "what variants and prices does it have", or "is this product published". Provide the productId (find it with squarespace_query_products first if you only know the name). It does NOT search by name and does NOT list or modify products. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_list_store_pages
ChatGPTList the store pages on a Squarespace site and return each page's id, title, urlSlug and isEnabled, plus pagination. This is how you get a storePageId: every create-product tool (squarespace_create_physical_product / _service_product / _gift_card_product) requires a storePageId, and this tool is the direct way to obtain one. Call it with a websiteId, pick the page you want new products to live under, and pass its id as storePageId when creating. Paginate with a cursor when a site has many pages. It does NOT create, modify or delete pages or products. NOTE: it does not report a page's TYPE (store page vs services page) or the store's currency/measurement standard. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_query_contacts
ChatGPTFind/browse Squarespace contacts and return a lean list (id, firstName, lastName, email, acceptsMarketing, createdOn) plus pagination. Search by text, last-order date range, order count/amount, and marketing opt-in; sort and paginate with a cursor. All inputs besides websiteId are optional; a request containing only websiteId lists the first page of all contacts. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_query_orders
ChatGPTFind and filter Squarespace ORDERS and get back a lean, browsable list. This is the starting point whenever the seller wants a SET of orders rather than one known order — "show me pending orders", "what has this customer ordered?", "which orders still need fulfilling?", "what was refunded?". Filter by fulfillmentStatus (PENDING, FULFILLED, CANCELED — note the single L), by paymentStates, by contactId, or by a modifiedOn date window. It returns only what you need to browse and pick — order number, dates, grand total, fulfilment and payment status, buyer email and ids — and deliberately NOT line items or transactions: once you have the right order, call squarespace_get_order with its id. Three constraints worth knowing. Omitting paymentStates is NOT an unfiltered browse: Squarespace then returns only NOT_CHARGED, AUTHORIZED, PAID and REFUNDED orders, so unpaid, failed and partially-paid ones are missing — pass all nine members when the seller asks for EVERY order. modifiedAfter and modifiedBefore must always be supplied TOGETHER, and cursor goes ALONE — Squarespace rejects it alongside any other parameter, so page 2 of a filtered query is the cursor by itself, which continues that same query. And they filter by LAST-TOUCHED date, not creation date, so an old order fulfilled yesterday matches yesterday — this API has no creation-date filter. If nothing matches you get an empty list, not an error. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_query_products
ChatGPTFind/browse Squarespace products and return a LEAN list (id, name, type, isVisible, urlSlug, seoOptions, createdOn, modifiedOn) plus pagination — no variants, pricing, or stock. This is the lean list tool: use it to find products by name search, product type (PHYSICAL/DIGITAL/SERVICE/GIFT_CARD), or last-modified date range, and paginate with a cursor. modifiedAfter and modifiedBefore must be sent TOGETHER, and cursor goes ALONE — page 2 of a filtered query is the cursor by itself, which continues that same query. Then call squarespace_get_product with a returned id to read one product in full (variants, pricing, images, stock). All inputs optional; an empty request lists the first page of the catalogue. It does NOT create or modify products. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_search_domains
ChatGPTSearch Squarespace's domain catalog for a keyword. Returns matching domains with registration availability, first-year price, renewal price, and checkoutLink on each available domain. Use when the user already has a keyword, brand name, or specific domain to look up. Not for WHOIS lookups, DNS or hosting configuration, or general web search. When presenting results to the user, use a markdown table with columns Domain | Price | Renewal | Purchase. - Domain: the domain name as plain text (not the checkout URL). - Price and Renewal: from price and renewalPrice. - Purchase: checkoutLink for that row, copied verbatim into the cell. Every available domain must have a Purchase link; do not omit the Purchase column or leave available rows without checkoutLink. If the row with suggestionType exactMatch has available=false, state that it is taken before showing alternatives. When available is null, availability was not checked; that does not mean the domain is taken. The query parameter is a short keyword (about one to three words), not a full sentence. If the user names a specific domain, pass it in full (for example acmecoffee.com): an exactMatch row appears only when the query includes the TLD. If a domain the user asked about is not in the results, its availability is unknown; search for it by its full name rather than calling it taken.
squarespace_update_contact
ChatGPTUpdate an existing Squarespace contact and/or one of its address-book entries. Send only the fields you want to change (name, locale, email, marketing consent); to change an address send both addressId and address, and only the address fields you pass are modified. Returns a diff of what changed — updatedFields names the changed fields (plus "address" when an address was updated), not the full contact record; if one half fails after the other succeeded, the result carries addressError or contactError rather than losing the write. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId (from account_websites_list).
squarespace_update_product
ChatGPTUpdate an EXISTING Squarespace product of ANY type (PHYSICAL, SERVICE, GIFT_CARD, DIGITAL) — one tool for every type, so you never choose a per-type variant. In a single call you can change product-level fields (name, description, isVisible, urlSlug, tags, seoTitle, seoDescription, and for a DIGITAL product price/salePrice/onSale), edit existing variants (sku, price/salePrice/onSale as {currency, value} strings, gtin, mpn, shippingMeasurements) via variants[], add new variants via addVariants[] (pricing as {basePrice, salePrice, onSale}, the same shape the create tools take, and option values in attributes, PHYSICAL and SERVICE only), remove variants via removeVariantIds[], and set stock via stockUpdates[] (operation "set" with a quantity, or "unlimited"). This tool does NOT set the product's option names (variantAttributes) or change an existing variant's option values. A NEW variant's option values are set here: on a PHYSICAL or SERVICE product with option names, each addVariants[] entry needs attributes with a value for every option name, in a combination no other variant uses (e.g. {"Size": "M"}); a PHYSICAL or SERVICE product with no option names can't take a new variant here until its options are added (e.g. in the Squarespace Commerce panel); GIFT_CARD and DIGITAL products have no options and reject attributes. Send only what changes: an omitted field is left unchanged, and passing null CLEARS a clearable field (description, tags, seoTitle, seoDescription, a variant's salePrice) — there is no present:false, and name and urlSlug cannot be cleared. NOT EVERY FIELD APPLIES TO EVERY TYPE: DIGITAL products have NO variants, so variants[], addVariants[], removeVariantIds[] and stockUpdates[] do NOT apply to them (a DIGITAL product's price is set with the product-level price/salePrice/onSale, which apply to DIGITAL only); and gtin, mpn and shippingMeasurements are PHYSICAL only — a field the type does not support is rejected. The response is a DIFF of what changed (updatedFields, editedVariants, addedVariants with their new ids, removedVariantIds, stockUpdates), NOT the whole product; each of the product-level, edit, add, remove and stock parts succeeds or fails on its own, and a failed part is named in productError / variantErrors / stockError rather than failing the whole call. If nothing could be written the call returns an error. Get ids from squarespace_get_product; use the squarespace_create_* tools to make a new product. Requires the caller to be logged in to Squarespace; if not yet authenticated, the MCP client should complete the login flow before calling this tool. Requires a websiteId.
account_websites_list
Claudesquarespace_create_contact
Claudesquarespace_create_gift_card_product
Claudesquarespace_create_physical_product
Claudesquarespace_create_service_product
Claudesquarespace_generate_domain_names
Claudesquarespace_get_contact
Claudesquarespace_get_order
Claudesquarespace_get_product
Claudesquarespace_list_store_pages
Claudesquarespace_query_contacts
Claudesquarespace_query_orders
Claudesquarespace_query_products
Claudesquarespace_search_domains
Claudesquarespace_update_contact
Claudesquarespace_update_product
Claude