Skip to main content
Glama
@cmssy/mcp-server

@cmssy/mcp-server

Official

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CMSSY_API_URLNoAPI URL (optional; defaults to https://api.cmssy.io)
CMSSY_API_TOKENYesAPI token (cs_xxx) from Dashboard > API Tokens
CMSSY_WORKSPACE_IDYesWorkspace ID (Workspace Settings > General)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

cmssy is a headless CMS: the site is your own app, cmssy stores its pages and content, and the cmssy editor edits the app live inside a frame.

To build a website or app on cmssy, follow this order. Do not invent the wiring - every file comes from get_site_setup.

  1. Call get_site_setup. It returns every file the app needs (catch-all page, editor route, proxy, config, block registry, layout), the npm packages and the env vars with their values.

  2. Write those files exactly, then design the site's own blocks with defineBlock and register each one in cmssy/blocks.ts. A header, footer or sidebar is a layout block: declare layoutRegions on it (e.g. ["header"]) and render it through the layout regions the files already wire - never as a regular page block.

  3. Deploy the app, then call set_preview_url with its exact deployed origin (e.g. https://my-site.vercel.app). Create a content.changed webhook with create_webhook pointing at /api/revalidate, set its signing secret as CMSSY_WEBHOOK_SECRET and redeploy - without it a publish reaches the site only after the page cache expires (up to an hour).

  4. The cmssy editor reads your block types when it frames the deployed app. Ask the user to open a page in the cmssy editor once, then call list_block_types: only registered types can be added. New types register at once; a change that removes or reshapes types (such as dropping the sample hero) waits as a proposal - if your types are missing, ask the user to make the proposed manifest active in Settings -> Headless -> Block manifest.

  5. Create pages with create_page and fill them with add_block_to_page. Put header and footer blocks into their regions on the home page with add_block_to_page and layoutRegion: "header" or "footer" - without layoutRegion the block lands in the page body. Layout is inherited down the page tree: a page created with parentId set to the home page's id inherits its header and footer, while a top-level page needs its own.

  6. Call publish_page for every page. The public site serves published pages only - an unpublished page answers 404.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_site_setupA

Everything needed to build a website or app on this cmssy workspace: the exact files to write (catch-all page, editor route, proxy, config, block registry, header/footer layout regions), the npm packages, the env vars filled in for this workspace (CMSSY_DRAFT_SECRET included - server-only), and the steps in order. Call it first whenever you build or wire a site, instead of reconstructing the setup from documentation.

list_pagesA

List the workspace's pages (id, name, slug, published), optionally filtered by a search string.

get_pageA

Get one page's full details (blocks, layout, page type, custom fields, the SEO title/description/display name per language, and its version - pass it as expectedVersion to patch_block_content) by id or slug. Use when the user asks about a specific page's content, structure or SEO.

get_site_configB

Get the workspace's site configuration: languages, site name, enabled features, and the cart/commerce settings (currency, tax rates, shipping methods, custom order fields).

set_preview_urlA

Point the cmssy editor at the deployed app: stores the origin of url as the workspace preview URL, the address the editor frames. Use the exact deployed origin (https://my-site.vercel.app) - a wrong host, such as an added www., leaves the editor reporting that the preview did not respond.

list_block_typesA

List the block types available on the workspace's site, each with its content field schema and default values. Use a block type's schema to shape content for add_block_to_page / update_block_content / patch_block_content - content is language-keyed ({ en: { fieldKey: value } }), and a relation field stores record id(s) per its relationTo/relationType. A non-empty layoutRegions marks a layout block (header/footer) managed via update_page_layout, not page body blocks.

list_block_usageA

Show where each block type is stored across the workspace: draft and published page blocks, layout regions (draft and published) and developer drafts, with per-surface counts and the pages that hold it. registered says whether the active block manifest still declares the type; orphanTypes lists types stored but no longer registered (the site renders nothing for them), unusedTypes lists registered types no page uses. Use it before renaming or removing a block type in code, then migrate or remove the instances it lists with update_block_content / remove_block_from_page.

get_workspace_infoA

Get the current workspace's info: name, slug, its organization's plan and the plan limits pooled across the organization - workspaces, member seats, pages, storage, upload size, Content API requests and transfer per month, orders per month, and whether single sign-on is included. Only pages and orders can be unlimited (null).

list_mediaA

List media files (images and files) in the workspace, newest first. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter.

upload_mediaA

Upload a file to the workspace media library from a local path or a remote URL (max 50MB; images, video, audio, PDF and common office documents). Returns the stored asset whose url can be used in block content and record media fields.

list_media_foldersA

List media folders in the workspace (optionally under a parent folder). Use this to discover a folderId before uploading or moving assets.

create_media_folderA

Create a media folder for organizing assets. Returns the folder, whose id can be passed to upload_media (folderId) or move_media.

update_media_folderA

Rename a media folder and/or move it under a different parent folder.

delete_media_folderA

Delete a media folder. By default only empty folders are removed; pass deleteContents to also delete the assets inside, and force to override the refusal that protects assets still in use.

delete_mediaA

Move media assets to the trash. They can be restored in the cmssy admin for 30 days, after which they are deleted permanently. Assets still in use are refused unless force is set. Ids not found in this workspace are skipped, so compare deleted with requested.

list_trashed_mediaA

List the media trash, newest first. Each file shows when it was deleted and when it expires; after that it is deleted permanently. A file with isPurging true is being deleted and cannot be restored. Restore with restore_media. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter.

restore_mediaA

Restore media assets from the trash. Each returns to its folder, or to the library root when that folder no longer exists (counted in movedToRoot). Ids not in the trash are skipped, so compare restored with requested.

move_mediaA

Move one or more media assets into a folder (or to the root with folderId: null). Use list_media_folders to find the destination folderId.

list_teamA

List the team - the people who manage this workspace - with their role and status (active, suspended, or a pending invitation). Not shoppers: those are records of the customer model. Read-only; filter by status or a search string; page on with skip while hasMore is true.

list_rolesA

List the roles defined in this workspace and the permissions each one grants. Read-only. Useful for understanding who can do what.

list_customersA

List the customers - accounts that sign in to the user's site (records of an accounts model), with status, verification, last login, their company, companyRole (the effective company role: admin or buyer in v1, null without a company), effectivePriceList (the price list that prices them, source MEMBER or COMPANY; null = catalogue prices) and orderStats (non-canceled order count, last order date, and net spend = paid minus refunded, in minor units, one entry per currency; null when the caller may not view orders). Not the team: those are list_team. Read-only; filter by model, status, company or an identity search; newest first. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter.

get_customerA

Get one customer by id: the account summary (identity, status, verification, lock, last login, company, companyRole - the effective company role, a key of the workspace's role catalogue (v1: admin, buyer), buyer unless staff set another for the company they belong to now, null without a company - priceList (the list assigned to the customer themselves, ignored while they belong to a company), effectivePriceList (the list that prices their carts and orders: id, name, source MEMBER or COMPANY, companyName when COMPANY; null = catalogue prices) and orderStats: non-canceled order count, last order date and net spend in minor units per currency, null without orders:view) plus the profile record's data. Read-only.

suspend_customerA

Suspend a customer: blocks sign-in and ends every live session. Orders and carts stay. Refused for an account that has not verified yet or is already suspended.

unsuspend_customerB

Let a suspended customer sign in again and clear any lockout. Refused for a customer who is not suspended.

send_customer_password_resetA

Issue a password reset token, the same one the site's forgot-password flow issues, and send it as the webhook event account.password_reset_requested to the workspace's webhooks; when the customer's model has account emails on (get_model auth.email.enabled), cmssy also emails the customer itself. The token works for one hour. For an active customer who cannot sign in. Refused for a suspended customer, for one who has not verified yet (use resend_customer_verification), for a customer whose account model has no password sign-in, and after five account requests for the same customer in an hour. emailDelivery.status is cmssy's own email: SENT (handed to the email provider), FAILED (not sent - error says why, the email log lists it) or OFF (the model leaves emailing to the app). endpointSubscribed: false means no enabled webhook endpoint receives the event; with emailDelivery OFF nothing then reaches the customer.

resend_customer_verificationA

Issue a fresh verification token for a customer whose status is pending and send it as the webhook event account.verification_requested to the workspace's webhooks; when the customer's model has account emails on (get_model auth.email.enabled), cmssy also emails the customer itself. The previous token stops working and the new one lasts 24 hours. Refused for a customer who is already verified or is suspended, and after five account requests for the same customer in an hour. emailDelivery.status is cmssy's own email: SENT (handed to the email provider), FAILED (not sent - error says why, the email log lists it) or OFF (the model leaves emailing to the app). endpointSubscribed: false means no enabled webhook endpoint receives the event; with emailDelivery OFF nothing then reaches the customer.

unlock_customerA

Unlock a customer who was locked out after too many failed sign-ins: clears the failed-attempt counter, lockedUntil and the sign-in throttle for that identity, so the next sign-in with the right password succeeds. Does not change the password and does not reinstate a suspended customer (that is unsuspend_customer, which also clears the lock).

set_customer_company_roleA

Give a customer a company role in the company they belong to now. Roles come from the workspace's catalogue; v1 has two: 'admin' sees every order placed for the company, 'buyer' (the default) only their own. The role holds only while the customer stays in that company - moved to another, they are buyer there. Refused when the customer has no company, and for a key outside the catalogue. Returns the customer with companyRole as the effective role.

list_price_listsA

List the workspace's price lists (Gold, Silver, dealer tiers ...), by name: each with percentOff (percent off the catalogue, 2 decimals; negative = a markup), startsAt / endsAt and active (false outside that window: the list prices nobody and its buyers pay catalogue prices), overrideCount (fixed prices it holds), assignedCount (companies and customers it prices) and channels (the sales channels it is published to, with key and priceAccess). A list prices a buyer from a fixed price per product or variant where it has one, else the catalogue price minus percentOff. Read-only; entries are in get_price_list.

get_price_listA

Get one price list by id with a page of its fixed prices (entries, oldest first, at most 200 per page; pass nextCursor back as after for the next page, null on the last). An entry is a fixed unit price in minor units for one product (variantKey null) or one variant of a product with variants, with its own volume breaks (tiers), its order bounds (minQuantity / maxQuantity, null = none) and its currency (an additional currency's row names it; a default-currency row reads the product's currency); recordMissing true means the product or variant was removed and the entry prices nothing - remove it with remove_price_list_entries. Filter by recordId to see one product's entries. Read-only.

create_price_listA

Create a price list: a percent off the catalogue (percentOff, -1000 to 99.99 with 2 decimals, default 0; negative = a markup) plus fixed prices per product or variant added with set_price_list_entry / set_price_list_entries. A fixed price overrides the percent for its product or variant; every other product gets the catalogue price minus percentOff. Then assign it to a company (set_company_price_list) or to a customer without a company (set_customer_price_list) - each buyer has one list: a company's members pay the company's list. startsAt / endsAt limit when it prices; outside that window its buyers pay catalogue prices. channels publishes it to sales channels by key: storefronts sending that channel are priced from it (a buyer's own or company list still wins for every product it prices), and anyone can read the prices of a list published to a PUBLIC channel.

update_price_listA

Rename a price list, change its percentOff (-1000 to 99.99, 2 decimals, negative = a markup; it prices every product the list holds no fixed price for) its startsAt / endsAt window (null clears a bound), or the sales channels it is published to (channels replaces the whole set, [] unpublishes it from every channel, leave it out to keep). Fixed prices are changed with set_price_list_entry / set_price_list_entries. Carts already priced from the list keep their prices until the buyer adds again; orders keep theirs.

delete_price_listA

Delete a price list with all its fixed prices and unassign it from every company and customer it prices (see assignedCount in list_price_lists) - they pay catalogue prices from then on - and unpublish it from every sales channel it is published to (see channels). Orders keep the list name they were priced under. Cannot be undone.

set_price_list_entryA

Set a price list's fixed price for one product, or one variant of a product with variants (variantKey required there - a list prices each variant on its own, never the product as a whole; omit it for a product without variants). currency picks the row: omitted is the default-currency row, an additional currency writes that currency's own row, which prices only carts in it. The fixed price (minor units of the row's currency, with optional volume breaks) overrides the list's percentOff for that product or variant; replaces the entry already set for it as a whole, so an existing minQuantity / maxQuantity left out of the call is cleared - read it with get_price_list and re-send it to keep it. For many rows use set_price_list_entries.

set_price_list_entriesA

Upsert up to 1000 fixed prices on a price list in one call (an ERP or spreadsheet import). Each row is one product (no variantKey) or one variant of a product with variants (variantKey required there), price in minor units of the row's currency (currency omitted = the default currency; an additional currency writes that currency's own row) with optional volume breaks and optional minQuantity / maxQuantity order bounds; a row replaces the whole entry already set for the same product/variant and currency, so bounds it had are cleared unless the row re-sends them (read them with get_price_list); every other entry stays. All or nothing: one invalid row refuses the whole call and the error names every bad row by index. Fixed prices override the list's percentOff. Never removes entries - use remove_price_list_entries for that.

remove_price_list_entriesA

Remove up to 1000 fixed prices from a price list by key: recordId alone for a product without variants, recordId + variantKey for one variant of a product with variants; currency limits a key to that currency's row, without it every currency's row goes. Those products then fall back to the catalogue price minus the list's percentOff. Returns how many were removed; a key with no entry removes nothing.

set_customer_price_listA

Assign a price list to a customer without a company (a B2C VIP); null unassigns. One list per buyer: a customer in a company pays the company's list, so assigning to them is refused - assign the list to the company with set_company_price_list instead. Returns the customer with priceList (their own) and effectivePriceList (the one that prices them, source MEMBER or COMPANY).

set_company_price_listA

Assign a price list to a company record; null unassigns. Every member of the company pays this list - one list per buyer, and a member's own list is ignored while they belong to the company. A company without a list leaves its members on catalogue prices. Refused for a record that is not a company (a model with the Company capability) - for a customer use set_customer_price_list. Returns the record id and its priceListId.

set_company_price_display_modeA

Set how the buyers of a company record read prices: net (VAT added on top) or gross (VAT inside); null falls back to the default, net for a company buyer. Applies to carts started after the change; existing carts and orders keep the mode they were priced in. Refused for a record that is not a company (a model with the Company capability). Returns the record id with its priceDisplayMode and taxRoundingMethod.

set_company_tax_roundingA

Set how VAT is rounded for the net-price buyers of a company record: per_line or per_rate; null falls back to the workspace's companyTaxRounding (update_cart_config). Gross-price buyers and consumers are always rounded per_line. Applies to carts started after the change; existing carts and orders keep the method they were priced with. Refused for a record that is not a company (a model with the Company capability). Returns the record id with its priceDisplayMode and taxRoundingMethod.

set_company_vat_idA

Set the EU VAT id of a company record. cmssy normalizes it (spaces, dots and dashes dropped, GR read as EL) and checks it against the member state's format; a malformed id is refused (BAD_USER_INPUT). null or empty clears it. A changed id is no longer verified, so its orders are taxed as standard until set_company_vat_verified attests the new value. Needs customers:manage. Verifying the id or exempting the company (set_company_vat_verified, set_company_tax_exemption) needs customers:manage and site:config:edit, and so does linking a customer to a company whose VAT id is verified or that is tax exempt. Refused for a record that is not a company (a model with the Company capability). Returns the record id with vatId, vatCountry, vatVerifiedAt, vatVerifiedBy and taxExemptReason.

set_company_vat_verifiedA

Attest that a company record's VAT id was checked (for example in VIES), or withdraw that attestation. A verified EU VAT id of another member state than the workspace's sellerCountry (update_cart_config) zero-rates the company's orders as reverse charge, unless an order ships to the seller's country, or out of the EU as an export; withdrawing it taxes them as standard again. Carts already holding the old status are refused at checkout (BUYER_CHANGED) and orders keep the treatment they were placed with. Refused when the company has no VAT id (set it with set_company_vat_id) and with CONFLICT when the stored id differs from expectedVatId. Needs customers:manage and site:config:edit, the same pair as set_company_tax_exemption and as linking a customer to a company whose VAT id is verified or that is tax exempt. Refused for a record that is not a company (a model with the Company capability). Returns the record id with vatId, vatCountry, vatVerifiedAt, vatVerifiedBy and taxExemptReason.

set_company_tax_exemptionA

Exempt a company record's orders from VAT, or clear the exemption with null. An exempt company's carts and orders carry 0% and 0 tax with reason as the legal note, whatever its VAT id; in a workspace that stores gross prices the VAT inside them is removed, not charged. Carts already holding the old status are refused at checkout (BUYER_CHANGED) and orders keep the treatment they were placed with. Needs customers:manage and site:config:edit, the same pair as set_company_vat_verified and as linking a customer to a company whose VAT id is verified or that is tax exempt. Refused for a record that is not a company (a model with the Company capability). Returns the record id with vatId, vatCountry, vatVerifiedAt, vatVerifiedBy and taxExemptReason.

list_sales_channelsA

List the workspace's sales channels (retail, horeca, b2b ...), by key. A storefront sends a channel's key to be priced from the price lists published to it: per product the buyer's own or company list wins, then the channel's dated list whose window holds now, then its base (undated) list, then the catalogue. Each channel has key (what the storefront sends, fixed once created), name, displayMode (net or gross prices for visitors and customers without a company), priceAccess (PUBLIC - anyone; MEMBERS - signed-in customers, registration is open; COMPANY_MEMBERS - buyers of an approved company), activePriceList (the list pricing it now), priceLists (every list published to it), nextChangeAt (when its prices next change) and activeCartCount (open carts on it). Read-only.

get_sales_channelB

Get one sales channel by id: key, name, displayMode, priceAccess, activePriceList (the dated list whose window holds now, else the base list), priceLists published to it with their windows, nextChangeAt and activeCartCount (open carts a delete would abandon). Read-only.

create_sales_channelA

Create a sales channel, at most 20 per workspace; a duplicate key is refused. The channel prices nothing until a price list is published to it (create_price_list / update_price_list with channels): one undated base list plus dated lists whose windows do not overlap. Channel keys are public - any storefront can send one - so priceAccess decides who sees its prices and may buy through it. currency picks what the channel sells in (the default currency when omitted): its carts, orders, shipping and discounts are in it, and a product with no price in it is not sold there.

update_sales_channelA

Rename a sales channel or change its displayMode, priceAccess or currency. The key cannot change. Changing the currency abandons the carts open on the channel - check activeCartCount first. Narrowing priceAccess refuses carts and checkout to buyers who no longer qualify; their carts are kept and come back if access returns. Which lists price the channel is changed on the price list (update_price_list channels).

delete_sales_channelA

Delete a sales channel and unpublish every price list from it. Its open carts are abandoned - activeCartCount in list_sales_channels / get_sales_channel says how many - and storefronts still sending its key are refused (BAD_USER_INPUT). Orders keep the channel they were placed through. Cannot be undone.

create_pageA

Create a new draft page with a name and slug (content/blocks are added later in the editor). Optional: parentId, pageType, multilingual displayName/seoTitle/seoDescription, customFields.

update_page_blocksA

Set the full content blocks array on a page (replaces all existing content blocks). Blocks with matching ids keep their existing content when not provided. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused on the shared draft unless the page already stores that block - compose types that are not deployed yet in target: 'devDraft' and promote once the code ships; pick registered types from list_block_types.

promote_dev_draftA

Promote YOUR per-user dev draft overlay onto the page's shared draft (replaces the shared draft blocks; the overlay belongs to the token's user). Do this after the block code for the composed types is deployed to the site. Fails when you have no dev draft for the page. The promote is refused with DEV_DRAFT_PROMOTE_REFUSED when the dev draft introduces block warnings the shared draft does not already carry, or empties a language, the shared values or the flat content a shared-draft block holds, or leaves out a shared-draft block that holds content (it would be removed from the page); the error lists the blockWarnings and emptiedBlocks, where removed: true marks a left-out block. Fix the dev draft (update_page_blocks with target: 'devDraft') and promote again; pass force: true only after fixing is ruled out. Promoting a block whose type the workspace block manifest does not register is refused - run cmssy sync-manifest from the deployed code first.

update_page_settingsA

Update page metadata: name, slug, parent and position in the tree, display name, SEO fields and custom fields. Only the languages and fields you pass change - the ones you omit keep their current values.

list_page_typesA

List the workspace's page types (templates) with their id, name, slug and url prefix.

create_page_typeB

Create a page type (template) with a custom-field schema. Pages of this type carry these custom fields.

get_page_typeA

Get one page type with its full custom-field schema - the field keys, types and options that pages of this type carry in customFields, and for relation fields their relationTo / relationType. Use before writing customFields on a page, because list_page_types does not return the fields.

update_page_typeA

Update a page type: name, slug, icon, url prefix, allowChildren, or its custom-field schema. Fields you omit keep their current value, EXCEPT fields, which replaces the whole schema.

delete_page_typeA

Delete a page type. Refused for system types and for a type any page still uses - move or delete those pages first.

publish_pageB

Publish a page (or re-publish with the latest draft changes). Publishes both content and layout.

unpublish_pageA

Unpublish a published page (toggles its published state off).

take_over_page_lockA

Take over the edit lock on a page another editor is holding open, so the next write (publish_page, update_page_blocks, update_page_layout, ...) is not refused with PAGE_LOCKED. The previous holder is bounced to read-only and may lose unsaved work. Needs pages:edit or pages:publish on the page.

revert_to_publishedA

Discard all draft changes and revert a page to its last published version.

delete_pageA

Move a page and all its descendants to the trash. The page leaves the site at once; the group stays restorable with restore_page (as unpublished drafts) for 30 days, after which it is deleted permanently. Cannot delete the homepage.

list_trashed_pagesA

List the page trash, newest first. Each entry is one deleted group - a page plus the descendants deleted with it: id (the trash id restore_page takes), name, slug, deletedAt, deletedById and deletedByName, descendantCount, and expiresAt, when the group is deleted permanently (30 days after deletion). Only groups the caller holds pages:delete on are listed; without it the list is empty.

restore_pageA

Restore a deleted page group from the trash: the page and every descendant deleted with it come back, all as unpublished drafts, with their content, history and ids. When the original parent no longer exists the page comes back at the top level. Refused with CONFLICT, restoring nothing, when a live page already uses one of the group's slugs (the error names the slug) or one of the pages is still live; refused with PLAN_LIMIT_EXCEEDED when the restored pages would exceed the organization's page limit. Needs pages:delete. Returns the restored root page with its published state.

update_page_layoutA

Update page-level layout: inheritance, overrides, or replace all layout blocks. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused unless the page already stores that block - pick registered types from list_block_types.

update_region_settingsA

Set the settings of one layout region on a page, e.g. a sidebar's width or a header's variant. Reads the page's current region settings, replaces only the named region and writes the whole list back (page.updateLayout with layoutRegionSettings, one version-guarded write); entries for regions or keys the manifest no longer declares are pruned on the way. Values are validated against the workspace layout manifest's region settings schema: an unknown region, an unknown key, or non-empty values on a region that declares no settings (such a region accepts {} only) is rejected with the backend's BAD_USER_INPUT message. Child pages inherit the region's settings unless they set their own (see get_page.resolvedRegions).

add_block_to_pageA

Add a block to a page (auto-generates the block id). Pass layoutRegion to add a layout block; omit it for a content block in the page body. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused unless the page already stores that block - pick registered types from list_block_types.

update_block_contentA

Update a specific block's content on a page. Defaults to merging with existing content; pass mode: 'replace' to overwrite the block's whole content. Works for content and layout blocks. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused on the shared draft unless the page already stores that block - compose types that are not deployed yet in target: 'devDraft' and promote once the code ships; pick registered types from list_block_types.

patch_block_contentA

Apply surgical edits (insert_before/insert_after/replace_section, or replace_all to set the whole string, given the value it replaces) to one string in a block's localized content without re-sending the full content - including a string nested in a list or object, via a dotted fieldPath such as 'tabs.0.label'. Each marker must match exactly once. If the result includes blockWarnings, the saved content violates the workspace block manifest (unknown field, wrong value shape, or a stored block whose type is no longer registered) - correct the content and save again, unless the warning is about a stored block whose type is no longer registered: that one is a manifest problem, so restore or sync the type, or find the block with list_block_usage and migrate or remove it. When the warnings also say when the workspace block manifest was last synced, the field or type may simply be newer than the manifest: if the site's code declares it, keep the content and sync the manifest (cmssy sync-manifest in the site's repo) instead. A block whose type the workspace block manifest does not register is refused unless the page already stores that block - pick registered types from list_block_types.

remove_block_from_pageA

Remove a specific block from a page by its instance id. Works for content and layout blocks.

list_formsA

List the forms in the workspace. Filter by status; page on with skip while hasMore is true.

get_formA

Get one form's full details (fields, settings, submission count) by id or slug.

create_formA

Create a new form with a name and slug. Optional: field definitions, per-field showWhen/requiredWhen conditions, and settings (action type, notifications). Fields can also be added later in the Forms editor.

update_formA

Update an existing form's name, slug, status, fields or settings. Name the settings keys you are changing - the rest keep their stored values. 'fields' is the opposite: it replaces the whole array, so send every field you want the form to keep.

delete_formA

Permanently delete a form and all its submissions.

list_form_submissionsB

List form submissions, optionally filtered by form and status; paginated. Returns submission rows with their data and status.

get_form_submissionA

Get one form submission's full details by its id.

update_form_submission_statusB

Update a form submission's status (pending, processed, spam, archived).

delete_form_submissionB

Permanently delete a form submission.

list_modelsA

List the data models (content types) defined in the current workspace. Use to answer 'do we have models / a Product model?' or to see what data structures already exist.

get_modelA

Get the full details of one data model by id or slug: complete field definitions (type, options, relations, validation) the product capability config (enabled, field roles incl. the resolved roles, variantAxes) the accounts config (auth: identityField, companyField - a relation to a Company model, registration - open or closed, closed means siteMember.register refuses new sign-ups, email - whether cmssy sends verification, password reset and login change emails itself (enabled, links URL templates, templates copy overrides per kind and locale; off means the app's webhook sends them); each field's memberCanSet says whether the member may change it on their own account and send it at sign-up, never for password fields or the company field) the Company capability (company: { enabled }, null when never set; a model is at most one of product, account or company) and urlPattern, the storefront route its records' url is built from (null when none). Use before update_model and when the user asks about a model's structure.

create_modelA

Create a data model in the workspace. Every field label (and description) is text per language code of the workspace: { en: "Title", pl: "Tytuł" }. Field types include select/multiselect (provide options as [{ value, label }] - the value is what records store), relation (link to another model via relationTo = the target model's slug + relationType), and object/list (nested fields/itemFields). Optional model-level config: slug, description, icon, color, displayField, defaultSort, statusField, product (commerce capability: enabled, priceField, skuField, inventoryField, variantAxes), auth (accounts: enabled, identityField, companyField for a B2B company link - a relation to a model with Company enabled, registration - "open" by default, "closed" when only admins create accounts, email - { enabled, links, templates } for cmssy sending account emails itself, off by default; a field's memberCanSet opens it to the member on their own account and at sign-up - registration accepts only those fields, never password fields or the company field), company ({ enabled }: its records are the companies an accounts model links; a model is at most one of product, account (auth) or company), uniqueFields (field keys whose value must be unique - lets import_records update by that key) and deliveryAccess - a model is "none" (admin only) by default, so pass "public" when the user's app must read it through the delivery API. urlPattern (e.g. /p/{slug}) says where its records live on the storefront, so their url becomes a working link - ask the user for their route rather than inventing one.

update_modelA

Update a data model by id or slug: name, slug, description, icon, color, displayField, defaultSort, statusField, fields, product capability config, uniqueFields (replaces the whole list; refused while records already share a value), deliveryAccess ("public" lets the user's app read the model through the delivery API; "none" is admin only), or urlPattern (where its records live on the storefront, e.g. /p/{slug} - their url is built from it; null removes it). fields is a PATCH - listed fields are added or replaced by key, unlisted fields stay untouched; use removeFields to delete fields and fieldOrder (every remaining key, in order) to reorder them. product is also a PATCH of the commerce capability config (enabled, priceField, skuField, inventoryField, variantAxes) - omitted keys keep their stored values. While the product is enabled, a call that changes product, fields, removeFields or displayField is graded against every product role, and refused when one would name a missing field or a field of a type it cannot read. auth is a PATCH of the accounts config (enabled, identityField, companyField for B2B companies over customers - a relation to a model with Company enabled, registration, email, verification, lockout) - omitted keys keep their stored values, null unlinks the company. auth.registration "closed" stops self sign-up (siteMember.register refuses; admins still create accounts) - existing pending accounts can still verify their email, so suspend or delete those; "open" lets anyone sign up again. auth.email is a PATCH of the account emails cmssy sends itself: enabled true needs the workspace's default email configuration (refused without one) and the account.* webhooks still fire, so an app that mails too sends a second email; links merges URL templates by kind ({token} required, {siteUrl}, {locale}); templates replaces every copy override (call get_model first and send the full list to change one). Which fields a member may change on their own account and send at sign-up is each field's memberCanSet (registration accepts only those; password fields and the company field never). company is a PATCH of the Company capability ({ enabled }) - a model is at most one of product, account (auth) or company; turning it off is refused while an accounts model's companyField links it.

delete_modelA

Delete a data model. WARNING: this cascades - ALL records of the model are permanently deleted.

list_recordsA

List the records (entries) of a data model, by the model's id or slug. Supports filtering (per key: scalar equality, $in, $gte/$lte, $regex as a literal substring match), sort, and pagination. Each record includes its full data, so you can find a record by a field value (e.g. sku) without extra lookups. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter. Each record carries url: its live storefront link, built by the server from the model's urlPattern and the site's public site URL. Use it whenever you link to a record and never build a storefront URL yourself (not from a slug, not from the site address). When url is null or missing, say why instead of guessing: the model has no urlPattern (set it with update_model), the model is not delivered (deliveryAccess none, or it is the login model), the site has no public site URL, or the record - or one it links to - is unpublished.

get_recordA

Get one record (entry) of a data model by its id, including all its field values and status. A company record (a model with the Company capability) also carries vatId, vatCountry, vatVerifiedAt, vatVerifiedBy and taxExemptReason, null when unset (set_company_vat_id, set_company_vat_verified, set_company_tax_exemption). A product record also carries currencyPrices and variantCurrencyPrices - its prices in additional currencies, minor units, enabled false while that currency is not an additional currency (set_product_currency_prices, set_product_variants); its data holds the default-currency price. Each record carries url: its live storefront link, built by the server from the model's urlPattern and the site's public site URL. Use it whenever you link to a record and never build a storefront URL yourself (not from a slug, not from the site address). When url is null or missing, say why instead of guessing: the model has no urlPattern (set it with update_model), the model is not delivered (deliveryAccess none, or it is the login model), the site has no public site URL, or the record - or one it links to - is unpublished.

create_recordA

Add a record (entry) to a data model. Pass the model id or slug and a data object whose keys are the model's field keys (use get_model first if unsure). A product is a record too: pass a model whose product capability is enabled (get_model shows product.enabled), and list_products then lists it with its stock. Each record carries url: its live storefront link, built by the server from the model's urlPattern and the site's public site URL. Use it whenever you link to a record and never build a storefront URL yourself (not from a slug, not from the site address). When url is null or missing, say why instead of guessing: the model has no urlPattern (set it with update_model), the model is not delivered (deliveryAccess none, or it is the login model), the site has no public site URL, or the record - or one it links to - is unpublished.

update_recordA

Update an existing record by id (from list_records). Pass data to merge field values (fields you don't pass are unchanged), status to transition the record's lifecycle state, and/or published to take it on or off the site. At least one of data/status/published is required. Each record carries url: its live storefront link, built by the server from the model's urlPattern and the site's public site URL. Use it whenever you link to a record and never build a storefront URL yourself (not from a slug, not from the site address). When url is null or missing, say why instead of guessing: the model has no urlPattern (set it with update_model), the model is not delivered (deliveryAccess none, or it is the login model), the site has no public site URL, or the record - or one it links to - is unpublished.

delete_recordA

Permanently delete one record (entry) by its id. A record still used by page blocks is refused and the error lists those pages; force: true deletes it anyway and leaves those references stale.

import_recordsA

Bulk-import records into a data model (up to 1000 rows). Without upsertKey each row CREATES a record; with upsertKey (a unique field or the product SKU field) a row matching an existing record UPDATES it instead, so a repeated sync does not duplicate. A translatable field takes a language map ({ title: { en: '...', no: '...' } }); a language the workspace has not enabled is rejected. Returns importedCount (created), updatedCount, per-row errors, and per-row record ids with CREATED / UPDATED / UNCHANGED.

bulk_update_recordsA

Apply one change (field values, status and/or published) to many records of a model in a single call: the records named by ids, or every record matching filter with allMatching. Each record is validated, audited and announced to webhooks like update_record. Handles up to 200 records per call; a non-null nextCursor means more records match - pass it back with the same arguments to continue. Returns updated, unchanged (records already at the requested status and visibility, with no data to write), failedCount, a sample of failures (id + reason) and nextCursor.

list_ordersA

List orders in the workspace. Filter by payment, fulfillment or delivery status, state (open/closed/canceled), customer, company (B2B), pipeline stage, warehouse queue (to pack, in transit, shipping problem, returns), a search string (customer email or company name), currency, or a date range. Each order carries customerId, companyId and companyName when it was placed for a customer or a company. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter.

get_orderA

Get one order's full details by its id: items, the full money column (subtotal, discount, shipping, tax, total - all minor units), displayMode (net or gross, how the buyer read prices), taxRoundingMethod (per_line or per_rate), taxTreatment (kind standard, reverse_charge, exempt or export - goods shipped out of the EU VAT area, or from a seller outside the EU to another country, frozen at checkout with the facts it rests on: legalNote, the text to print on the invoice, null for standard; buyerVatId, buyerVatCountry and buyerVatVerifiedAt of the VAT id that decided it; sellerCountry; shipToCountry; orders placed before it was recorded read standard), removedTax (VAT taken out of gross-stored prices on a reverse_charge, exempt or export order, minor units, 0 otherwise; total = subtotal - discount + shippingTotal - removedTax), amounts (net, tax and gross of subtotal, discount, shipping and total), the frozen discount code, channel (the sales channel the order was placed through: id, key, name; null for none), priceList / priceListName (the primary price list the order was priced from, name frozen at checkout; null when none) and priceListSource (MEMBER, COMPANY or CHANNEL - whose list it was), pricingChain (the lists tried in order: buyer, channelDated, channelBase; each null when none) - every list reference carries deleted, true once that list was deleted after the order, and each item's priceListId / priceListSource name the list that priced that line, PO number, shipping address, payment/fulfillment status, amountPaid (collected so far), balanceDue (total - amountPaid, what the buyer still owes; a refund does not change it), refundedAmount (refunded so far across every refund, minor units; left to refund = amountPaid - refundedAmount), refundedAt (when the latest refund was recorded, null when none), refundReferences (the refund references recorded, oldest first - refund_order and refund_return ignore a reference already listed), invoices (every invoice recorded, oldest first: kind invoice - at most one, the order's invoice - then its corrections of kind correction, each with number, url, provider and issuedAt; record_order_invoice adds the invoice, record_order_invoice_correction a correction), and the parcels (shipments: id, carrier, tracking number and link, status, history) - a parcel's id is what update_shipment takes - the returns (id, number, status, lines with reason and received/restocked units, return-parcel tracking, refunded amount, history) - a return's id is what the *_return tools take - and customFields, the order's custom field values by key.

get_order_pipelineB

Get the workspace order pipeline (the configurable stages orders move through).

create_manual_orderA

Create a manual (admin-entered) order. Each item references a product recordId or is an ad-hoc line with name+price (minor units of the order's currency). currency picks the order's currency (default currency when omitted); payments and refunds on the order are in that currency. shippingAddress is optional; for a customer of a company with a verified VAT id its country decides whether the order is reverse charge, and the order freezes that tax treatment (get_order taxTreatment). Pass an idempotencyKey and, if the call times out or fails unclearly, retry with the same idempotencyKey so the retry cannot create a second order.

edit_orderA

Replace an order's line items (full replace of the items array). Recomputes totals.

update_order_detailsA

Update order metadata: customer email, internal notes, PO number, delivery address and custom order fields. Only provided fields change. A delivery address whose country would change the order's frozen tax treatment (taxTreatment in get_order, e.g. reverse_charge to standard) is refused (BAD_USER_INPUT, TAX_TREATMENT_CHANGED); cancel the order and place it again instead.

mark_order_paidB

Record a full payment for an order (manual reconciliation - does NOT verify with a payment provider). amount is in minor units of the order's currency.

record_order_paymentB

Record a (possibly partial) payment against an order's outstanding balance. amount is in minor units of the order's currency and capped at the balance due.

refund_orderA

Refund an order. Omit amount for a full refund; pass amount (minor units of the order's currency) for a partial refund.

cancel_orderA

Cancel an order. Takes only the order id - there is no reason field; when the user gives a reason, record it in the order's notes with update_order_details first.

close_orderA

Mark an order done (state closed). Paid and fulfilled orders usually close by themselves; it reopens by itself if it later stops being paid or fulfilled.

reopen_orderA

Reopen a closed order so it shows as work in progress again. A canceled order cannot be reopened.

create_shipmentA

Add a parcel to an order: the items it carries, carrier, tracking and status. This is also how an order is marked fulfilled. The order's fulfillment and delivery status follow its parcels; a pending parcel (no label yet) fulfils nothing.

update_shipmentA

Change a parcel's delivery status or correct its tracking. Only provided fields change; sending the stored values changes nothing.

create_returnA

Open a return on an order for items the customer is sending back. A return opened by the merchant starts approved. It does not move money or stock: receive_return restocks, refund_return records the refund. Pass an idempotencyKey and, if the call times out or fails unclearly, retry with the same idempotencyKey so the retry cannot open a second return on the order.

approve_returnC

Approve a return the customer requested.

reject_returnA

Reject a return the customer requested; it frees its items for another return.

cancel_returnA

Cancel a requested or approved return that has not been refunded.

receive_returnB

Record the return parcel as received: how many units of each line arrived and how many go back to stock. Stock is adjusted by the restocked units only.

refund_returnA

Record a refund for a return - money already sent back at the payment provider. It counts against the order's refunds and completes a received return.

complete_returnA

Close a received return without a refund, e.g. after store credit or a failed inspection.

update_return_trackingB

Set or correct the carrier and tracking number of the parcel the customer sends back.

set_order_pipeline_stageB

Move an order to a pipeline stage (use get_order_pipeline for valid stage ids).

record_order_invoiceC

Attach an invoice (number, optional URL and provider) to an order.

record_order_invoice_correctionA

Attach a correction invoice (credit note: number, optional URL and provider) to an order that already has its invoice, e.g. after a refund. Allowed on canceled and refunded orders; the number must be new to the order.

list_cartsA

List shopping carts (admin view) with optional status filter and pagination. totalValue is in minor units. channel is the key of the sales channel the cart was started on (null for none): a buyer has one active cart per channel.

delete_cartsA

Permanently delete 1 to 100 carts with their analytics events, the visitor sessions only they used and any discount use they held (the code's use count goes back down). All or nothing: an id that is not a cart of this workspace, or a cart already turned into an order (status ordered - anonymize the order instead), refuses the whole call and deletes nothing. Returns how many carts were deleted. Cannot be undone.

list_discountsA

List discount codes in the workspace. Filter by enabled, type, or a code search; page on with offset while hasMore is true.

get_discountA

Get one discount's full details by id or code: type, value, currency, minSubtotal (default currency, or a fixed code's own), minSubtotalByCurrency (per additional currency), usage limits and validity window.

create_discountA

Create a discount code. type is 'percentage' (value 0-100), 'fixed' (value in minor currency units, requires currency e.g. 'USD'; it applies only to carts in that currency), or 'free_shipping' (value 0). Optional limits: minSubtotal, maxUses, startsAt, endsAt. A cart is in its sales channel's currency; for a 'percentage' or 'free_shipping' code with a minimum, minSubtotal is the default-currency minimum and minSubtotalByCurrency the minimum in each additional currency.

update_discountA

Update a discount (partial). code/type/currency become immutable once the discount has been used. A code with any minimum (minSubtotal for the default currency, minSubtotalByCurrency for additional currencies) applies only in the currencies those minimums name.

set_discount_enabledB

Enable or disable a discount code.

list_productsA

List a product model's catalog with stock and variant info (onHand/reserved/available per record and variant). A product is a record of a model whose product capability is enabled (get_model shows product.enabled and the field roles): create one with create_record on that model and change it with update_record; set_product_tiers and the bulk_* product tools work on the same records. Paginated: while hasMore is true, pass nextCursor back as cursor while it is set; if hasMore is true but nextCursor is null, page with the offset instead, and past offset 10000 narrow the filter. Each record carries url: its live storefront link, built by the server from the model's urlPattern and the site's public site URL. Use it whenever you link to a record and never build a storefront URL yourself (not from a slug, not from the site address). When url is null or missing, say why instead of guessing: the model has no urlPattern (set it with update_model), the model is not delivered (deliveryAccess none, or it is the login model), the site has no public site URL, or the record - or one it links to - is unpublished.

bulk_update_productsA

Bulk-update selected product records with a single patch (status, set/adjust stock, set/adjust price). Stock is whole units; price is major units - the stored price field value, not cents - and changes the default-currency price only; prices in additional currencies are left as they are. With allMatching the call is refused when more than 1000 products match: use start_bulk_update_products for that.

bulk_delete_productsA

Bulk-delete selected product records permanently. A product still referenced by an open order or a page block is skipped rather than deleted; each entry of skipped carries its reason. With allMatching the call is refused when more than 1000 products match: use start_bulk_delete_products for that.

start_bulk_delete_productsA

Start a background job that permanently deletes every product matching the filter. Use it instead of bulk_delete_products when more than 1000 products match. Returns the job at once; it runs in batches, so follow its progress with get_product_bulk_job. A model runs one job at a time: if one is already queued or running the start is refused - read it with get_product_bulk_job by modelId. As with bulk_delete_products, a product still referenced by an open order or a page block is skipped; the finished job reports skippedCount and the first skipped products with their reason.

start_bulk_update_productsA

Start a background job that applies one patch (status, set/adjust stock, set/adjust price) to every product matching the filter. Use it instead of bulk_update_products when more than 1000 products match. Stock is whole units; price is major units of the default currency, and prices in additional currencies are left as they are. Returns the job at once; it runs in batches, so follow its progress with get_product_bulk_job. A model runs one job at a time: if one is already queued or running the start is refused - read it with get_product_bulk_job by modelId.

get_product_bulk_jobA

Read a background product bulk job's status and progress, by jobId or - for the job still queued or running on a model - by modelId (jobId wins when both are given). status goes queued -> running -> completed or failed; processed of total is the progress, deleted/updated what changed, skippedCount and skipped (first 20, with reason) what a delete left in place. A failed job carries failureReason (stalled, modelUnavailable, invalidPatch, enqueueFailed, unexpected). job is null when the id is unknown or the model has no active job. Jobs run in batches of a few hundred products: check again later rather than in a tight loop.

set_product_tiersA

Set the record-level volume price breaks on a product (B2B quantity discounts). They price the product and every variant that defines no breaks of its own; a variant's own breaks are part of its definition, so set those with set_product_variants. A line's unit price steps down to the highest break its quantity reaches, and the cart and the order both charge that price. Prices are minor units of the default currency; breaks in an additional currency are set with set_product_currency_prices. Passing an empty array removes the breaks. increment sets the order step on the same record.

set_product_variantsA

Define a product's variants. Each variant is one combination of values for the model's variantAxes (set those with update_model) and carries its own price, stock, SKU and volume breaks. The call replaces the whole set, so send every variant the product keeps - a variant left out is deleted. Every field but tiers and currencyPrices is written as sent (those two are kept when omitted), so copy sku and stock (onHand) from list_products for each variant you keep; both are required, null for none. Stock already reserved by carts stays with the variant that keeps its selection. Prices are minor units: price and tiers in the default currency, currencyPrices in each additional currency (omitted = kept, like tiers). To change only prices per currency use set_product_currency_prices variants instead - it never touches stock or SKU.

set_product_currency_pricesA

Set a product's prices in the workspace's additional currencies (update_cart_config additionalCurrencies), e.g. [{currency: 'EUR', price: 4500, tiers: [{minQty: 10, price: 4000}]}]. Prices and breaks are minor units of each currency; nothing is converted from the default-currency price. price is read only while the product has no variants - a product with variants takes each variant's price from variants (here) and these tiers price every variant without breaks of its own in that currency (price null keeps just the tiers). variants sets each variant's prices per currency by its key (list_products variants[].key), e.g. [{variantKey, prices: [{currency: 'EUR', price: 4500}]}], and never touches stock, SKU or the default-currency price - this is the safe way to price variants per currency; prefer it over set_product_variants currencyPrices, which rewrites every variant's stock and SKU. A product with no price in a sales channel's currency is not sold on that channel (NO_PRICE_IN_CURRENCY). prices replaces the record's whole list: send every currency the product keeps. A variant removed while the call ran fails it with CONFLICT - re-read list_products and retry.

update_cart_configA

Configure the workspace's commerce settings: default and additional currencies, whether prices include tax, tax rates, shipping methods, custom order fields, stock thresholds, cart limits, session lifetimes and the B2B toggles. Only provided fields change; arrays replace the whole list. companyTaxRounding is the workspace's VAT rounding for company buyers who read net prices (a company can override it with set_company_tax_rounding); consumers are always rounded per_line. sellerCountry and reverseChargeNote drive reverse charge: a company with a verified EU VAT id of another member state (set_company_vat_verified) pays 0% VAT and its orders carry the note. An order shipped out of the EU VAT area, or to any other country from a sellerCountry outside the EU, is zero-rated as an export for any buyer, with exportNote on the order. Nothing is converted between currencies: a sales channel sells in one of them (create_sales_channel currency), and every price in an additional currency is set explicitly (set_product_currency_prices, set_product_variants, set_price_list_entries currency, shippingMethods currencyPrices). Which models the store sells is not set here: a model is sellable when its product capability is enabled (update_model, product.enabled).

clear_cart_configA

Remove the workspace's commerce settings entirely, putting the cart back to never-configured. A workspace with orders or carts is refused unless force: true is passed. To change individual settings rather than remove them, use update_cart_config.

list_webhooksA

List the workspace's webhook endpoints (signing secrets are never returned here).

list_webhook_deliveriesB

List recent webhook delivery attempts (status: pending/success/failed) for debugging.

list_webhook_event_typesA

List the event types a webhook can subscribe to (the authoritative allowlist).

create_webhookA

Create a webhook endpoint subscribed to one or more events. The URL must be a public https endpoint. Returns the endpoint AND its signing secret (shown only once).

update_webhookA

Update a webhook endpoint (partial). Pass enabled to enable/disable. Pass description=null to clear it. The signing secret is not returned.

rotate_webhook_secretA

Rotate a webhook endpoint's signing secret. Returns the endpoint and the NEW secret (shown only once).

redeliver_webhook_deliveryA

Send a finished webhook delivery again. The stored payload goes out as a NEW delivery with its own id and its own retry ladder; the original row is left untouched and the new one records replayOf. A delivery that is still pending is refused.

delete_webhookB

Delete a webhook endpoint permanently.

list_email_configurationsA

List the workspace's email configurations: id, name, slug, description, provider, sender, default and active flags, and how many recipients each has. Pass an id as a form's emailConfigurationId in create_form or update_form. API keys, SMTP and Mailgun settings and recipient addresses are never returned here.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
sitemapFull page tree as JSON — all pages with hierarchy
workspaceWorkspace info and site configuration merged

TDQS

A3.5/5.0

Scored across 143 tools

Disambiguation4/5

Descriptions are exceptionally detailed and most tools have clearly distinct resource+action purposes (e.g. return lifecycle vs order lifecycle vs block editing). A few pairs still invite confusion—mark_order_paid vs record_order_payment (full vs partial), update_page_blocks vs update_block_content/patch_block_content, and bulk_update_products vs start_bulk_update_products—but the descriptions usually resolve them.

Naming Consistency5/5

Nearly all names follow a strict snake_case verb_noun pattern (list_/get_/create_/update_/delete_/set_/bulk_), with consistent resource nouns across domains. Minor quirks like edit_order and take_over_page_lock still fit the verb_noun shape and remain readable.

Tool Count1/5

143 tools is far beyond any reasonable MCP surface; even for a full CMS+commerce platform this is extreme and will overwhelm tool selection and context budgets. Many domain areas (orders, returns, pricing, pages, blocks, media, forms) each contribute a large cluster.

Completeness4/5

Coverage is remarkably comprehensive: full CRUD/lifecycle for models, records, pages, blocks, media, forms, webhooks, orders, returns, shipments, price lists, sales channels, and products, plus bulk/background jobs. Minor gaps remain (e.g. no delete_discount, email configurations are list-only), but agents can mostly work around them.

Maintenance

ActivityActive
ResponsivenessLimited data