Tools reference
The Cashfin MCP server exposes 130 tools. Every tool declares what it does to your data, so your assistant can ask for confirmation before risky calls:
| Hint | Meaning | Count |
|---|---|---|
| read | Reads only. Never changes your storefront. | 29 |
| write | Creates or updates drafts. Reversible in the builder, nothing goes live. | 78 |
| destructive | Deletes data or publishes drafts live. | 23 |
Recommended approval settings
Allow read and write tools without asking, and keep destructive tools on ask. Your site stays safe while the assistant works quickly.
Tools are listed by area below. Each tool's full description and input schema are sent to your assistant when it connects; ask the assistant to explain any tool if you need its parameters.
Cashfin shop
Read your business and catalogue, set brand colours, scaffold shop pages and bind storefront actions. See Shop & catalogue.
| Tool | Access | Description |
|---|---|---|
bind_product_options | write | Bind product options. Make the product page you designed work: name your own layers by role and the variants, modifiers, quantity, stock, gallery and add-to-cart/buy-now buttons are wired to the live product exactly like… |
get_shop_context | read | Get shop context. Read the Cashfin shop before any shop work: the business profile (name, logo, industry, contact, brand), bookings on/off, the currency, catalogue counts, the synced collections with their key field… |
scaffold_shop | write | Scaffold shop pages. Make sure the shop pages exist: /products (the catalogue), /products/* (the product page, bound to the Products collection) and /category/* (the category page, bound to Categories). |
set_brand_palette | write | Set brand palette. Set the shop's brand colours. |
set_storefront_action | write | Set storefront action. Make a layer you built (usually a button) do a shop action on the published site: add to cart, buy now, go to cart/checkout, open the cart drawer (ui.toggle), start a booking or save to the wishlist. |
Pages & redirects
Create, update and organise pages, and manage URL redirects.
| Tool | Access | Description |
|---|---|---|
add_redirect | write | Add redirect. Add a new URL redirect. |
create_page | write | Create page. Create a new page. |
delete_page | destructive | Delete page. Permanently delete a page and all its layers |
delete_redirect | destructive | Delete redirect. Delete a redirect by ID. |
duplicate_page | write | Duplicate page. Create a copy of a page including all its layers. |
get_page | read | Get page. Get a single page by ID, including its settings and metadata |
list_pages | read | List pages. List all pages in the website with their IDs, names, slugs, and folder structure. |
list_redirects | read | List redirects. List all configured URL redirects. |
update_page | write | Update page. Update a page's metadata: name, slug, folder, homepage flag, dynamic flag, and error-page assignment. |
update_page_settings | write | Update page settings. Update page SEO, custom code, password protection, or CMS binding (dynamic pages). |
update_redirect | write | Update redirect. Update an existing redirect by ID. |
Page folders
Group pages into folders that shape your URLs.
| Tool | Access | Description |
|---|---|---|
create_page_folder | write | Create page folder. Create a new page folder. |
delete_page_folder | destructive | Delete page folder. Delete a page folder and all its contents (pages and sub-folders). |
list_page_folders | read | List page folders. List all page folders with their hierarchy. |
update_page_folder | write | Update page folder. Update a page folder name, slug, or settings. |
Layers & elements
Read and edit the elements on a page: text, images, buttons, sections, and their design and settings.
| Tool | Access | Description |
|---|---|---|
add_layer | write | Add layer. Add a new element to a page. |
delete_layer | destructive | Delete layer. Remove a layer and all its children from a page |
export_layer_html | read | Export layer as HTML. Render a layer (and its descendants) to a self-contained HTML string with Tailwind classes preserved. |
get_layers | read | Get page layers. Get the layer tree for a page. |
move_layer | write | Move layer. Move a layer to a different parent or position within the page tree |
set_rich_text_content | write | Set rich text content. Set the content of a richText layer using structured blocks. |
update_form_settings | write | Update form settings. Configure how a form layer handles submissions. |
update_layer_background_image | write | Update layer background image. Set a background image on any layer in the Ycode editor (see https://docs.ycode.com) using an asset ID or URL. |
update_layer_design | write | Update layer design. Update the visual design of a layer. |
update_layer_iframe | write | Update layer iframe. Set the source URL for an iframe layer in the Ycode editor (see https://docs.ycode.com). |
update_layer_image | write | Update layer image. Set the image source of an image layer on a PAGE using an asset ID (from upload_asset or list_assets). |
update_layer_link | write | Update layer link. Configure a link on any layer (button, div, text, image, etc.) in the Ycode editor (see https://docs.ycode.com). |
update_layer_settings | write | Update layer settings. Update layer settings like HTML tag, custom ID, custom attributes, embed code, visibility, and per-element configuration (slider, carousel, lightbox, map, select options, filter, placeholder option). |
update_layer_text | write | Update layer text. Update the text content of a text, heading, or button layer. |
update_layer_video | write | Update layer video. Set the video source of a video layer in the Ycode editor (see https://docs.ycode.com). |
Batch operations
Apply many edits in one call.
| Tool | Access | Description |
|---|---|---|
batch_operations | write | Run batch layer operations. Execute multiple layer operations in a single call. |
Layout templates
Insert professionally designed sections from the layout catalogue.
| Tool | Access | Description |
|---|---|---|
add_layout | write | Add layout template. Insert a pre-built, fully-styled layout section into a page. |
list_layouts | read | List layout templates. List all available pre-built layout templates organized by category. |
HTML import
Turn HTML into native, editable Cashfin elements.
| Tool | Access | Description |
|---|---|---|
import_html | write | Import HTML as layers. Import HTML with Tailwind classes as native, editable Ycode layers in one call (see https://docs.ycode.com). |
Layer styles
Reusable named styles that many elements can share.
| Tool | Access | Description |
|---|---|---|
apply_style | write | Apply style. Apply a single reusable layer style to a layer, replacing any existing style stack. |
create_style | write | Create style. Create a reusable layer style — like a CSS class. |
delete_style | destructive | Delete style. Delete a reusable layer style. |
list_styles | read | List styles. List all reusable layer styles. |
set_layer_styles | write | Set layer styles. Set the ordered stack of reusable styles applied to a layer (combo classes). |
update_style | write | Update style. Update a reusable layer style — change its name or design properties. |
Rich-text styles
Typography for headings, paragraphs and lists inside rich text.
| Tool | Access | Description |
|---|---|---|
update_rich_text_styles | write | Update rich text element styles. Style the elements INSIDE rich text — every h2, paragraph, list, blockquote, link, image, table cell… rendered by a richText layer (including CMS rich_text fields bound to it). |
Color variables
Site-wide colour tokens referenced as var(--id).
| Tool | Access | Description |
|---|---|---|
create_color_variable | write | Create color variable. Create a new color variable (design token). |
delete_color_variable | destructive | Delete color variable. Delete a color variable. |
list_color_variables | read | List color variables. List all color variables (design tokens). |
reorder_color_variables | write | Reorder color variables. Reorder color variables by providing the full list of IDs in the desired order. |
update_color_variable | write | Update color variable. Update a color variable name or value. |
Fonts
Search Google Fonts and install fonts on the site.
| Tool | Access | Description |
|---|---|---|
add_font | write | Add font. Add a Google Font to the site. |
delete_font | destructive | Delete font. Remove a font from the site. |
list_fonts | read | List fonts. List all fonts added to the site. |
search_google_fonts | read | Search Google Fonts. Search the Google Fonts catalog to discover available fonts. |
update_font | write | Update font. Update a font (change weights, variants, or category). |
Components
Reusable blocks and their variants. Edit once, update everywhere.
| Tool | Access | Description |
|---|---|---|
add_component_instance | write | Add component instance. Reuse a component on a PAGE by inserting a real component instance (a layer that references the component and shares its structure). |
create_component | write | Create component. Create a new reusable component. |
create_component_from_layer | write | Create component from layer. Turn an existing PAGE layer (and its subtree) into a new reusable component, then replace it in place with an instance of that component. |
create_component_variant | write | Create component variant. Add a new named variant to a component. |
delete_component | destructive | Delete component. Delete a component. |
delete_component_variable | destructive | Delete component variable. Delete a variable from a component and clean up every reference: unlink it from all of the component's variant layers, and remove any per-instance overrides that referenced it across pages. |
delete_component_variant | destructive | Delete component variant. Delete a named variant. |
detach_component_instance | destructive | Detach component instance. Detach a component instance on a PAGE, converting it back into plain, editable layers (a copy of the component's current structure with fresh IDs). |
get_component | read | Get component. Get a component by ID: its variables and the layer tree of each variant (variants[0] is the primary variant; the first variant's tree is what instances render by default). |
list_component_variants | read | List component variants. List the named variants of a component. |
list_components | read | List components. List all reusable components with their variables and where they are used. |
reorder_component_variants | write | Reorder component variants. Reorder a component's variants. |
replace_component_instances | destructive | Replace component instances site-wide. Swap EVERY instance of one component for another across all draft pages in one call (e.g. |
replace_layer_with_component | write | Replace layer with component. Swap an existing PAGE layer for a component instance in place (keeps its position). |
set_component_instance | write | Set component instance overrides. Customize a component INSTANCE on a page: override per-instance content (text, image, link, icon, media, nested variant) and/or switch which variant the instance renders. |
update_component | write | Update component. Update a component's name and/or variables. |
update_component_layers | write | Update component layers. Edit the inside of a component: add, remove, move, restyle, or set content on the layers within a component's tree (the master definition, not a page instance). |
update_component_variant | write | Update component variant. Rename a component variant. |
Animations & interactions
Entrance animations, presets and interactions.
| Tool | Access | Description |
|---|---|---|
add_animation | write | Add animation. Add a curated animation to a layer using one of Cashfin Business's preset patterns. |
clear_layer_animations | destructive | Clear layer animations. Remove all animations from a layer. |
list_layer_animations | read | List layer animations. List all animations attached to a layer with their triggers and tween summaries. |
remove_layer_animation | destructive | Remove layer animation. Remove a single animation from a layer by its interaction ID. |
set_layer_interactions | write | Set layer interactions. Raw escape hatch: replace a layer's entire interactions array with the full LayerInteraction shape. |
Assets
Images and files in the asset library.
| Tool | Access | Description |
|---|---|---|
delete_asset | destructive | Delete asset. Delete an asset from the library |
get_asset | read | Get asset. Get details of a single asset by ID |
list_assets | read | List assets. List all assets in the library with their IDs, filenames, URLs, and dimensions |
update_asset | write | Update asset. Update an asset (rename or move to a folder) |
upload_asset | write | Upload asset. Upload an image to the Cashfin Business asset library. |
Asset folders
Organise the asset library.
| Tool | Access | Description |
|---|---|---|
create_asset_folder | write | Create asset folder. Create a new asset folder to organize images and files. |
delete_asset_folder | destructive | Delete asset folder. Delete an asset folder and all assets within it. |
list_asset_folders | read | List asset folders. List all asset folders. |
update_asset_folder | write | Update asset folder. Rename an asset folder. |
CMS collections
Collections, fields and items. Cashfin-synced catalogue collections are read-only.
| Tool | Access | Description |
|---|---|---|
add_collection_field | write | Add collection field. Add a field to a collection's schema. |
create_collection | write | Create collection. Create a new CMS collection. |
create_collection_item | write | Create collection item. Create a new item in a collection. |
delete_collection | destructive | Delete collection. Delete a collection and all its fields, items, and values |
delete_collection_field | destructive | Delete collection field. Delete a field from a collection. |
delete_collection_item | destructive | Delete collection item. Delete an item from a collection |
list_collection_items | read | List collection items. List items in a collection with their field values. |
list_collections | read | List collections. List all CMS collections with their IDs, names, slugs, and default sorting. |
reorder_collection_fields | write | Reorder collection fields. Reorder the fields of a collection. |
set_collection_item_order | write | Set collection item order. Set the manual ordering position of an item within its collection. |
update_collection | write | Update collection. Rename a collection or update its default sorting. |
update_collection_field | write | Update collection field. Update a collection field (rename, change type, update reference, change metadata, update type-specific data). |
update_collection_item | write | Update collection item. Update field values for an existing collection item. |
Collection lists
Show collection items on pages: binding, filters, visibility and dynamic text.
| Tool | Access | Description |
|---|---|---|
bind_collection_layer | write | Bind collection list. Bind a Collection List element (add_layer template "collection") to a CMS collection so the layer itself (the card) repeats once per item. |
bind_layer_field | write | Bind layer to field. Bind a layer's content to a CMS collection field so it shows live data per item. |
set_collection_filters | write | Set collection filters. Set the filters on a Collection List element so it only renders matching items (filtering at the data level, before render). |
set_dynamic_text | write | Set dynamic text. Set a text layer's content to a mix of literal text and one or more CMS fields in a single text node (e.g. |
set_layer_visibility | write | Set layer visibility. Set conditional visibility on ANY layer: it only renders when the conditions match. |
Collection pages
Generate a page per collection item.
| Tool | Access | Description |
|---|---|---|
create_collection_pages | write | Create collection pages. Scaffold the pages a collection needs in one call: a folder (e.g. |
Forms
Form settings and submissions.
| Tool | Access | Description |
|---|---|---|
delete_form_submission | destructive | Delete form submission. Permanently delete a form submission. |
get_form_submission | read | Get form submission. Get a single form submission by ID with full payload and metadata. |
list_form_submissions | read | List form submissions. List submissions for a specific form, optionally filtered by status. |
list_forms | read | List forms. List all forms that have received submissions, with counts and latest submission date. |
mark_all_submissions_read | write | Mark all submissions read. Mark all new submissions for a form as read. |
update_form_submission_status | write | Update form submission status. Update the status of a form submission (e.g. |
Localization
Locales and translations.
| Tool | Access | Description |
|---|---|---|
batch_set_translations | write | Set translations in batch. Create or update up to 1000 translations in one call — the most efficient way to translate a lot of content. |
create_locale | write | Create locale. Add a new locale (language) to the site. |
delete_locale | destructive | Delete locale. Delete a locale. |
delete_translation | destructive | Delete translation. Delete a translation. |
list_locales | read | List locales. List all locales (languages) configured for the site. |
list_translatable_content | read | List translatable content. Discover exactly what can be translated for a page, component, or CMS collection — and the precise source_type/source_id/content_key/content_type to use with set_translation. |
list_translations | read | List translations. List existing translations for a specific locale. |
set_default_locale | write | Set default locale. Set a locale as the default (primary) language for the site. |
set_rich_text_translation | write | Set rich text translation. Translate a rich-text content key by passing structured blocks. |
set_translation | write | Set translation. Create or update a translation for a specific content key in a locale. |
update_locale | write | Update locale. Update a locale label or set it as default. |
update_translation | write | Update translation. Update an existing translation value or completion status. |
Site settings
Site-wide settings such as name, SEO and custom code.
| Tool | Access | Description |
|---|---|---|
get_settings | read | Get site settings. Get all site settings or a specific setting by key. |
set_setting | write | Set site setting. Set a site setting value. |
set_settings_batch | write | Set site settings in batch. Set multiple site settings at once. |
Publishing
Review drafts and publish them live. See Publishing.
| Tool | Access | Description |
|---|---|---|
get_unpublished_changes | read | Get unpublished changes. Check what changes are pending and need to be published. |
publish | destructive | Publish site. Publish all draft changes to make them live. |